Ms3

- recognizes metadata fields `reviewers` and `annotators` also in
their singular forms
- adds column `n_onset_positions` to metadata.tsv
- interval index levels renamed from \'iv\' =\> \'interval\'
- gets rid of pandas deprecation warnings
- bug fixes & log messages

- the `View` on a `Parse` object can now be subscripted with a
filename to obtain a `Piece` object, allowing for better access to
the various files belonging to the same piece (based on their file
names). These new objects facilitate access to the information which
previously was available in one row of tge `View.pieces()`
DataFrame.
- adds command `ms3 empty` to remove harmony annotations from scores
- adds command `ms3 add` to add harmony annotations from TSV files to
scores
- re-factored `ms3 compare` to use new methods added to `View` objects
- methods based on `View.iter()` now accept the parameter `fnames` to
filter out file names not included in the list
- while adding labels, use fallback values `staff=-1` and `voice=1` if
not specified

- changes to `iter` methods for iterating through DataFrames and
metadata belonging together:
- supressed the second item: instead of
`(metadata, paths, df1, df2...)` yield `(metadata, df1, df2...)`
where the metadata dict contains the paths
- added methods `iter_transformed()` and `iter_notes()` to `Parse`
and `View` objects
- added command `ms3 transform`
- used to concatenate all parsed TSVs of a certain type into one
file including the option to unfold and add quarterbeats
- stores them with prefix `concatenated_`; ms3 now ignores all
files beginning with this prefix
- changes in default TSV columns
- `metadata.tsv` includes the new columns
- `length_qb`: a scores length in quarterbeats (including all
voltas)
- `length_qb_unfolded`: the same but with unfolded repeats, if
any
- `all_notes_qb`: the sum of all note durations in
quarterbeats
- `n_onsets`: the number of all onsets
- no empty `volta` columns are included (except for measures) when
no voltas are present

-

considerable changes to `Parse` objects (bugs might still be abundant, please report them)

: - abolished custom DataFrame indices

-

behaviour shaped towards ms3\'s standard corpus structure

: - automatic detection of corpora and generation of
keys
- this enables better matching of files that belong
together through `View` objects (access via
`p['key']`)
- new method `iter()` for iterating through metadata
and files that belong together

- all JSON files passed under the `paths` argument are now
scanned for a contained list of file paths to be extracted
(as opposed to before where the JSON file had to be passed
as a single path)

- new iterator `p.annotation_objects()`

-

new module `transformations`

: - just as `utils`, members can be imported directly via
`from ms3 import`

- includes a couple of functions that were previously part of
`utils` or `expand_dcml`

-

includes a couple of new functions:

: - get_chord_sequences()
- group_annotations_by_features()
- make_gantt_data()
- transform_annotations()
- transform_multiple()

- handling hierarchical localkeys and pedals (i.e. we can modulate to
the key of `V/III`)

- Renamed column \'durations_quarterbeats\' to \'duration_qb\'

- You can now set `interval_index = True` to add quarterbeat columns
**and** an index with quarterbeat intervals

- New behaviour of the `folder_re` argument: It now gets to all paths
matching the regEx rather than stopping at a higher level that
doesn\'t match. Effectively, this allows, for example, to do
`Parse(path, folder_re='notes')` to select all files from folders
called notes.

- bug fixes (e.g. failing less on incoherent repeat structures)