Struct RowMatrix 

pub struct RowMatrix { /* private fields */ }

A conventional twelve-tone matrix retaining its source and label policy.

The first row is the source row (P0 by operation identity). Each matrix row is a P form, each column is an I form, and the reverse readings are the corresponding R and RI forms. Operations stay algebraic; edge labels are projections through the matrix’s explicit RowLabelConvention.

Implementations

impl RowMatrix

pub fn new(source: &ToneRow, convention: RowLabelConvention) -> Self

Constructs the matrix for source under an explicit edge-label convention.

pub const fn source(&self) -> &ToneRow

Returns the source row retained by this matrix.

pub const fn convention(&self) -> RowLabelConvention

Returns the label convention used by every edge label.

pub const fn cells(&self) -> &[[PitchClass; 12]; 12]

Returns all matrix pitch classes in row-major layout.

pub const fn cell(&self, coordinate: MatrixCoordinate) -> RowMatrixCell

Returns one coordinate-bearing cell.

pub fn row(&self, row: usize) -> Option<&[PitchClass; 12]>

Returns one left-to-right matrix row, or None for an invalid index.

pub fn column(&self, column: usize) -> Option<[PitchClass; 12]>

Returns one top-to-bottom matrix column, or None for an invalid index.

pub fn row_operation(&self, row: usize) -> Option<RowOperation>

Returns the P operation read left to right on one row.

pub fn column_operation(&self, column: usize) -> Option<RowOperation>

Returns the I operation read top to bottom on one column.

pub fn row_form(&self, row: usize) -> Option<RowForm>

Reconstructs the operation-bearing P form for one matrix row.

pub fn column_form(&self, column: usize) -> Option<RowForm>

Reconstructs the operation-bearing I form for one matrix column.

pub const fn edge_labels(&self) -> &RowMatrixEdgeLabels

Returns all four convention-dependent edge-label collections.

impl RowMatrix

pub fn render_data(&self) -> RowMatrixData

Projects this matrix to structured, coordinate-bearing data.

pub fn render_ascii(&self) -> String

Renders a self-describing ASCII matrix from the structured projection.

Trait Implementations

impl Clone for RowMatrix

fn clone(&self) -> RowMatrix

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RowMatrix

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

Formats the value using the given formatter.

impl Eq for RowMatrix

impl PartialEq for RowMatrix

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RowMatrix