Trait TimeWaveform

pub trait TimeWaveform {
    type Data: Copy + From<i32> + Add<Self::Data, Output = Self::Data> + Div<Self::Data, Output = Self::Data> + PartialOrd + Sub<Self::Data, Output = Self::Data> + Mul<Self::Data, Output = Self::Data>;

    // Required methods
    fn get(&self, idx: usize) -> Option<TimePoint<Self::Data>>;
    fn len(&self) -> usize;

    // Provided methods
    fn is_empty(&self) -> bool { ... }
    fn first_t(&self) -> Option<Self::Data> { ... }
    fn first_x(&self) -> Option<Self::Data> { ... }
    fn last_t(&self) -> Option<Self::Data> { ... }
    fn last_x(&self) -> Option<Self::Data> { ... }
    fn first(&self) -> Option<TimePoint<Self::Data>> { ... }
    fn last(&self) -> Option<TimePoint<Self::Data>> { ... }
    fn edges(&self, threshold: Self::Data) -> Edges<'_, Self, Self::Data> { ... }
    fn transitions(
        &self,
        low_threshold: Self::Data,
        high_threshold: Self::Data,
    ) -> Transitions<'_, Self, Self::Data> { ... }
    fn values(&self) -> Values<'_, Self>  { ... }
    fn time_index_before(&self, t: Self::Data) -> Option<usize> { ... }
    fn sample_at(&self, t: Self::Data) -> Self::Data { ... }
    fn max_x(&self) -> Option<Self::Data> { ... }
    fn min_x(&self) -> Option<Self::Data> { ... }
    fn mid_x(&self) -> Option<Self::Data> { ... }
    fn integral(&self) -> Self::Data { ... }
}

A time-domain waveform.

Required Associated Types

type Data: Copy + From<i32> + Add<Self::Data, Output = Self::Data> + Div<Self::Data, Output = Self::Data> + PartialOrd + Sub<Self::Data, Output = Self::Data> + Mul<Self::Data, Output = Self::Data>

The datatype of time and signal values in the waveform.

Typically, this should be f64 or [rust_decimal::Decimal].

Required Methods

fn get(&self, idx: usize) -> Option<TimePoint<Self::Data>>

Get the value of the waveform at the given index.

fn len(&self) -> usize

Returns the number of time points in the waveform.

Provided Methods

fn is_empty(&self) -> bool

Returns true if the waveform is empty.

fn first_t(&self) -> Option<Self::Data>

The time associated with the first point in the waveform.

fn first_x(&self) -> Option<Self::Data>

The value associated with the first point in the waveform.

fn last_t(&self) -> Option<Self::Data>

The time associated with the last point in the waveform.

fn last_x(&self) -> Option<Self::Data>

The value associated with the last point in the waveform.

fn first(&self) -> Option<TimePoint<Self::Data>>

The first point in the waveform.

fn last(&self) -> Option<TimePoint<Self::Data>>

The last point in the waveform.

fn edges(&self, threshold: Self::Data) -> Edges<'_, Self, Self::Data>

Returns an iterator over the edges in the waveform.

See Edges for more information.

fn transitions( &self, low_threshold: Self::Data, high_threshold: Self::Data, ) -> Transitions<'_, Self, Self::Data>

Returns an iterator over the transitions in the waveform.

See Transitions for more information.

fn values(&self) -> Values<'_, Self>

Returns an iterator over the values in the waveform.

See Values for more information.

fn time_index_before(&self, t: Self::Data) -> Option<usize>

Returns the index of the last point in the waveform with a time before t.

fn sample_at(&self, t: Self::Data) -> Self::Data

Retrieves the value of the waveform at the given time.

By default, linearly interpolates between two adjacent points on the waveform.

fn max_x(&self) -> Option<Self::Data>

Returns the maximum value seen in this waveform.

fn min_x(&self) -> Option<Self::Data>

Returns the minimum value seen in this waveform.

fn mid_x(&self) -> Option<Self::Data>

Returns the middle value seen in this waveform.

This is typically the arithmetic average of the max and min values.

fn integral(&self) -> Self::Data

Returns the time integral of this waveform.

By default, uses trapezoidal integration. Returns 0.0 if the length of the waveform is less than 2.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors

impl<T> TimeWaveform for Waveform<T>

where T: Copy + Add<T, Output = T> + Div<T, Output = T> + PartialOrd + Sub<T, Output = T> + Mul<T, Output = T> + From<i32>,

type Data = T

impl<T> TimeWaveform for WaveformRef<'_, T>

where T: Copy + Add<T, Output = T> + Div<T, Output = T> + PartialOrd + Sub<T, Output = T> + Mul<T, Output = T> + From<i32>,

type Data = T