pypianoroll

A toolkit for working with piano rolls

https://github.com/salu133445/pypianoroll

Science Score: 54.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
    2 of 6 committers (33.3%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.8%) to scientific vocabulary

Keywords

midi music music-generation music-information-retrieval python visulization
Last synced: 6 months ago · JSON representation ·

Repository

A toolkit for working with piano rolls

Basic Info
Statistics
  • Stars: 146
  • Watchers: 5
  • Forks: 18
  • Open Issues: 9
  • Releases: 15
Topics
midi music music-generation music-information-retrieval python visulization
Created about 8 years ago · Last pushed over 2 years ago
Metadata Files
Readme Funding License Citation

README.md

Pypianoroll

GitHub workflow Codecov GitHub license GitHub release

Pypianoroll is an open source Python library for working with piano rolls. It provides essential tools for handling multitrack piano rolls, including efficient I/O as well as manipulation, visualization and evaluation tools.

Features

  • Manipulate multitrack piano rolls intuitively
  • Visualize multitrack piano rolls beautifully
  • Save and load multitrack piano rolls in a space-efficient format
  • Parse MIDI files into multitrack piano rolls
  • Write multitrack piano rolls into MIDI files

Why Pypianoroll

Our aim is to provide convenient classes for piano-roll matrix and MIDI-like track information (program number, track name, drum track indicator). Pypianoroll is also designed to provide efficient I/O for piano rolls, since piano rolls have long been considered an inefficient way to store music data due to the sparse nature.

Installation

To install Pypianoroll, please run pip install pypianoroll. To build Pypianoroll from source, please download the source and run python setup.py install.

Documentation

Documentation is available here and as docstrings with the code.

Citing

Please cite the following paper if you use the code provided in this repository.

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 19th International Society for Music Information Retrieval Conference (ISMIR), 2018.
[homepage] [paper] [poster] [code] [documentation]

Lakh Pianoroll Dataset

Lakh Pianoroll Dataset (LPD) is a new multitrack piano roll dataset using Pypianoroll for efficient data I/O and to save space, which is used as the training dataset in our MuseGAN project.

Owner

  • Name: Hao-Wen (Herman) Dong 董皓文
  • Login: salu133445
  • Kind: user
  • Location: USA/Taiwan
  • Company: UC San Diego

Assistant Professor at University of Michigan | PhD from UC San Diego | Human-Centered Generative AI for Content Generation

Citation (CITATION.cff)

cff-version: 1.2.0
message: If you use this software, please cite it using these metadata.
authors:
  - family-names: Dong
    given-names: Hao-Wen
title: Pypianoroll
preferred-citation:
  type: article
  authors:
    - family-names: Dong
      given-names: Hao-Wen
    - family-names: Hsiao
      given-names: Wen-Yi
    - family-names: Yang
      given-names: Yi-Hsuan
  title: "Pypianoroll: Open Source Python Package for Handling Multitrack Pianorolls"
  journal: Late-Breaking Demos of the 19th International Society for Music Information Retrieval Conference (ISMIR)
  year: 2018
date-released: 2018-01-27
license: MIT
url: "https://salu133445.github.io/pypianoroll/"
repository-code: "https://github.com/salu133445/pypianoroll"

GitHub Events

Total
  • Watch event: 8
  • Pull request event: 1
  • Fork event: 3
Last Year
  • Watch event: 8
  • Pull request event: 1
  • Fork event: 3

Committers

Last synced: 9 months ago

All Time
  • Total Commits: 391
  • Total Committers: 6
  • Avg Commits per committer: 65.167
  • Development Distribution Score (DDS): 0.161
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
salu133445 s****5@g****m 328
salu133445 b****0@n****w 57
George Ogden G****n@o****m 3
adamoudad a****d@g****m 1
Francesco Landolfi f****i 1
Hao-Wen Dong s****5@c****w 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 28
  • Total pull requests: 11
  • Average time to close issues: 6 months
  • Average time to close pull requests: 8 months
  • Total issue authors: 17
  • Total pull request authors: 5
  • Average comments per issue: 1.68
  • Average comments per pull request: 1.45
  • Merged pull requests: 3
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • MaximusWhite (2)
  • Yannik1337 (2)
  • salu133445 (2)
  • djosix (2)
  • maximoskp (1)
  • Clockmender (1)
  • santient (1)
  • dedededefo (1)
  • Natooz (1)
  • huasheng-yue (1)
  • 15805383399 (1)
  • p3zo (1)
  • rgb000000 (1)
  • mauroalejandrojm (1)
  • ruiguo-bio (1)
Pull Request Authors
  • George-Ogden (3)
  • aspil (1)
  • adamoudad (1)
  • flandolfi (1)
  • bojobo (1)
Top Labels
Issue Labels
bug (7) question (6) enhancement (1)
Pull Request Labels
bug (2) enhancement (1)

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 2,163 last-month
  • Total dependent packages: 1
  • Total dependent repositories: 79
  • Total versions: 23
  • Total maintainers: 1
pypi.org: pypianoroll

A toolkit for working with piano rolls

  • Versions: 23
  • Dependent Packages: 1
  • Dependent Repositories: 79
  • Downloads: 2,163 Last month
Rankings
Dependent repos count: 1.7%
Average: 4.4%
Dependent packages count: 4.7%
Downloads: 6.8%
Maintainers (1)
Last synced: 6 months ago

Dependencies

setup.py pypi
  • matplotlib >=1.5
  • numpy >=1.12.0
  • pretty_midi >=0.2.8
  • scipy >=1.0.0