symusic 0.4.0

A high performance MIDI file parser with comprehensible interface.

symusic

Symusic("Sybolic Music") is a cross-platform note level midi decoding library with lightening speed, which is hundreds of times faster (100x to 1000x depending on your file size) than mido, the main midi parsing library in python.

The library is written in cpp and based on minimidi. It offers a python binding using pybind11.

Here, we have added a tutorial.ipynb for you to learn about how to use the library.

And a document is also available. Not complete though.

Features

• You can just read a midi file like score = symusic.Score("path to midi", ttype="tick")
• Writing back to midi is now supported! score.dump_midi("path")
• Multiple time unit (ttype) is now supported (currently tick and quarter)
• The tempo attribute in the tempo event represents quarter per minute (qpm)
• We offer some batch operation functions for both Score and Track class:
  • shift_pitch(offset: int)
  • shift_velocity(offset: int)
  • shift_time(offset: float)
  • sort(key, reverse)
• You can operate each note just like you did before in python (like PrettyMidi)
• Extremely fast pickle is now supported
• .numpy() method for getting SoA data
• .filter(func, inplace) method for filtering objets in all the "List" in symusic
• A new synthesizer is now available! It comes from our another project prestosynth. Find usages in our document. Note that we will support more features of soundfont for sythesizing in the future.

Installation

Use pre-compiled version

pip install symusic

Build from source

Make sure that your system has cmake and c++ compilers

git clone --recursive https://github.com/Yikai-Liao/symusic
pip install ./symusic

Benchmark

Parsing MIDI

• test using mahler.mid from minimidi/example on my laptop (i7-10875H, 32GB 2666MHz DDR4 RAM, Linux 6.1.69-1-lts)
• Note that mahler.mid is quite a large midi file. So this benchmark mainly relects the parsing time (the percentage of time of loading file gets more significant when file is smaller)
• midifile is writen in cpp, and could parse midi files to both event level and note level. It is slow mostly becuase of iostream.
• mido is writen in pure python, and only parses midi files to event level
• pretty_midi and miditoolkit is based on mido, and parse midi files to note level
• For libraries written in python or with python bindings, we use timeit to measure the time cost of parsing the midi file. nanobench for cpp libraries and BenchmarkTools for julia libraries.

library	level	absolute time	relative time
minimidi	event	2.86 ms	1.0x
symusic	note	3.47 ms ± 113 µs	1.2x
midifile	event	44.0 ms	15.4x
midifile	note	45.6 ms	15.9x
MIDI.jl	note	109.707 ms	38.4x
mido	event	2.92 s ± 42.7 ms	1021.0x
miditoolkit	note	3.15 s ± 38.2 ms	1101.4x
pretty_midi	note	3.16 s ± 9.56 ms	1104.9x
music21	note	4.23 s ± 34.5 ms	1479.0x

Acknowledgement

• minimidi : A fast and lightweight midi parsing library written in cpp, which is the foundation of this project.
• prestosynth : A new fast soundfont synthesizer written in cpp, which is the foundation of the synthesizer in this project.
• nanobind : A efficient and lightweight library for binding C++ to Python, which is significantly faster than pybind11.
• zpp_bits : An extraordinary fast and lightweight single header library for serialization and deserialization. I use it to support pickle.
• geek_time_cpp The example code of the book "Modern C++ Programming Practice". We use the metamacro.h in it for shortening the code.