A package for representing music data based on music theory
Project description
Music Embedding is an open source python package for representing music data based on music theory. It provides tools to convert melodic and harmonic sequences to and from pianorolls.
Features
Representation for music intervals
Create sequence of (harmonic or melodic) intervals from pianoroll presentation
Create pianoroll from a sequence of (harmonic or melodic) intervals
Break the sequence of intervals into smaller pieces e.g. bars
Compress the sequence of intervals using Run Length Encoding (RLE)
Why Music Embedding
Embedding is an underexplored area in the intersection of AI and music. While many works try to apply NLP-based embedding and automatic embedding (such as convolution), representing music data based on music theory is important. Music Embedding package aims to make employment of music theory easy to enhance the computationals music projects’ results. Some potential usecases are:
Statistical and probabilistic analysis of music pieces,
Developing generative models to have AI-synthesized music,
Genre classificaion,
Mood recognition,
Melody extraction,
Audio-to-Score alignment,
Structure analysis.
Installation
Music Embedding’s only prerequisit is the Numpy package. Music Embedding is developed and tested in interaction with Pypianoroll ; yet, any other code which can handle pianorolls should work just fine.
To install Music Embedding, please run pip install music_embedding. To build Music Embedding from source, please download the source and run python setup.py install.
Semantic Versioning Policy
Music Embedding uses x.y.z format to indicate the version where x is major versin number, y is minor version number, and z is the patch number.
Classes Documentation
Usage
Please visit the getting started page.
The following code snippet demonstrates how to convert a midi file into a sequence of harmonic intervals.
import music_embedding import pypianoroll if __name__ == '__main__': #opening midi file using pypianoroll midi_path = r'c:\Moonlight Sonata.mid' multi_track = pypianoroll.read(midi_path) #mergeing midi tracks into a single pianoroll so harmonic intervals can be extracted merged_piano_roll = multi_track.blend('max') #getting pianoroll of the first track pianoroll = multi_track.tracks[0].pianoroll #creating embedder object from music embedding package embedder = music_embedding.embedder() #extracting harmonic intervals harmonic_intervals = embedder.get_harmonic_intervals_from_pianoroll(pianoroll=pianoroll, ref_pianoroll=merged_piano_roll) #creating interval object from music embedding package interval = music_embedding.interval() #printing the first 20 intervals for i in range(20): interval.set_specs_list(harmonic_intervals[i]) print(interval)
Issues
If you find a problem, please file a bug.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.