3.1. pctheory.array
This module contains functionality for working with arrays of pitch-classes. An array is a 2D list (or matrix) that contains a pitch-class or pitch-class collection in each cell.
class RotationalArray
Represents a Stravinskian rotational array. A rotational array is a nxn array, where n is the length of the generating pcseg. Each row i of the rotational array is rotated to the left i positions, and transposed so that the first pitch-class is the same as the first pitch-class in the top row.
RotationalArray constructor
RotationalArray.__init__(pcseg=None)
Constructs a RotationalArray. You can initialize the rotational array with a pcseg.
RotationalArray read-only properties
RotationalArray.array[[PitchClass12]]
Gets the rotational array as a 2D list.
RotationalArray.pcseg[PitchClass12]
Gets the pcseg that generated the rotational array.
RotationalArray methods
RotationalArray.get_column(j: int)[PitchClass12]
Gets the column at index j of the rotational array.
RotationalArray.get_row(i: int)[PitchClass12]
Gets the row at index i of the rotational array.
RotationalArray.import_pcseg(pcseg: list)
Imports a pcseg and generates the RotationalArray.
RotationalArray overloaded special functions
Overloaded special functions include __getitem__(), __repr__(), and __str__(). Basically, this means that you can index an RotationalArray object (for example, my_ra[i][j]) to get the contents of a specific cell. The str() implementation allows RotationalArray objects to be printed.
str_simple_array(array, col_delimiter=" ", row_delimiter="∖n")str
Converts an array of pitch-classes to a multiline string. You can override the default row and column delimiters.
make_array_chain(array, length: int)[[PitchClass12]]
Takes an input array and daisy-chains transformations of that array together. The input array must have the same set-class in its first and last columns.