# `temperaments` crate

## Included Temperaments

This crate provides definitions of various historical and modern musical temperments. This crate includes:

* Equal Temperament
* Kirnberger II
* Meantone
  * 1/4 Syntonic Comma
  * 1/5 Syntonic Comma
  * 1/6 Syntonic Comma
  * LucyTuning
* Pythagorean (1/6 Pythagorean Comma)
* Vallotti (1/6 Comma)
* Temperament based on the cover of Bach's Well Tempered Clavier (1722)
* Werckmeister III
* Young's No. 2

By implementing your own structs that implement the `Temperament` trait, you can define your own temperaments!

We have plans to add additional temperaments. If you would like any specific temperament to be added, please file an issue.


## Functionality

This crate also provides functionality such as:

* A table of frequencies for all pitches for any given temperament
* Adding cents to a frequency
* Calculating the number of cents between two frequencies
* Finding the closest note based on a given frequency

Please feel free to file issues for any new feature requests!


## Credit
The temperaments in this module are based on research presented in the following resources:
* Bradley Lehman's article "Bach’s Extraordinary Temperament: Our Rosetta Stone" ([Part 1](https://www.jstor.org/stable/3519512) and [Part 2](https://www.jstor.org/stable/3519449))
* Bradley Lehman's [Keyboard Temperament Analyzer / Calculator](http://bpl.rf.gd/temper.html)
* ["Tuning and Temperament: A Historical Survey"](https://books.google.com/books/about/Tuning_and_Temperament.html?id=G-pG77pmlp4C) by J. Murray Barbour
* Wikipedia articles on each, specific temperament systems such as the [one on the Werckmeister Temperament](https://en.wikipedia.org/wiki/Werckmeister_temperament)
* Indiana University's [resource on Tuning & Temperaments](https://intranet.music.indiana.edu/departments/offices/piano-technology/temperaments/index.html)