Module serial 

Tone rows, twelve-tone matrices and serial transformations. Tone rows and twelve-tone serial transformations, a port of music21’s serial module.

A ToneRow is an ordered sequence of pitch classes. It need not have twelve members and need not be a permutation of the aggregate; the methods that only make sense for a true twelve-tone row (is_all_interval, link_classification, are_combinatorial) return an error otherwise, where music21 raises SerialException.

music21 separates ToneRow, TwelveToneRow and HistoricalTwelveToneRow as stream subclasses. Nothing here dispatches on that distinction, so there is one row type, and the historical rows are a table of HistoricalRow entries that build a ToneRow on demand.

Structs

HistoricalRow

A twelve-tone row from the historical literature, with the attributes music21 stores for it.

LinkClassification

The Link chord number of a row and the interval sets that voice the all-trichord hexachord within it.

ToneRow

An ordered sequence of pitch classes.

TwelveToneMatrix

The transpositions of a row laid out as a matrix.

Enums

Transformation

A serial transformation of a tone row.

TransformationConvention

What the index of a transformation refers to.

Constants

HISTORICAL_ROWS

The historical twelve-tone rows music21 ships, in music21’s order.

Functions

historical_row_by_name

Looks a historical row up by music21’s name for it. The pre-v6 names with a Row prefix are accepted too.

row_to_matrix

music21’s rowToMatrix: the matrix of a pitch-class list as text, with the pitch classes written in decimal rather than as A and B.

Type Aliases

IndexedTransformation

A transformation and its index, as music21 reports one: ("I", 8).