3.1. Calculator

The Calculator program extracts rhythmic partitioning data from given digital scores and saves it into a JSON file.

Output JSON file contains:

  1. texture_data with events’ data split in separate lists:
    1. Index (measure number + offset)

    2. Measure number

    3. Offset

    4. Global offset

    5. Duration

    6. Partition

    7. Density number

    8. Agglomeration index

    9. Dispersion index

  2. offset_map with a map of measure numbers and their global offsets

  3. values_map with partitions and the values of their agglomeration and dispersion indexes

  4. partitions with a single list of each event partitions

Its basic usage is:

rpscripts calc score.xml

The -c option also creates a CSV file with the events data (see Converter section).

The combined -e and -c options create a CSV file with equally-sized events. This procedure is helpful for statistical operations such as frequency analysis.

rpscripts calc -e score.xml

The option -h prints the program help:

rpscripts calc -h

Output:

usage: rpscripts calc [-h] [-c] [-e] filename

positional arguments:
filename             digital score filename (XML, MXL, MIDI and KRN)

options:
-h, --help           show this help message and exit
-c, --csv            output data in a CSV file.
-e, --equally_sized  generate equally-sized events