v1.3.1 unique_track parameter & minor fixes / changes

Highlights

This versions uniformly cleans how the save_params is called, brings related minor fixes and new features.

Changes

• 3c4adf8 Tokenizers now take a unique_track argument at creation. This parameter specifies if the tokenizer represents and handles music as a single track, or stream of tokens. This is the case of Octuple and MuMIDI, and probably most representations that natively support multitrack music. If given True, the tokens will be saved in json files as a single track. This parameter can then help when loading tokenized datasets.
• 3c4adf8 save_params method: out_dir argument renamed to out_path
• 3c4adf8 save_params method: out_path can now specify the full path and name of the config file saved
• 3c4adf8 fixes in save_params method for MuMIDI
• 3c4adf8 The current version number is fixed (was 1.2.9 instead of 1.3.0 for v1.3.0)
• 4be897b bpe method (learning BPE vocabulary) now has a print_seq_len_variation argument, to optionally print the mean sequence length before and after BPE, and the variation in %. (default: True)

Compatibility

• You might need to update your code when:
• • creating a tokenizer, to handle the new unique_track argument.
• • saving a tokenizer's config to handle the out_dir argument renamed to out_path
• For datasets tokenized with BPE will need to change the token_to_event key to vocab in the associated tokenizer configuration file