MorpheuS Tension Visualiser
You can download version 2.0 of the Morpheus Tension Visualiser here (right click -> save as).
(Note: some xml files with meter changes get an error, please use this jar file instead for them. Note that changes of number of divisions per quarter note during the piece are not taken into consideration yet).
There are three version of the tension visualiser:
- XmlTensionVisualiser takes a musicXML file as input
- AudioTensionVisualiser takes a text file with pitch info as input
- NEW: Python version (Midi miner) based on midi
For more information on how the tension is calculated, please see our paper:
1. XmlTensionVisualiser
To run:
java -jar XmlTensionVisualiser.jar -inputfile "yourfile" [options]
Option switches (run with -h to see all switches):
usage:
-h,--help show help.
-inputfile,--var
-meterUnits,--var
rendering: number of units of meter. Default
value is 4.
-windowLength,--var
(quarter note), 8, 16, etc. (This setting
has preference over windowsPerBar.) Default
value is 1 eight note.
-windowsPerBar,--var
calculate the tension. (depreciated)
Output:
- inscore files with tension ribbons (drag into the inscoreviewer to view, you also need to convert your xml to gmn.
- three data files with the tension data for each segment (for each tension measure)
- A graph of the tension (in html)
2. AudioTensionVisualiser
To run:
java -jar AudioTensionVisualiser.jar -inputfile "yourfile" [options]
The inputfile is a text file and should look like this:
A A B C# F
F D A
G
E F G G
...
--> each line is a "cloud" or window
--> pitch classes are weighted according to their occurence on each line
Output:
- three data files with the tension data for each segment (for each tension measure)
- A graph of the tension (in html)
If you use this code, please refer to our paper. Should you have any trouble, please let me know.
More about the model:
Acknowledgement
This project has received funding from the European Union’s Horizon 2020 research and innovation programme under the Marie Skłodowska-Curie grant agreement No 658914.
