harmony-analyser is a set of visual tools for music harmony analysis of WAV/MIDI input, powered by JHarmonyAnalyser library. The application was developed 2013-2016 as a joint Master's thesis & PhD thesis project (Comenius University in Bratislava, Charles University in Prague, with the help of LaBRI Université Bordeaux 1) by Ladislav Maršík [contact author].
Documentation has two parts:
For version: 1.2
Download and unpack the source tarball from the library releases page. Optionally, download the library in the form of JAR file, importing it to your project.
Chord Analyser is a joint name for the models available under chord_analyser Java package. Explanation of the models follow:
Chroma Analyser is a joint name for the models available under chroma_analyser Java package. Explanation of the models follow:
which is simply summing absolute values of the differences across all bins.
where w(δ) is a weight vector, which has its 12 values dependent on the context δ of the transition from x to y.
δ is a tuple (key, chord1, chord2), where all of key, chord1, chord2 are represented as boolean vectors of size 12
(chordi = true <=> the pitch class i belongs to the chord).
If the transition from x to y is within C major key, and x and y both represent C major chord,
then δ has the form (C major, C major, C major). Weight vector w(δ) is assigned as:
For version: 1.2
Download the executable JAR file from releases page. Please note that JRE 8 or higher needs to be installed on your machine, and the selection of Vamp plugins needs to be installed locally:
Make sure that a MIDI input device is connected to your machine. Chord Transition Tool works with MIDI devices connected to the MIDI IN port on your soundcard, or USB port. If you don't have a MIDI input device, you can still use a virtual MIDI keyboard such as vkeybd for Linux (make sure that the raw MIDI ports are available when using virtual keyboards) or just use the text input in Chord transition tool. By hitting capture you can record two chords. Alternative way is to insert the chord in the text feel in absolute format (e.g. C3 E3 G3) or relative format (e.g. C E G). The tool will calculate the chord complexity of both chords and the transition complexity in between them.
Choose the folder to analyse (you should have your WAV files prepared in this folder). To see the available plugins and their settings, click button "List plugins". Proceed by clicking any of the available analysis buttons.
Choose the full path for the WAV file to analyse. Choose the desired visualizations in the drop-down menus. After hitting the analyse button, the visulizations will render. If the analysis outputs have already been created, the analysis will not be overriden. Instead, the files will be read from hard-drive, and the visualization displayed based on the information found.
Find out more information about our software in the following list of scientific papers:
Reach us at: