Struct LevelTrack 

pub struct LevelTrack { /* private fields */ }

A level track in dB, one value per HOP from start.

Implementations

impl LevelTrack

pub fn new(start: Seconds, db: Vec<f64>) -> Self

Pairs dB values with the time of the first.

pub fn rms( samples: &[f64], first: usize, rate: SampleRate, (from, to): (Seconds, Seconds), f0: Hz, periods: f64, ) -> Self

The centred RMS of samples in dB, from from to to, over the window of rms_window. samples starts at sample first of the stem, so a note reads only its own span. The window shrinks at the ends of the samples.

pub fn window(&self) -> Seconds

Returns the RMS window of the track, 0 s when it has none.

pub fn partials( samples: &[f64], offset: Seconds, rate: SampleRate, (from, to): (Seconds, Seconds), partials: &[(Hz, Hz)], ) -> Result<Self, FilterError>

The summed power of single partials in dB, from from to to.

Each partial is a (frequency, cutoff) pair: the zero-phase band magnitude of band_magnitude over frequency ± cutoff, so a track has no lag. samples starts at offset in the stem.

Errors

Returns a FilterError when a band reaches 0 Hz or the Nyquist frequency.

pub fn harmonic( samples: &[f64], first: usize, rate: SampleRate, (from, to): (Seconds, Seconds), frequency: Hz, f0: Hz, ) -> Self

The magnitude of one harmonic in dB, from from to to: a sliding DFT at frequency over one period of f0, centred on each frame.

The window spans a whole period of the fundamental, so every other harmonic of the note falls on a null, and its step response rises without overshoot, unlike a Butterworth low-pass. A partial of amplitude A reads A, its power A^2 / 2 as the RMS track reads it. samples starts at sample first of the stem. At the start of the samples the window keeps its whole period and runs from the first sample, so the nulls hold; at their end it shrinks.

pub fn start(&self) -> Seconds

Returns the time of the first value.

pub fn db(&self) -> &[f64]

Returns the dB values.

pub fn db_mut(&mut self) -> &mut [f64]

Returns the dB values to change in place.

pub fn time(&self, i: usize) -> f64

Returns the time of value i.

pub fn index(&self, t: f64) -> usize

Returns the index of the value at or after time t, clamped to the track.

Trait Implementations

impl Clone for LevelTrack

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LevelTrack

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

Formats the value using the given formatter.

impl PartialEq for LevelTrack

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for LevelTrack