Skip to content

Python tools for experimenting with differentiable intonation cost measures

License

Notifications You must be signed in to change notification settings

simonschwaer/differentiable-intonation-tools

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Differentiable Intonation Tools

The Differentiable Intonation Tools (dit) are a collection of Python functions to analyze the intonation in multitrack audio signals.

In particular, two measures are made available here, a tonal cost (the proximity to a tonal grid) and a harmonic cost (the perceptual dissonance between salient frequencies). The cost measures can be used to adapt intonation of multitrack audio signals in relation to each other, by minimizing the the cost using gradient descent (as exemplified in the notebook examples.ipynb).

Details and application examples can be found in the reference below and on the accompanying website.

Reference

If you use the Differentiable Intonation Tools in your research, please cite the following paper:

Simon Schwär, Sebastian Rosenzweig, and Meinard Müller: A Differentiable Cost Measure for Intonation Processing in Polyphonic Music. In Proceedings of the International Society for Music Information Retrieval Conference (ISMIR): 626–633, 2021.

Installation

There is no pip package (yet?), so please clone this repository, navigate to the root folder and install with

python setup.py [install|develop]

or

pip install -e .

Required software packages: numpy (>= 1.17.0), scipy (>= 1.7.0), librosa (>= 0.8.0), libtsm (>= 1.1.0, for the example)

Usage

Please see the notebook examples.ipynb for some usage examples. API documentation can be found in the code files.

Acknowledgements

This project was supported by the German Research Foundation (DFG MU 2686/12-1, MU 2686/13-1). The International Audio Laboratories Erlangen are a joint institution of the Friedrich-Alexander Universität Erlangen-Nürnberg (FAU) and Fraunhofer Institute for Integrated Circuits IIS.

About

Python tools for experimenting with differentiable intonation cost measures

Resources

License

Stars

Watchers

Forks