Andrea-V / pypianoroll

A python package for handling multi-track piano-rolls.

Pypianoroll

A python package for handling multi-track piano-rolls.

Features

• handle piano-rolls of multiple tracks with metadata
• utilities for manipulating piano-rolls
• save to and load from .npz files using efficient sparse matrix format
• parse from and write to MIDI files

Installation

To install Pypianoroll from PYPI:

$ pip install pypianoroll

To install Pypianoroll manually (please download the source code from either PYPI or Github first):

$ python setup.py install

Documentation

Documentation is provided as docstrings with the code. An online version is also available here.

Citing

Please cite the following paper if you use Pypianoroll in a published work:

Hao-Wen Dong, Wen-Yi Hsiao, and Yi-Hsuan Yang, "Pypianoroll: Open Source Python Package for Handling Multitrack Pianorolls," in Late-Breaking Demos of the 18th International Society for Music Information Retrieval Conference (ISMIR), 2018.

Here are the :download:`paper <pdf/pypianoroll-ismir2018-lbd-paper.pdf>` and the :download:`poster <pdf/pypianoroll-ismir2018-lbd-poster.pdf>`.