3.2. pctheory.cseg
This module contains functionality for working with contour segments, or csegs. A cseg is modeled as a list of int elements.
com(a: int, b: int)int
Compares two contour pitches (cps) using the COM function. If pitch a is lower than b, returns 1. If they are the same, returns 0. If a is higher than b, returns -1.
com_mx(cseg1: list, cseg2: list)[[int]]
Creates the COM matrix for two csegs. This matrix shows the results of the COM function for every pair of contour pitches (cps) in the two csegs.
invert(cseg: list)[int]
Inverts a cseg.
retrograde(cseg: list)[int]
Retrogrades a cseg and returns a copy.
rotate(cseg: list, n: int)[int]
Rotates a cseg to the left n positions.
simplify(cseg: list)[int]
Simplifies a cseg. If the cseg contains contour pitches with numbering gaps, for example, <0, 2, 1, 8, 6> it will be reduced to <0, 2, 1, 4, 3>.