Skip to main content

Audiolize your data

Project description

audiorepr

A python package to represent data using musical notes.

Documentation Status

Installation

pip install audiorepr

Examples

Demo in examples/covid19.py.

import pandas as pd
from audiorepr import audiolize

ecdc = "https://gist.githubusercontent.com/emptymalei/90869e811b4aa118a7d28a5944587a64/raw/1534670c8a3859ab3a6ae8e9ead6795248a3e664/ecdc%2520covid%252019%2520data"

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.

Documentation

[WIP]

Development

  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

Publishing to PYPI service:

  1. Run python setup.py 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.

Files for audiorepr, version 0.0.2
Filename, size File type Python version Upload date Hashes
Filename, size audiorepr-0.0.2.tar.gz (5.2 kB) File type Source Python version None Upload date Hashes View
Filename, size audiorepr-0.0.2-py3-none-any.whl (7.1 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page