setclass/README.md

Python library for set class music theory

A hopefully useful library for exploring set classes in music theory, of arbitrary tonalities (any number of equal divisions of the octave).

Run tests

To download the code, and run the tests:

git clone https://git.jon.geek.nz/public/setclass
cd setclass
python -m virtualenv .venv
source .venv/bin/activate
pip install -r requirements-dev.txt
tox

Usage

In Python:

from setclass import SetClass
sc = SetClass(0, 3, 5, 6, 7, 10, 11)  # Forte 7-20; pitch classes as integers 0-11
sc.versions
sc.brightest_form
sc.darkest_form
sc.duodecimal_notation  # SetClass[0,3,5,6,7,T,E]

Proper library documentation to come soon with Sphinx.

TODO

• Documentation (Sphinx)
• Interoperate with music21 objects
• Generate MIDI files
• Generate LilyPond files for set pitches
• Calculate microtonal pitches and frequencies for use with non-dodecal tonalities