LPR

Enum LPR 

Source
pub enum LPR {
    Leading = 0,
    Parallel = 1,
    Relative = 2,
}
Expand description

The LPR implementation enumerates the primary transformations considered within the Neo-Riemannian theory. Each transformation is its own inverse (meaning consecutive applications of the same transformation will return the original triad) and may be chained together in both disctrete and continuous space to explore relationships between triads. These transformation act on the given triad based on the quality of the interval between the first and second notes (i.e., the root and third chord factors) meaning the effect of the transformation is dictated by whether the triad starts with a major or minor third.

With The transformations are:

  • Leading (L):
    • [Major] decrement the root by a semitone; move to the fifth
    • [Minor] increment the fifth by a semitone; move to the root
  • Parallel (P):
    • [Major] decrement the third by a semitone
    • [Minor] increment the third by a semitone
  • Relative (R):
    • [Major] add a whole tone to the fifth; move to the root
    • [Minor] subtract a whole tone from the root; move to the fifth

Using category theory we could define these transformations to be contravariant functors mapping between categories of triads.

Variants§

§

Leading = 0

Leading (L) transformation

§

Parallel = 1

Parallel (P) transformation

§

Relative = 2

Relative (R) transformation

Implementations§

Source§

impl LPR

Source

pub const fn is_leading(&self) -> bool

Returns true if the enum is LPR::Leading otherwise false

Source

pub const fn is_parallel(&self) -> bool

Returns true if the enum is LPR::Parallel otherwise false

Source

pub const fn is_relative(&self) -> bool

Returns true if the enum is LPR::Relative otherwise false

Source§

impl LPR

Source

pub const fn leading() -> Self

a functional constructor returning a Leading transformation

Source

pub const fn parallel() -> Self

a functional constructor returning a Parallel transformation

Source

pub const fn relative() -> Self

a functional constructor returning a Relative transformation

Source

pub fn iter() -> LPRIter

Source

pub fn apply<X, Y>(self, triad: X) -> Y
where Self: Dirac<X, Output = Y>,

a convenience method for applying a transformation onto a triad, panicking on failure.

Trait Implementations§

Source§

impl AsRef<str> for LPR

Source§

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.
Source§

impl Clone for LPR

Source§

fn clone(&self) -> LPR

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for LPR

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for LPR

Source§

fn default() -> LPR

Returns the “default value” for a type. Read more
Source§

impl<S, T, K> Dirac<&TriadBase<S, K, T>> for &LPR
where K: TriadType, K::Rel: TriadType, S: TriadRepr<Elem = T>, T: Copy + FromPrimitive + One + PitchMod<Output = T> + Add<Output = T> + Sub<Output = T>,

Source§

type Output = TriadBase<S, <K as Relative>::Rel, T>

Source§

fn apply(self, rhs: &TriadBase<S, K, T>) -> Self::Output

Source§

impl<S, T, K> Dirac<&TriadBase<S, K, T>> for LPR
where K: TriadType, K::Rel: TriadType, S: TriadRepr<Elem = T>, T: Copy + FromPrimitive + One + PitchMod<Output = T> + Add<Output = T> + Sub<Output = T>,

Source§

type Output = TriadBase<S, <K as Relative>::Rel, T>

Source§

fn apply(self, rhs: &TriadBase<S, K, T>) -> Self::Output

Source§

impl<S, T, K> Dirac<&mut TriadBase<S, K, T>> for LPR
where K: TriadType, K::Rel: TriadType, S: TriadRepr<Elem = T>, T: Copy + FromPrimitive + One + PitchMod<Output = T> + Add<Output = T> + Sub<Output = T>,

Source§

type Output = TriadBase<S, <K as Relative>::Rel, T>

Source§

fn apply(self, rhs: &mut TriadBase<S, K, T>) -> Self::Output

Source§

impl<S, T, K> Dirac<TriadBase<S, K, T>> for &LPR
where K: TriadType, K::Rel: TriadType, S: TriadRepr<Elem = T>, T: Copy + FromPrimitive + One + PitchMod<Output = T> + Add<Output = T> + Sub<Output = T>,

Source§

type Output = TriadBase<S, <K as Relative>::Rel, T>

Source§

fn apply(self, rhs: TriadBase<S, K, T>) -> Self::Output

Source§

impl<S, T, K> Dirac<TriadBase<S, K, T>> for &mut LPR
where K: TriadType, K::Rel: TriadType, S: TriadRepr<Elem = T>, T: Copy + FromPrimitive + One + PitchMod<Output = T> + Add<Output = T> + Sub<Output = T>,

Source§

type Output = TriadBase<S, <K as Relative>::Rel, T>

Source§

fn apply(self, rhs: TriadBase<S, K, T>) -> Self::Output

Source§

impl<S, T, K> Dirac<TriadBase<S, K, T>> for LPR
where K: TriadType, K::Rel: TriadType, S: TriadRepr<Elem = T>, T: Copy + FromPrimitive + One + PitchMod<Output = T> + Add<Output = T> + Sub<Output = T>,

Source§

type Output = TriadBase<S, <K as Relative>::Rel, T>

Source§

fn apply(self, rhs: TriadBase<S, K, T>) -> Self::Output

Source§

impl Display for LPR

Source§

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

Formats the value using the given formatter. Read more
Source§

impl EnumCount for LPR

Source§

const COUNT: usize = 3usize

Source§

impl From<LPR> for i128

Source§

fn from(value: LPR) -> Self

Converts to this type from the input type.
Source§

impl From<LPR> for i16

Source§

fn from(value: LPR) -> Self

Converts to this type from the input type.
Source§

impl From<LPR> for i32

Source§

fn from(value: LPR) -> Self

Converts to this type from the input type.
Source§

impl From<LPR> for i64

Source§

fn from(value: LPR) -> Self

Converts to this type from the input type.
Source§

impl From<LPR> for i8

Source§

fn from(value: LPR) -> Self

Converts to this type from the input type.
Source§

impl From<LPR> for isize

Source§

fn from(value: LPR) -> Self

Converts to this type from the input type.
Source§

impl From<LPR> for u128

Source§

fn from(value: LPR) -> Self

Converts to this type from the input type.
Source§

impl From<LPR> for u16

Source§

fn from(value: LPR) -> Self

Converts to this type from the input type.
Source§

impl From<LPR> for u32

Source§

fn from(value: LPR) -> Self

Converts to this type from the input type.
Source§

impl From<LPR> for u64

Source§

fn from(value: LPR) -> Self

Converts to this type from the input type.
Source§

impl From<LPR> for u8

Source§

fn from(value: LPR) -> Self

Converts to this type from the input type.
Source§

impl From<LPR> for usize

Source§

fn from(value: LPR) -> Self

Converts to this type from the input type.
Source§

impl From<i128> for LPR

Source§

fn from(value: i128) -> Self

Converts to this type from the input type.
Source§

impl From<i16> for LPR

Source§

fn from(value: i16) -> Self

Converts to this type from the input type.
Source§

impl From<i32> for LPR

Source§

fn from(value: i32) -> Self

Converts to this type from the input type.
Source§

impl From<i64> for LPR

Source§

fn from(value: i64) -> Self

Converts to this type from the input type.
Source§

impl From<i8> for LPR

Source§

fn from(value: i8) -> Self

Converts to this type from the input type.
Source§

impl From<isize> for LPR

Source§

fn from(value: isize) -> Self

Converts to this type from the input type.
Source§

impl From<u128> for LPR

Source§

fn from(value: u128) -> Self

Converts to this type from the input type.
Source§

impl From<u16> for LPR

Source§

fn from(value: u16) -> Self

Converts to this type from the input type.
Source§

impl From<u32> for LPR

Source§

fn from(value: u32) -> Self

Converts to this type from the input type.
Source§

impl From<u64> for LPR

Source§

fn from(value: u64) -> Self

Converts to this type from the input type.
Source§

impl From<u8> for LPR

Source§

fn from(value: u8) -> Self

Converts to this type from the input type.
Source§

impl From<usize> for LPR

Source§

fn from(value: usize) -> Self

Converts to this type from the input type.
Source§

impl FromStr for LPR

Source§

type Err = ParseError

The associated error which can be returned from parsing.
Source§

fn from_str(s: &str) -> Result<LPR, <Self as FromStr>::Err>

Parses a string s to return a value of this type. Read more
Source§

impl Hash for LPR

Source§

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

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

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

Feeds a slice of this type into the given Hasher. Read more
Source§

impl IntoEnumIterator for LPR

Source§

impl Ord for LPR

Source§

fn cmp(&self, other: &LPR) -> Ordering

This method returns an Ordering between self and other. Read more
1.21.0 · Source§

fn max(self, other: Self) -> Self
where Self: Sized,

Compares and returns the maximum of two values. Read more
1.21.0 · Source§

fn min(self, other: Self) -> Self
where Self: Sized,

Compares and returns the minimum of two values. Read more
1.50.0 · Source§

fn clamp(self, min: Self, max: Self) -> Self
where Self: Sized,

Restrict a value to a certain interval. Read more
Source§

impl PartialEq for LPR

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl PartialOrd for LPR

Source§

fn partial_cmp(&self, other: &LPR) -> Option<Ordering>

This method returns an ordering between self and other values if one exists. Read more
1.0.0 · Source§

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

Tests less than (for self and other) and is used by the < operator. Read more
1.0.0 · Source§

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

Tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 · Source§

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

Tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 · Source§

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

Tests greater than or equal to (for self and other) and is used by the >= operator. Read more
Source§

impl<S, T, K> Transform<LPR> for TriadBase<S, K, T>
where K: TriadType, K::Rel: TriadType, S: TriadRepr<Elem = T>, T: Copy + FromPrimitive + One + PitchMod<Output = T> + Add<Output = T> + Sub<Output = T>,

Source§

type Output = TriadBase<S, <K as Relative>::Rel, T>

Source§

fn transform(self, transformation: LPR) -> Self::Output

Source§

impl TryFrom<&str> for LPR

Source§

type Error = ParseError

The type returned in the event of a conversion error.
Source§

fn try_from(s: &str) -> Result<LPR, <Self as TryFrom<&str>>::Error>

Performs the conversion.
Source§

impl TryFrom<char> for LPR

Source§

type Error = TriadError

The type returned in the event of a conversion error.
Source§

fn try_from(value: char) -> Result<Self, Self::Error>

Performs the conversion.
Source§

impl VariantArray for LPR

Source§

const VARIANTS: &'static [Self]

Source§

impl VariantNames for LPR

Source§

const VARIANTS: &'static [&'static str]

Names of the variants of this enum
Source§

impl Copy for LPR

Source§

impl Eq for LPR

Source§

impl StructuralPartialEq for LPR

Auto Trait Implementations§

§

impl Freeze for LPR

§

impl RefUnwindSafe for LPR

§

impl Send for LPR

§

impl Sync for LPR

§

impl Unpin for LPR

§

impl UnwindSafe for LPR

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> AsWeight<T> for T
where T: Clone + IntoWeight<T>,

Source§

fn as_weight(&self) -> Weight<T>

Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<Q, K> Comparable<K> for Q
where Q: Ord + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn compare(&self, key: &K) -> Ordering

Compare self to key and return their ordering.
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> IntoWeight<T> for T

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> Wrapper<T> for T

Source§

type Cont<U> = U

Source§

fn get(&self) -> &T

returns a reference to the inner value
Source§

fn view(&self) -> <T as Wrapper<T>>::Cont<&T>

returns a view of the container containing an immutable reference to the inner value