Skip to main content

Audiolize your data

Project description


A python package to represent data using musical notes.

Documentation Status


pip install audiorepr


Demo in examples/

import pandas as pd
from audiorepr import audiolize

ecdc = ""

df = pd.read_csv(ecdc)

audiolize.audiolizer(df, target="ecdc-covid19-by-date.midi", pitch_columns=["DE", "AT", "FR"])
  • By default, we use a min-max mapper to map the data onto midi notes 16 to 96. You can easily write your own mapper or simply map your own data on to the range [0, 126].
  • The specified pandas dataframe columns will be mapped onto different tracks.
  • audiolize.audiolizer also accepts numpy array or list as data input.

Play the output midi file using the player of your choice.

  • timidity(Mac, Win, Linux): a midi play in your terminal.
  • GarageBand(Mac): free software by Apple. GarageBand allows you to change tune the audio by changing the volumes, instruments, tempo, etc.




  1. Create a new environment: conda create -n audiorepr python=3.7 pip
  2. Instal requirements: pip install -r requirements

Generate Documentation

The documentation is generated through sphinx.

  1. cd docs
  2. make html

The generated documentation is located inside build/html.

To update the documentation, update the .rst files in the source folder.


Publishing to PYPI service:

  1. Run python sdist bdist_wheel
  2. Test upload: python -m twine upload --repository testpypi dist/*
  3. Upload:
    python -m twine upload dist/*

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

audiorepr-0.0.2.tar.gz (5.2 kB view hashes)

Uploaded Source

Built Distribution

audiorepr-0.0.2-py3-none-any.whl (7.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page