pub trait ComplexToRealTransformsOps<T>: ToRealResultwhere
T: RealNumber,{
// Required methods
fn magnitude(self) -> Self::RealResult;
fn magnitude_squared(self) -> Self::RealResult;
fn to_real(self) -> Self::RealResult;
fn to_imag(self) -> Self::RealResult;
fn phase(self) -> Self::RealResult;
}
Expand description
Defines transformations from complex to real number space.
§Failures
All operations in this trait set self.len()
to 0
if the type isn’t in
the complex number space.
Required Methods§
sourcefn magnitude(self) -> Self::RealResult
fn magnitude(self) -> Self::RealResult
Gets the absolute value, magnitude or norm of all vector elements.
§Example
use basic_dsp_vector::*;
let vector = vec!(Complex::new(3.0, -4.0), Complex::new(-3.0, 4.0)).to_complex_time_vec();
let result = vector.magnitude();
assert_eq!([5.0, 5.0], result[0..]);
sourcefn magnitude_squared(self) -> Self::RealResult
fn magnitude_squared(self) -> Self::RealResult
Gets the square root of the absolute value of all vector elements.
§Example
use basic_dsp_vector::*;
let vector = vec!(Complex::new(3.0, -4.0), Complex::new(-3.0, 4.0)).to_complex_time_vec();
let result = vector.magnitude_squared();
assert_eq!([25.0, 25.0], result[0..]);
sourcefn to_real(self) -> Self::RealResult
fn to_real(self) -> Self::RealResult
Gets all real elements.
§Example
use basic_dsp_vector::*;
let vector = vec!(Complex::new(1.0, 2.0), Complex::new(3.0, 4.0)).to_complex_time_vec();
let result = vector.to_real();
assert_eq!([1.0, 3.0], result[0..]);
sourcefn to_imag(self) -> Self::RealResult
fn to_imag(self) -> Self::RealResult
Gets all imag elements.
§Example
use basic_dsp_vector::*;
let vector = vec!(Complex::new(1.0, 2.0), Complex::new(3.0, 4.0)).to_complex_time_vec();
let result = vector.to_imag();
assert_eq!([2.0, 4.0], result[0..]);
sourcefn phase(self) -> Self::RealResult
fn phase(self) -> Self::RealResult
Gets the phase of all elements in [rad].
§Example
use basic_dsp_vector::*;
let data: Vec<Complex<f32>> = vec!(Complex::new(1.0, 0.0), Complex::new(0.0, 4.0), Complex::new(-2.0, 0.0), Complex::new(0.0, -3.0), Complex::new(1.0, 1.0));
let vector = data.to_complex_time_vec();
let result = vector.phase();
assert_eq!([0.0, 1.5707964, 3.1415927, -1.5707964, 0.7853982], result[0..]);