Package: abstract-melody-parser
IntroductionThis python module is designed to offer a collection of functions and classes that can be used to give a meaningful interpretation of a succession of midi note messages, in terms of rhythm and melody.The developement of this project started with the idea of creating a parsing software that could be used to output rhythmic and melodic symbols, that could be further processed by some machine learning algorithm (based on Markov models, grammars or similar techniques).The output symbols of the parsing are based on the Impro-Visor software notation (https://www.cs.hmc.edu/~keller/jazz/improvisor/) and the theory supporting it can be found at this linkhttps://www.cs.hmc.edu/~keller/jazz/improvisor/papers.html.InstallationThe package can easily be installed using the pip package manager.pipinstallabstract_melody_parserMidiQueueTo parse note_on/note_off messages, a particular data structure called MidiQueue is used. This queue stores midi note messages with a timestamp, that is needed to parse the rhythmic structure of a melody. This data structure is supposed to collect only melodies, chords are not supported, if multiple note_on messages are pushed into it with timestamps too close with each other, only the first one will be mantained.In order to insert a new note message with a timestamp included, the get_timestamp_message function must be used.importabstract_melody_parserasampnote_queue=amp.MidiNoteQueue()note_queue.push(amp.get_timestamp_msg('note_on',47))# some temporal delay...note_queue.push(amp.get_timestamp_msg('note_off',47))Before parsing a midi queue, it's suggested to clean the note_on messages that are still missing the relative note_off message.note_queue.clean_unclosed_note_ons()Some other methods are exposed for extra flexibility.msg=note_queue.pop()# gets the oldest note message removing it from the queuelist_of_msg=note_queue.get_container()# to deal directly with the data containermusical_notes=note_queue.get_notes()# to obtain a list of notes in std notationnote_queue.clear()# clears the queueThe use of the MidiQueue for the melodic and rhythic parsing will be explained in the following sections.Parsing melodiesThe melody parsing allows to translate a midi note number in a abstract melody notation. This parser supports three different abstract melody symbols.c: chord tone
l: color tone
x: random toneAn abstract melody can be realized in a particular chord; in order to obtain the correct abstract melody symbol, is necessary to input both a note in standard notation, and a chord. To obtain a note in standard notation from a midi note value, an additional parsing function is needed.midi_msg=note_queue.pop()# getting a midi messagenote_midi=midi_msg['note']# getting the midi note numbernote_std_notation=amp.parse_midi_note(note_midi)# from midi note number to std note notationchord='CM'# C major chordnote_abstract_melody_notation=amp.parse_musical_note(note_std_notation,chord)# from std note notation to abstract note notationThe notes in standard notation are uppercase letters, and a sharp symbol can be present (diesis are not used)musical_notes=['C','C#','D','D#','E','F','F#','G','G#','A','A#','B']To modify the particular tones (chord or color tones) of a chord or to add a new one, the chord_tones dictionary, inside the chord.py script can be edited.# excerpt of the dictionarychord_tones={'CM':{'c':['C','E','G'],# chord tones can be added here'l':['B','D','F','A']# color tones can be added here},# the list continues ...}Parsing rhythmThe rhythmic parsing process, allows to translate a series of notes composing a melody, in multiple symbols describing the duration of each note. These are the symbol used to represent the rhythm, they are related to a certain bpm and they refer to a 4/4 rhythmic signature.1: whole note
2: half note
4: quarter note
4dot: quarter note dotted
4t: quarter note triplet
8: eight note
8t: eight note triplet
16: sixteenth note
16t: sixteenth note tripletTo define a rhythmic frame for the analysis, a duration dictionary must be created and updated every time the bpm changes.bpm=120.5durations=amp.get_durations(bpm)After defining the durations from the bpm, the parsing can follow. It will return a list of symbols for all the notes in the melody.noteQueue.clean_unclosed_note_ons()# always do that before parsingrhythmic_symbols=amp.parse_rhythm(note_queue,durations)Putting all togetherSometimes the informative content of a melody can only be found in the rhythm or in the armonic relations between the notes and a chord, but in many other occasions, is the underlying relation between the two that really expresses the message that a musitian is trying to share with his/her performance. Following this perspective, it can be useful to perform both melodic and rhythmic parsing from a single MidiQueue, and read the resulting symbols as pairs. Let's suppose to parse a MidiQueue that contains a melody playing on a Dm chordcurrent_chord='Dm'bpm=125durations=amp.get_durations(bpm)noteQueue.clean_unclosed_note_ons()# again, don't forget to clean the unclosed note_on messagesnotes=midi_queue.get_notes()# list comprehension to map the std notes to an abstract melodyabstract_melody=[amp.parse_musical_note(note,current_chord)fornoteinnotes]# getting the rhythm toorhythm=amp.parse_rhythm(midi_queue,durations)The resulting lists can than be merged in a single one.full_melody=[x+yforxinabstract_melodyforyinrhythm]