Struct FrequencyTransferFunction 

pub struct FrequencyTransferFunction<T> { /* private fields */ }

Frequency transfer function ω [rad/s] -> G(jω). Built from a TransferFunction (s = jω / z = e^{jωTs}) or from any closure, so that elements without a rational form (e.g. dead time e^{-jωL}) can also be handled.

use dsmc::{tf, BodeDiagramPlotter, NyquistPlotter};

// Second-order low-pass filter, 10 Hz
let wn = 2.0 * std::f64::consts::PI * 10.0;
let g = tf!("{} / (s^2 + {} s + {})", wn * wn, 1.4 * wn, wn * wn);
let g_jw = g.frequency_transfer_function();

// Bode diagram from 1 Hz to 100 Hz (gain in dB) and Nyquist plot
let bode = BodeDiagramPlotter::<f64>::new(1.0, 100.0, 1.0, true).plot(&g_jw);
let nyquist = NyquistPlotter::<f64>::new(1.0, 100.0, 1.0).plot(&g_jw);
assert_eq!(bode.len(), nyquist.len());

Implementations

impl<T: Float + FloatConst + 'static> FrequencyTransferFunction<T>

pub fn new(response: impl Fn(T) -> Complex<T> + 'static) -> Self

From any omega [rad/s] -> G(jω) closure, e.g. a dead time |w| Complex::new(0.0, -w * l).exp().

pub fn response(&self, omega: T) -> Complex<T>

Complex response G(jω).

pub fn inverse(&self) -> Self

Inverse 1 / G(jω), e.g. the input shape that flattens the output of G.

pub fn characteristics<U: FrequencyUnit>( &self, frequency: T, log_scale: bool, ) -> FrequencyCharacteristics<T, U>

Gain (in dB if log_scale, otherwise the magnitude) and phase [rad] at frequency given in U.

pub fn characteristics_fn<U: FrequencyUnit>( &self, log_scale: bool, ) -> impl Fn(T) -> FrequencyCharacteristics<T, U> + '_

|frequency| -> FrequencyCharacteristics closure (see characteristics).

Trait Implementations

impl<T> Clone for FrequencyTransferFunction<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> From<&FrequencyTransferFunction<T>> for FrequencyTransferFunction<T>

fn from(g: &FrequencyTransferFunction<T>) -> Self

Converts to this type from the input type.

impl<T: Float + FloatConst + 'static> From<&TransferFunction<T>> for FrequencyTransferFunction<T>

fn from(tf: &TransferFunction<T, Continuous>) -> Self

Converts to this type from the input type.

impl<T: Float + FloatConst + 'static> From<&TransferFunctionWithDelay<T>> for FrequencyTransferFunction<T>

fn from(g: &TransferFunctionWithDelay<T>) -> Self

Converts to this type from the input type.

impl<T: Float + FloatConst + 'static> From<TransferFunction<T>> for FrequencyTransferFunction<T>

fn from(tf: TransferFunction<T, Continuous>) -> Self

Converts to this type from the input type.

impl<T: Float + FloatConst + 'static> From<TransferFunctionWithDelay<T>> for FrequencyTransferFunction<T>

fn from(g: TransferFunctionWithDelay<T>) -> Self

Converts to this type from the input type.

impl<T: Float + FloatConst + 'static> Mul for FrequencyTransferFunction<T>

Series connection G1(jω) G2(jω), e.g. a continuous plant with a discrete controller.

type Output = FrequencyTransferFunction<T>

The resulting type after applying the * operator.

fn mul(self, rhs: Self) -> Self

Performs the * operation.

impl<T: Float + FloatConst + 'static> Mul for &FrequencyTransferFunction<T>

type Output = FrequencyTransferFunction<T>

The resulting type after applying the * operator.

fn mul(self, rhs: Self) -> FrequencyTransferFunction<T>

Performs the * operation.