Package: harte-library
The Harte LibraryExtension of themusic21 libraryfor working with music chords encoded according to theHarte Notation.This project is part ofChoCo, a dataset of 20K+ timed chord annotations of integrated and standardised scores and tracks.The Harte Library mainly extends theChord moduleof muisc21. In addition, theInterval moduleis also extended to support intervals as represented in the chords encoded in Harte.The library has the following dependencies:music21: as an extension of the library itself;Lark: for parsing the chords in Harte.InstallationThe library has been uploaded to PyPi, therefore for installation simply launch:pipinstallharte-libraryMain FunctionalitiesThe main functionalities of the Harte Library are:to make musical chords notated according to Harte Notation interoperable with the music21 library;to make chords notated in Harte interpretable, e.g. by unrolling the shorthand;to simplify and homogenise chords in Harte, via theprettify_hartefunctionality.UsageInterval Module ExtensionThe Harte Library extends theInterval Moduleof music21 to ensure interoperability between intervals expressed according to Harte notation and the interval class of music21.TheHarteIntervalclass accepts an interval expressed in Harte Notation as input and allows all the properties and methods of the music21 Interval module to be used:fromharte.intervalimportHarteIntervalinterval=HarteInterval('b6')int_name=interval.nameint_is_consonant=interval.isConsonant()Chord Module ExtensionThe main functionality of the Harte Library is an extension of theChord Moduleof music21.This is possible by means of the classHarte, which accepts as input a chord expressed in Harte Notation and allows all properties and methods of the Chord module of music21 to be used:fromharte.harteimportHartechord=Harte('C#:maj7(b6)/b3')bass=chord.bass()# Eroot=chord.root()# C#name=chord.fullName# Chord {G-sharp | A | E | B-sharp | C-sharp | E-sharp} QuarterIn addition, the library implements new methods specific to Harte notation, including:get_degrees: returns the intervals of the chord, disregarding those expressed by the shorthandget_root: returns the root of the chord expressed as a stringget_bass: returns the interval between the root note and the bass notecontains_shorthand: returnsTrueif the chord contains a shorthand,Falseotherwiseget_shorthand: returns the chord's shorthand, if presentunwrap_shorthand: returns a list containing all the intervals in the chord, including those wrapped by the shorthandprettify: breaks the chord into its components and recomposes it by choosing the most summarised shorthand, if possible.fromharte.harteimportHartechord=Harte('D:(b3,5,7,9)')pretty_harte=chord.prettify()# D:minmaj7(9)ContributingEvery type of contribution to the library is widely encouraged.
The library has also just been released and any bug reports are highly appreciated.LicenseMIT LicenseCopyright (c) 2022 Andrea PoltronieriPermission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.