Struct ToneRow 

pub struct ToneRow { /* private fields */ }

An ordered sequence of pitch classes.

Implementations

impl ToneRow

pub fn new(pitch_classes: impl IntoIterator<Item = IntegerType>) -> Self

Builds a row from pitch-class integers, which are reduced modulo 12 the way music21’s pcToToneRow does, so [-6, 19, 128] is [6, 7, 8].

pub fn from_pitches<'a>(pitches: impl IntoIterator<Item = &'a Pitch>) -> Self

Builds a row from the pitch classes of a sequence of pitches.

pub fn pitch_classes(&self) -> &[u8]

The pitch classes in order.

pub fn len(&self) -> usize

The number of pitch classes in the row.

pub fn is_empty(&self) -> bool

Whether the row has no pitch classes.

pub fn pitches(&self) -> Vec<Pitch>

The row as octave-less pitches, spelled the way music21 spells a pitch built from a pitch class (C#, E-, F#, G#, B-).

pub fn note_names(&self) -> Vec<String>

The note names of the row, music21’s noteNames.

pub fn is_twelve_tone_row(&self) -> bool

Whether the row is a permutation of all twelve pitch classes.

pub fn make_twelve_tone_row(&self) -> Result<ToneRow>

The row as a twelve-tone row: music21’s makeTwelveToneRow. There is one row type here, so this is the row itself, and a row that is not a permutation of the twelve pitch classes is an error rather than a row whose twelve-tone questions fail one by one.

pub fn is_same_row(&self, other: &ToneRow) -> bool

Whether two rows have the same pitch classes in the same order.

pub fn intervals_as_string(&self) -> String

The intervals between consecutive pitch classes as one character each, with T for ten and E for eleven: music21’s getIntervalsAsString.

pub fn zero_centered_transformation( &self, transformation: Transformation, index: IntegerType, ) -> ToneRow

Transforms the row in the zero-centered convention, where P(n) and I(n) start on pitch class n and R(n) and RI(n) end on it.

pub fn original_centered_transformation( &self, transformation: Transformation, index: IntegerType, ) -> ToneRow

Transforms the row in the original-centered convention, where T(n) transposes the row up n semitones and the other transformations act in place before transposing by n.

pub fn transformation( &self, convention: TransformationConvention, transformation: Transformation, index: IntegerType, ) -> ToneRow

Transforms the row under either convention.

pub fn find_zero_centered_transformations( &self, other: &ToneRow, ) -> Vec<IndexedTransformation>

The zero-centered transformations that take this row to other, in music21’s order P, I, R, RI.

pub fn find_original_centered_transformations( &self, other: &ToneRow, ) -> Vec<IndexedTransformation>

The original-centered transformations that take this row to other, in music21’s order T, I, R, RI.

pub fn find_transformations( &self, convention: TransformationConvention, other: &ToneRow, ) -> Vec<IndexedTransformation>

The transformations that take this row to other under either convention.

pub fn matrix(&self) -> TwelveToneMatrix

The row’s matrix: every transposition of the row, ordered so that the leading diagonal is zero and each column reads the inversion.

pub fn find_historical(&self) -> Vec<&'static HistoricalRow>

The historical rows identical to this one.

pub fn find_transformed_historical( &self, convention: TransformationConvention, ) -> Vec<(&'static HistoricalRow, Vec<IndexedTransformation>)>

The historical rows of which this row is a transformation, each with the transformations taking the historical row to this one.

pub fn is_all_interval(&self) -> Result<bool>

Whether every interval class from one to eleven occurs between consecutive members of the row.

Errors unless the row is a twelve-tone row.

pub fn link_classification(&self) -> Result<Option<LinkClassification>>

The Link chord classification of the row, if it is one: an all-interval row containing a voicing of the all-trichord hexachord [0, 1, 2, 4, 7, 8], numbered as in John Link’s catalogue.

Errors unless the row is a twelve-tone row.

pub fn is_link_chord(&self) -> Result<bool>

Whether the row is a Link chord. Errors unless it is a twelve-tone row.

pub fn are_combinatorial( &self, first: Transformation, first_index: IntegerType, second: Transformation, second_index: IntegerType, ) -> Result<bool>

Whether two zero-centered transformations of the row are hexachordally combinatorial: their first hexachords together form the aggregate.

Errors unless the row is a twelve-tone row.

Trait Implementations

impl Clone for ToneRow

fn clone(&self) -> ToneRow

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ToneRow

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ToneRow

fn default() -> ToneRow

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ToneRow

Available on crate feature serde only.

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ToneRow

fn fmt(&self, f: &mut Formatter<'_>) -> Result

The pitch classes as single characters, A and B for ten and eleven.

impl Eq for ToneRow

impl From<Vec<u8>> for ToneRow

fn from(pitch_classes: Vec<u8>) -> Self

Converts to this type from the input type.

impl<const N: usize> From<[u8; N]> for ToneRow

fn from(pitch_classes: [u8; N]) -> Self

Converts to this type from the input type.

impl Hash for ToneRow

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Index<usize> for ToneRow

type Output = u8

The returned type after indexing.

fn index(&self, index: usize) -> &Self::Output

Performs the indexing (container[index]) operation.

impl<'a> IntoIterator for &'a ToneRow

type Item = &'a u8

The type of the elements being iterated over.

type IntoIter = Iter<'a, u8>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for ToneRow

fn eq(&self, other: &ToneRow) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ToneRow

Available on crate feature serde only.

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ToneRow