muda
====
[![GitHub license](https://img.shields.io/badge/license-ISC-blue.svg)](https://raw.githubusercontent.com/bmcfee/muda/master/LICENSE.md)
[![PyPI](https://img.shields.io/pypi/v/muda.svg)](https://pypi.python.org/pypi/muda)
[![Build Status](https://travis-ci.org/bmcfee/muda.svg?branch=master)](https://travis-ci.org/bmcfee/muda)
[![Coverage Status](https://coveralls.io/repos/bmcfee/muda/badge.svg?branch=master&service=github)](https://coveralls.io/github/bmcfee/muda?branch=master)
[![Documentation Status](https://readthedocs.org/projects/muda/badge/?version=latest)](http://muda.readthedocs.org/en/latest/?badge=latest)

A library for **Mu**sical **D**ata **A**ugmentation.

**muda** package implements annotation-aware musical data augmentation, as described in
the [muda paper](http://bmcfee.github.io/papers/ismir2015_augmentation.pdf).

The goal of this package is to make it easy for practitioners to consistently apply
perturbations to annotated music data for the purpose of fitting statistical models.


Documentation
-------------
The documentation for the latest version of muda is available [here](https://muda.readthedocs.io/en/latest/).


Citing
------
If you use this software, please cite the following publication:

```
@inproceedings{mcfee2015_augmentation,
    author  = {McFee,, B. and Humphrey,, E.J. and Bello, J.P.},
    year    = {2015},
    title   = {A software framework for musical data augmentation},
    booktitle = {16th International Society for Music Information Retrieval Conference},
    series  = {ISMIR}
}
```