Ms3

- Enabled extraction of score labels.

- Made the use of `labels_cfg` more consistent.

-

improved chord lists:

: - include system and tempo texts
- new algorithm for correct spanner IDs (i.e. for Slurs,
Pedal, HairPins, Ottava)
- lyrics: still extracts only the last verse but now in the
corresponding column, e.g. `lyrics:3` for verse 3.

-

new feature (still in beta): extraction of form labels

: - `Score.mscx.form_labels`
- `Parse.form_labels()`
- added `form_labels` -related parameters to
`Parse.get_lists()` and `Parse.store_lists()`
- added `utils.expand_form_labels()` for hierarchical display
of form labels

- enabled `import from ms3` for all utils

- new command `ms3 update` for converting files and moving annotations
to the Roman Numeral Analysis layer

- new command `ms3 metadata` for writing manually changed information
from `metadata.tsv` to the metadata fields of the corresponding
MuseScore files

-

improved the `ms3 extract` command:

: - added option `-D` for extracting and updating `metadata.tsv`
and `README.md`
- added option `-q` for adding \'quarterbeats\' and
\'durations_quarterbeats\' columns
- included default paths for the capital-letter parameters

-

improved the `ms3 compare` command:

: - now works with \'expanded\' TSVs, too (not only with
\'labels\')
- allows \'label\' column to include NaN values

-

improvements to Parse() objects:

: - attempts to parse scores that need file conversion (e.g.
XML, MIDI)
- `get_lists()` method now allows for adding the columns
`quarterbeats` and `durations_quarterbeats`, even without
unfolding repeats
- adding \'quarterbeats\' without unfolding repeats excludes
voltas
- new method `get_tsvs()` for retrieving and concatenating
parsed TSV files
- Parse() now recognizes `metadata.tsv` files, expanded TSVs,
and TSVs containing cadence labels only
- parsed `metadata.tsv` files can be retrieved/included via
the method `metadata()`
- new method `update_metadata()` for the new `ms3 metadata`
command
- decided on standard index levels `rel_paths` and `fnames`
- improved matching of corresponding score and TSV files

-

improvements to Score() objects:

: - new property Score.mscx.volta_structure for retrieving
information on first and second endings

-

improvements to Annotations() objects:

: - correct propagation of `localkey` for voltas

-

improvements to commandline interface:

: - added parameter `-o` for specifying output directory
- harmonized the interface of the `ms3 convert` command
- parameter `exclude_re` now also filters paths passed via
`-f`

-

changed logging behaviours:

: - write only WARNINGs to log file
- combine loggers for filenames independently of file
extensions

- improved extraction of instrument names for metadata

- improved `ms3 compare` functionality

- restructured code architecture

- renamed master branch to \'main\'

- many bug fixes

- now reads DCML labels with cadence annotations
- unified command-line interface file options and included
`-f file.json`
- Parse got more options for creating DataFrame index levels
- Parse.measures property for convenience
- bug fixes for better GitHub workflows

-

Labels can be attached to MuseScore\'s Roman Numeral Analysis (RNA) layer

: - parameter [label_type=1]{.title-ref} in both
[Score.attach_labels()]{.title-ref} and
[Parse.attach_labels()]{.title-ref}
- [Annotations.remove_initial_dots()]{.title-ref} before
inserting into the RNA layer
- [Annotations.add_initial_dots()]{.title-ref} before
inserting into the absolute chord layer

- interpret all [vii]{.title-ref} in major contexts as
[vii]{.title-ref} when computing chord tones

- code cosmetics and bug fixes

- ms3 extract and Parse.store_lists() now have the option unfold to
account for repeats
- minor bug fixes

- added \'ms3 compare\' command
- support for parsing cap, capx, midi, musicxml, mxl, and xml files
through temporary conversion
- support for parsing MuseScore 2 files through temporary conversion