Struct DropFit 

pub struct DropFit {
    pub onset: Seconds,
    pub f_end: Hz,
    pub df_hz: f64,
    pub tau: Seconds,
    pub residual: f64,
    pub points: usize,
}

A fitted drop.

Fields

onset: Seconds

The onset the fit counts t from.

f_end: Hz

The settled frequency.

df_hz: f64

The frequency above f_end at the onset, in hertz; negative for a rise.

tau: Seconds

The time constant.

residual: f64

The RMS residual over the fall the fit span shows, |df_hz| exp(-DROP_FIT_START / tau). Over the extrapolated df_hz a fast swing at the onset, fitted with a tau under a millisecond, would read a tiny share.

points: usize

The number of line values the fit read.

Implementations

impl DropFit

pub fn settled(&self) -> Seconds

Five time constants after the onset, where 99.3 % of the fall is done: the drop has settled.

pub fn df(&self) -> Option<Semitones>

The drop in semitones, 12 log2((f_end + df) / f_end), or None when f_end + df is not above zero.

pub fn visible(&self) -> Option<Semitones>

The drop the line shows inside the fit span, in semitones: from the fitted frequency at DROP_FIT_START down to f_end. A fast fall that ends before the span starts is extrapolated, not seen, such as the overshoot of the line at a tone’s onset.

pub fn accepted(&self) -> bool

Whether the fit counts as a drop: df from above DROP_MIN up to DROP_MAX, the visible drop above DROP_MIN, tau above DROP_TAU_MIN and the residual below DROP_MAX_RESIDUAL. A tau on the bound means the best fit lies below it.

pub fn miss(&self) -> Option<DropMiss>

The first condition of Self::accepted the fit misses, or None when it counts as a drop.

Trait Implementations

impl Clone for DropFit

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DropFit

impl Debug for DropFit

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

Formats the value using the given formatter.

impl PartialEq for DropFit

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DropFit