Trait ElementaryOps

pub trait ElementaryOps<A, T, N, D>
where
    T: RealNumber,
    N: NumberSpace,
    D: Domain,
    A: GetMetaData<T, N, D>,
{
    // Required methods
    fn add(&mut self, summand: &A) -> Result<(), ErrorReason>;
    fn sub(&mut self, subtrahend: &A) -> Result<(), ErrorReason>;
    fn mul(&mut self, factor: &A) -> Result<(), ErrorReason>;
    fn div(&mut self, divisor: &A) -> Result<(), ErrorReason>;
}

Elementary algebra on types: addition, subtraction, multiplication and division

Required Methods

fn add(&mut self, summand: &A) -> Result<(), ErrorReason>

Calculates the sum of self + summand. It consumes self and returns the result.

Failures

TransRes may report the following ErrorReason members:

1. VectorsMustHaveTheSameSize: self and summand must have the same size
2. VectorMetaDataMustAgree: self and summand must be in the same domain and number space

Example

use basic_dsp_vector::*;
let mut vector1 = vec!(1.0, 2.0).to_real_time_vec();
let vector2 = vec!(10.0, 11.0).to_real_time_vec();
vector1.add(&vector2).expect("Ignoring error handling in examples");
assert_eq!([11.0, 13.0], vector1[0..]);

fn sub(&mut self, subtrahend: &A) -> Result<(), ErrorReason>

Calculates the difference of self - subtrahend. It consumes self and returns the result.

Failures

TransRes may report the following ErrorReason members:

1. VectorsMustHaveTheSameSize: self and subtrahend must have the same size
2. VectorMetaDataMustAgree: self and subtrahend must be in the same domain and number space

Example

use basic_dsp_vector::*;
let mut vector1 = vec!(1.0, 2.0).to_real_time_vec();
let vector2 = vec!(10.0, 11.0).to_real_time_vec();
vector1.sub(&vector2).expect("Ignoring error handling in examples");
assert_eq!([-9.0, -9.0], vector1[0..]);

fn mul(&mut self, factor: &A) -> Result<(), ErrorReason>

Calculates the product of self * factor. It consumes self and returns the result.

Failures

TransRes may report the following ErrorReason members:

1. VectorsMustHaveTheSameSize: self and factor must have the same size
2. VectorMetaDataMustAgree: self and factor must be in the same domain and number space

Example

use basic_dsp_vector::*;
let mut vector1 = vec!(1.0, 2.0).to_real_time_vec();
let vector2 = vec!(10.0, 11.0).to_real_time_vec();
vector1.mul(&vector2).expect("Ignoring error handling in examples");
assert_eq!([10.0, 22.0], vector1[0..]);

fn div(&mut self, divisor: &A) -> Result<(), ErrorReason>

Calculates the quotient of self / summand. It consumes self and returns the result.

Failures

TransRes may report the following ErrorReason members:

1. VectorsMustHaveTheSameSize: self and divisor must have the same size
2. VectorMetaDataMustAgree: self and divisor must be in the same domain and number space

Example

use basic_dsp_vector::*;
let mut vector1 = vec!(10.0, 22.0).to_real_time_vec();
let vector2 = vec!(2.0, 11.0).to_real_time_vec();
vector1.div(&vector2).expect("Ignoring error handling in examples");
assert_eq!([5.0, 2.0], vector1[0..]);

Implementors

impl<S, T, N, D, O, NO, DO> ElementaryOps<O, T, NO, DO> for DspVec<S, T, N, D>

where S: ToSliceMut<T>, T: RealNumber, N: NumberSpace, D: Domain, O: Vector<T> + GetMetaData<T, NO, DO>, NO: PosEq<N> + NumberSpace, DO: PosEq<D> + Domain,

impl<V, S, T, N, D> ElementaryOps<Matrix2xN<V, S, T>, T, N, D> for Matrix2xN<V, S, T>

where V: Vector<T> + ElementaryOps<V, T, N, D> + GetMetaData<T, N, D>, S: ToSlice<T>, T: RealNumber, N: NumberSpace, D: Domain,

impl<V, S, T, N, D> ElementaryOps<Matrix3xN<V, S, T>, T, N, D> for Matrix3xN<V, S, T>

where V: Vector<T> + ElementaryOps<V, T, N, D> + GetMetaData<T, N, D>, S: ToSlice<T>, T: RealNumber, N: NumberSpace, D: Domain,

impl<V, S, T, N, D> ElementaryOps<Matrix4xN<V, S, T>, T, N, D> for Matrix4xN<V, S, T>

where V: Vector<T> + ElementaryOps<V, T, N, D> + GetMetaData<T, N, D>, S: ToSlice<T>, T: RealNumber, N: NumberSpace, D: Domain,

impl<V, S, T, N, D> ElementaryOps<MatrixMxN<V, S, T>, T, N, D> for MatrixMxN<V, S, T>

where V: Vector<T> + ElementaryOps<V, T, N, D> + GetMetaData<T, N, D>, S: ToSlice<T>, T: RealNumber, N: NumberSpace, D: Domain,

impl<V, S, T, N, D> ElementaryOps<V, T, N, D> for Matrix2xN<V, S, T>

where V: Vector<T> + ElementaryOps<V, T, N, D> + GetMetaData<T, N, D>, S: ToSlice<T>, T: RealNumber, N: NumberSpace, D: Domain,

impl<V, S, T, N, D> ElementaryOps<V, T, N, D> for Matrix3xN<V, S, T>

where V: Vector<T> + ElementaryOps<V, T, N, D> + GetMetaData<T, N, D>, S: ToSlice<T>, T: RealNumber, N: NumberSpace, D: Domain,

impl<V, S, T, N, D> ElementaryOps<V, T, N, D> for Matrix4xN<V, S, T>

where V: Vector<T> + ElementaryOps<V, T, N, D> + GetMetaData<T, N, D>, S: ToSlice<T>, T: RealNumber, N: NumberSpace, D: Domain,

impl<V, S, T, N, D> ElementaryOps<V, T, N, D> for MatrixMxN<V, S, T>

where V: Vector<T> + ElementaryOps<V, T, N, D> + GetMetaData<T, N, D>, S: ToSlice<T>, T: RealNumber, N: NumberSpace, D: Domain,