Enum Transform 

pub enum Transform {
    L,
    P,
    R,
}

One of the three neo-Riemannian transformations.

Variants

L

Leading-tone exchange: a major root falls a semitone, a minor fifth rises one. C major becomes E minor.

P

Parallel: the third moves a semitone. C major becomes C minor.

R

Relative: a major fifth rises a tone, a minor root falls one. C major becomes A minor.

Implementations

impl Transform

pub fn from_symbol(symbol: char) -> Result<Self>

The transformation a letter names: L, P or R.

Errors

Any other letter.

pub fn symbol(self) -> char

The letter naming the transformation.

pub fn parse_chain(symbols: &str) -> Result<Vec<Self>>

The transformations a string of letters names, in the order written.

Errors

A letter other than L, P or R.

pub fn apply(self, chord: &Chord) -> Result<Chord>

music21’s L, P and R: chord transformed, every other pitch kept where it was. The result’s spelling is no longer inferred, and it keeps chord’s duration.

use music21_rs::{Chord, Pitch, analysis::neoriemannian::Transform};

let c_major = Chord::new("C4 E4 G4")?;
let e_minor = Transform::L.apply(&c_major)?;
assert_eq!(e_minor.pitches().iter().map(Pitch::name_with_octave).collect::<Vec<_>>(), ["B3", "E4", "G4"]);

Errors

A chord that is not a major or minor triad.

Trait Implementations

impl Clone for Transform

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Transform

impl Debug for Transform

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Transform

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 Eq for Transform

impl Hash for Transform

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 PartialEq for Transform

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Transform

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 Transform