Struct PitchTrack 

pub struct PitchTrack { /* private fields */ }

The f0 track of a stem.

Implementations

impl PitchTrack

pub fn of(mono: &[f64], rate: SampleRate) -> Result<Self, TrackError>

Runs the tracker over a mono stem at any rate. The stem is resampled to the model rate, and the copy the tracker reads is scaled to a peak of 1, because the tracker treats a frame below a fixed energy as silence. A silent or empty stem gives a track with no voiced frame.

Errors

Returns a TrackError when resampling fails, a sample is not finite or the tracker cannot run: it refuses the settings, a transform fails or a candidate has no pitch bin. The settings are constants, so the last three point to a bug.

pub fn from_frames(frames: Vec<TrackFrame>) -> Self

Builds a track from frames, such as a test’s.

pub fn frames(&self) -> &[TrackFrame]

Returns every frame in time order.

pub fn voiced_between( &self, onset: Seconds, offset: Seconds, ) -> impl Iterator<Item = (Seconds, Hz)> + '_

Returns the voiced frames from onset (inclusive) to offset (exclusive) as (time, f0).

pub fn voiced_pitches(&self) -> Vec<MidiPitch>

Returns the pitches of every voiced frame, as fractional MIDI pitches.

pub fn contour(&self, onset: Seconds, offset: Seconds) -> Option<Contour>

Returns the f0 contour of a span: the voiced frames inside it, or None when none is voiced.

pub fn with_contours(&self, notes: &NoteList) -> NoteList

Sets the f0 contour of every note that has a voiced frame inside it.

Trait Implementations

impl Clone for PitchTrack

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 PitchTrack

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

Formats the value using the given formatter.

impl Default for PitchTrack

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for PitchTrack

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PitchTrack