CHANGES.md

Release Notes

Version 1.5.0 (Released on 2024-07-17)

New Features

• Dcml annotation parser
• New kern import for faster and more robust
• Barebones Kern export
• MEI export
• Mei export Updates
• Estimate symbolic durations
• New harmony classes and checks for Roman numerals, Chord Symbols, Cadences and Phrases in
• Intervals as partitura classes
• transposition of parts
• Export wav with fluidsynth

Other Changes

• improved documentation
• improved typing
• New tests
• optional dependency of pandas

Version 1.4.1 (Released on 2023-10-25)

Bug Fixes

• remove unnecessary escape characters for correct parsing of sharp accidentals in Nakamura match files.
• don't consider the propriety doc_order for sorting notes in the matchfile_from_alignment function if it is not present. This propriety is only present in parts from musicxml scores and previously resulted in an exception for other score formats. This solves #326
• during matchfile parsing, voice info is now parsed as follows: If there is no voice info, all notes get assigned voice number 1. If there is only voice info for the solo voice, the non-solo voiced notes get voice 2. If multiple notes have different voices, but not every note has a voice annotated, those with voice annotation get the annotated voice number and those without voice annotation get assigned the max voice+1 voice number. Previously all notes were assigned to voice 1 if there were any None voiced note
• during matchfile parsing, all note classes are now matched correctly. Previously classes MatchSnoteTrailingScore and MatchSnoteNoPlayedNote were always marked as MatchSnoteDeletion and MatchHammerBounceNote, MatchTrailingPlayedNote, MatchTrillNote always ended up as MatchInsertionNote. This solves #286
• during matchfile parsing, lines which can't be parsed are removed. Before they ended up as None in the output.

Version 1.4.0 (Released on 2023-09-22)

New Features

• new class for performed notes
• minimal unfolding for part
• updated Musescore parser for version 4
• load_score auto-selects parser based on file type
• new attributes for Score object for capturing meta information
• new score note attributes in matchfile export (grace, voice_overlap)
• new tempo_indication score property line in matchfile export

Bug Fixes

• Fixed bug: #297
• Fixed bug: #304
• Fixed bug: #306
• Fixed bug: #308
• Fixed bug: #310
• Fixed bug: #315

Other Changes

• new unit test for cross-staff beaming for musicxml

Version 1.3.1 (Released on 2023-07-06)

New Features

• (Partial) match note ID validation.
• Normalization module and (partial) normalization defaults for note and performance features.

Bug Fixes

• Fixed bug: #289
• Fixed bug: #277
• Fixed bug: #275
• Fixed several bugs of fixed-size note feature array extraction: #270, #271, #272
• Fixed bug: #269

Other Changes

• Encoding of Dynamic Score Markings in note feature arrays changed to a simple ramp from 0 to 1, starting at the start position of the marking and ending at the end.
• Refactor all alignment-related processing to performance_codec.

Version 1.3.0 (Released on 2023-06-09)

This PR addresses release 1.3.0, it includes several bug fixes, code cleaning, documentation, and new functionality.

New Features

• Enhanced Performance features in the same fashion as the note features;
• Fixed-size option for Note features. Use: `
• Create a score from a note array functionality. Call partitura.musicanalysis.scorify(note_array);

New Optional Features

• If music21 is installed : Import music21 to Partitura by calling partitura.load_music21(m21_score)
• If MidiTok is installed : Export Partitura Score to Tokens by calling partitura.utils.music.tokenize(score_data, tokenizer)

Bug Fixes

• Fixed bug: #264
• Fixed bug: #251
• Fixed bug: #207
• Fixed bug: #162
• Fixed bug: #261
• Fixed bug: #262
• Fixed Issue: #256
• Addressed Issue: #133
• Fixed bug: #257
• Fixed bug: #248
• Fixed bug: #223

Other Changes

• Minor Changes to the Documentation
• Addition of Docs link to the Github header
• Upgraded python version requirements to Python>= 3.7

Version 1.2.2 (Released on 2023-05-10)

New features

• slicing performed parts
• roman numeral analysis
• harmony class for part and export
• staff with custom number of lines
• transposition by intervals

Bug fixes

• file naming bug in load_musicxml()
• fixed bug in score part unfolding
• bugfix for fine, ritenuto parsing and unfolding
• bugfix for performance codec

Other changes

• Improved documentation
• Added contributing file

Version 1.2.1 (Released on 2023-02-09)

Bug fixes

• fixed bug in exporting data for parangonada https://sildater.github.io/parangonada/
• fixed bug in rendering via musescore
• fixed bug in loading via musescore

Version 1.2.0 (Released on 2022-12-01)

New features

• Load and save alignments, performances, and scores stored in match files (.match) of all available versions
• Support for mei loading via verovio (if installed)
• PerformedPart notes store timing information in both ticks and seconds
• Support for pitch class piano rolls
• New MIDI time conversion functions

Bug fixes

• Fix render via musescore (if installed)
• Fix bug slowing down musicxml export
• Fix consecutive tie bug in kern import
• Gracefully handle slur mismatch in kern import
• Fix metrical position flag in note arrays
• Fix in MEI import and handling multiple staff groups inside the main staffGroup
• Fix measure map for single measure parts

Other changes

• Improved documentation
• Extended test coverage
• Extended and updated notebook tutorials: https://cpjku.github.io/partitura_tutorial/

Version 1.1.1 (Released on 2022-10-31)

New features:

• New minor feature : Adding midi pitch to freq for synthesizer add reference-based midi pitch to freq #163

Bug fixes:

• Documentation Fix of ReadTheDocs
• Bug fix Bug synthesizing scores with pickup measures #166 Synthesizing score with pick up measure
• Bug Fix of kern import Kern import fix #160
• Bug Fix of Musicxml import repeat infer Bug with musicxml Import #161
• Bug fix Note array with empty voice Note array from note list with empty voice bug. #159
• Fix synthesizing scores with pickup measures #167

Other changes:

• Encoding declaration on all files.
• Renaming master branch as main

Version 1.0.0 (Released on 2022-09-20)

API changes:

• Different __call__ for note_array attribute (in Score, Part, PerformedPart and PartGroup). note_array is now called as a method with brackets. One can specify additional fields for the note array such as key, pitch spelling, time signature, and others.
• Every score is imported as a Score object where each part can be accessed individually.

New features:

• We now support import from humdrum **kern, and MEI (coming soon import Musescore and Music21, export MEI).
• The music analysis functions now include:
  • The basis features (from the Basis Mixer) use by typing : partitura.utils.make_note_features(part).
  • A simple version of the Performance Codec with encode, and decode functions.
• The part object now contains several new methods such as: part.measures(), part.use_musical_beat(), and others.
• Multiple parts of the same score can now be merged to one even if they contain different divs, call: partitura.score.merge_parts([p1, p2, ...]).
• Ornaments now are supported.
• Added i/o functionality for parangonada
• There is now an unpitched note class.
• Added unzipping for compressed musicxml files on import.
• Added unifying function for import of individual score formats as a load_score function.
• Added score unfolding features.

Bug fixes:

• Pianoroll starting with silence mismatch on pianoroll creation fixed.
• Fixed consistency of time signature map.
• Fixed pianoroll to note_array.
• Fix for unpitch musicxml elements.
• updated music analysis algorithm for Voice Separation based on Chew.
• ensure_note_array now works even with parts with different divs.

Other changes:

• Logger is replaced by warnings.
• Add documentation
• Code cleanup
• Coverage support
• Unitesting running as a workflow

Version 0.4.0 (Released on 2021-05-28)

API changes:

• Different format for note_array attribute (in Part, PerformedPart and PartGroup). The name of the fields in the note arrays for onset and duration information now include the units: beat, quarter, and div for scores and sec for performances.
• The music analysis functions now accept Part and PerformedPart as well as note arrays
• Support for all MIDI controls in PerformedPart. The controls are only stored by their CC number (not name).
• Add default program change option to PerformedPart

New features:

• Add function to create 2D pianoroll representations from Part, PerformedPart or note arrays.
• Add document order index to parts read from MusicXML
• Support for sustain pedal info in MusicXML files
• Add tonal tension profiles by Herremans and Chew (2016)
• Add key_signature_map to Part objects
• Add read support for Match and Corresp files of Nakamura's music alignment tool
• Add sanitize_part function removing incomplete slurs and tuplets.

Bug fixes:

• Fix tempo change bug in load_performance_midi
• Fix saving parts with anacrusis to score MIDI
• When defining Note objects, lower-case note names are converted to upper-case. Before this the behavior was undefined when using lower-case note names
• Fix bug in pattern for matchfile
• Fix issue with MIDI velocity for overlapping notes in piano rolls
• Fix bug in add_measures
• Fix GraceNote bug

Other changes:

• Add documentation
• Code cleanup

Version 0.3.5 (Released on 2019-11-08)

Other changes:

• Add documentation

Version 0.3.4 (Released on 2019-11-08)

API changes:

• Rename out_fmt kwarg to fmt in show
• Add dpi kwarg to show
• Rename show function to render

New features:

• Save rendered scores to image file using render
• Add wedge attribute to DynamicLoudnessMarkings to differentiate them from textual directions

Bug fixes:

• Do not crash when calling time_signature_map on empty Part instances
• Fix bug in repeat unfolding

Version 0.3.3 (Released on 2019-11-04)

Bug fixes:

• Fix missing dedent import

Version 0.3.2 (Released on 2019-11-03)

API changes:

• More systematic direction ontology

New features:

• Add grace_seq_len property to grace note
• Add backwards keyword arg to iter_grace_seq

Bug fixes:

• Fix regression in slur handling; Remove unended objects in import

Version 0.3.1 (Released on 2019-10-30)

API changes:

• Rename load_midi -> load_score_midi
• Rename xml_to_notearray -> musicxml_to_notearray
• Rename divisions_map -> quarter_duration_map
• Page/System: rename nr -> number
• Make Part.points private (_points)
• Remove voice related methods on Note (only used in obsolete expand_grace_notes version)

New features:

• Save Part as MIDI file (save_score_midi)
• Add PerformedPart to represent performances
• Load MIDI as PerformedPart (load_performance_midi)
• Save PerformedPart as MIDI (save_performance_midi)
• Add support for Match files (load_match)
• New options for iter_current_next
• Make_measures respects existing measures optionally
• Export articulations to musicxml.
• load_score_midi: Estimate staffs (if not specified)
• load_score_midi: Estimate voices (if not specified)
• load_musicxml: Set end times of score elements to start of next element of that class (Page, System, Direction)
• Define Incr/Decr loudness/tempo directions
• Add iter_prev/iter_next methods
• Be explicit about kwargs in Note creation
• Add show function to display score, using either MuseScore or Lilypond as backend
• Add load_via_musescore to load scores in other formats

Bug fixes:

• Better clef support in musicxml export
• export_musicxml: fixes in handle wedge/dashes export
• The order in which simulatenous notes are listed in a timepoint no longer influences the chord-handling logic in voice estimation, and the musicxml export.
• Fix incorrect construction of dtypes for structarray in voice_separation
• Fix in anacrusis handling
• Fix in iter_current_next
• import_musicxml: check for crossing measure boundary

Other changes:

• Get rid of deprecated get_prev/next_of_type
• Tuplet/Slur: make use of getter/setter for start/end_note
• Improvements in parse_direction
• expand_grace_notes now simpy sets note durations, without shifting onsets
• Rename strictly_monophonic_voices keyword arg to monophonic_voices in estimate_voices, and implement (previously unimplemented) functionality: With monophonic_voice=False, notes with same onset and duration as treated as chords and assigned to the same voice
• More documentation

Version 0.2.0 (prerelease; Released on 2019-10-04)

API changes:

• The TimeLine class has been merged into the Part class

New features:

• Add find_tuplets and tie_notes to public API
• New Tuplet class analog to Slur, allows for better musicxml tuplet support
• Remove deprecated get_starting_objects_of_type/get_ending_objects_of_type (use iter_starting/iter_ending)

Bug fixes:

• Multiple fixes in tuplet and slur handling

Other changes:

• Update package description/long description
• More documentation
• Add separate tuplet and slur test cases
• Improve show_diff

Version 0.1.2 (prerelease; Released on 2019-09-29)

API changes:

• New approach to handling divisions
• Treat missing key signature mode as major
• Function iter_parts accepts non-list arg
• Don't do quantization by default
• Change make alter a keyword arg in Note constructor
• Remove parse_words from API
• Export part-groups to musicxml
• Add PartGroup constructor keyword args
• Rename PartGroup.name -> PartGroup.group_name (for consistency)
• Rename Part.part_id -> Part.id
• iter_parts accepts non-list arg
• Remove Measure.upbeat property (use Measure.incomplete)

New features:

• New add_measures function to automatically add measures to a Part
• Add inverted quarter/beat map

Bug fixes:

• Avoid sharing symbolic_duration dictionaries between notes
• Rework MIDI loading: do not accumulate quantization errors
• Make sure last tied note actually gets tied
• Do not populate symbolic_duration with None when values are missing
• When exporting to musicxml, avoid polyphony within voices by reassigning notes to new voices where necessary
• Filter null characters when exporting musicxml to avoid lxml exception
• Loggin: info -> debug
• Don't use divisions_map
• Fix leftover references to old API
• Fix add_measures
• Handle part/group names when importing MIDI
• Fix bug in divisions_map
• fix bug in estimate_symbolic_duration

Other changes:

• Add test case for beat maps and symbolic durations
• Improve direction parsing
• Remove polyphony within voices when exporting to musicxml
• Add show function to show typeset score (using lilypondn)
• Add/improve documentation
• Improve pretty printing
• Remove trailing whitespace
• More exhaustive tuplet search
• Write tests for tuplet detection
• Write tests for importmidi assignment modes
• Rewrite quarter/beat map construction
• Create (non-public API) utils sub package

Version 0.1.1 (prerelease)

Bug fixes:

• Tweak docs/conf.py to work correctly on readthedocs.org

Other changes:

• Fix incorrect version in setup.py

Version 0.1.0 (prerelease)

This is the first prerelease of the package. In this release MIDI export functionality is missing and the documentation is incomplete.