Universal Music Theory Library - v0.12.0
    Preparing search index...

    Class ToneRow

    Twelve-tone / serial composition tools. All operations work in pitch-class space (0–11, C=0 convention is NOT required; the row is treated as an ordered sequence of pitch classes modulo 12).

    Forms are labeled by the pitch class they start on (P(n), I(n) and RI(n) begin on n), so the row as given is P(row[0]): P(0) only when the row starts on 0.

    Index

    Constructors

    • Parameters

      • row: number[]

        Ordered sequence of 12 unique pitch classes (0–11).

      Returns ToneRow

      if the row does not contain exactly 12 unique pitch classes.

    Methods

    • Returns the two hexachords of the row: first 6 and last 6 pitch classes.

      Returns [number[], number[]]

    • Returns the 12×12 tone row matrix: the first row is the row as given, the first column the inversion starting on the same pitch class. Each row is the P form that starts on its first pitch class (read right to left: R); each column, top to bottom, an I form (bottom to top: RI).

      Returns number[][]

    • Inversion (I) transposed so that it starts on pitch class n. The inversion mirrors all intervals of the row.

      Parameters

      • n: number

      Returns number[]

    • Returns true if the row is an all-interval series: every interval class from 1 to 11 appears exactly once between consecutive pitches.

      Returns boolean

    • Tests whether the row is hexachordally combinatorial with itself: some form's first hexachord holds the same pitch classes as the row's second hexachord, so the two together make an aggregate. Returns the first operation found ('P', 'I', 'RI') or null.

      • 'P': a transposition other than the row itself.
      • 'I': an inversion.
      • 'RI': a retrograde inversion.

      Returns "P" | "I" | "RI" | null

    • Prime form transposed so that it starts on pitch class n. The row as given is P(row[0]).

      Parameters

      • n: number

      Returns number[]

    • Retrograde of P(n): by default the row as given, reversed.

      Parameters

      • n: number = ...

      Returns number[]

    • Retrograde Inversion transposed so that it starts on pitch class n.

      Parameters

      • n: number

      Returns number[]