Skip to main content

Module tables

Module tables 

Source
Expand description

Look-up over music21’s Forte tables of set classes.

These are the tables every set-class question a Chord answers is read out of — its prime form, its Forte name, its interval vector — and music21 exposes them as chord.tables so that a caller holding an address can read the same values with no chord to ask. A set class is named by its cardinality and its Forte class number, with an inversion of 1 or -1 for the two halves of an inversionally related pair and 0 for a class that is its own inversion; the inversion may be left out, and the table then says which it is.

The tables are generated from music21’s own chord/tables.py; see xtask verify-tables.

Functions§

address_of_pitch_classes
Where a set of pitch classes sits in the tables: music21’s seekChordTablesAddress.
common_names
What the set class is commonly called, where it is called anything: music21’s addressToCommonNames.
forte_name
The set class’s Forte name, such as 8-15B: music21’s addressToForteName.
interval_class_vector
The set class’s interval class vector, six counts of how many intervals of each class it holds: music21’s addressToIntervalVector.
inversions_available
The inversions a set class comes in: [0] for one that is its own inversion, and [-1, 1] for the two halves of an inversionally related pair.
normal_form
The set class’s normal form, transposed to start on zero: music21’s addressToTransposedNormalForm.
prime_form
The set class’s prime form, which is the same whichever inversion the address names: music21’s addressToPrimeForm.
read_address
Reads an address, filling in the inversion where one was not given: music21’s _validateAddress.
set_classes_with_interval_vector
Every set class with this interval vector, as cardinality and Forte class number pairs: music21’s intervalVectorToAddress.
z_related_class
The set class Z-related to this one — the other with the same interval vector — where there is one: music21’s addressToZAddress.