Struct MfccExtractor 

pub struct MfccExtractor { /* private fields */ }

MFCC extractor with configurable parameters.

Examples

use resonant_analysis::mfcc::MfccExtractor;

let extractor = MfccExtractor::new(44100.0);
let samples = vec![0.0_f32; 4096];
let frames = extractor.extract(&samples).unwrap();
// Each frame has 13 coefficients by default
for f in &frames {
    assert_eq!(f.coefficients.len(), 13);
}

Implementations

impl MfccExtractor

pub fn new(sample_rate: f32) -> Self

Creates an extractor with default parameters.

Defaults: 13 coefficients, 26 mel bands, window 1024, hop 512.

pub fn with_num_coefficients(self, n: usize) -> Self

Sets the number of MFCC coefficients to keep per frame.

pub fn with_num_mel_bands(self, n: usize) -> Self

Sets the number of mel filterbank bands.

pub fn with_window_size(self, size: usize) -> Self

Sets the STFT window size (should be a power of two).

pub fn with_hop_size(self, hop: usize) -> Self

Sets the STFT hop size.

pub fn extract(&self, samples: &[f32]) -> Result<Vec<MfccFrame>, AnalysisError>

Extracts MFCC frames from mono audio samples.

Errors

Returns AnalysisError::EmptyInput if samples is empty, or AnalysisError::InvalidParameter if parameters are inconsistent.

pub fn deltas( frames: &[MfccFrame], width: usize, ) -> Result<Vec<MfccFrame>, AnalysisError>

Computes delta (first derivative) coefficients from MFCC frames.

Uses a regression window of width frames on each side.

Errors

Returns AnalysisError::EmptyInput if frames is empty, or AnalysisError::InvalidParameter if width is zero.

pub fn delta_deltas( frames: &[MfccFrame], width: usize, ) -> Result<Vec<MfccFrame>, AnalysisError>

Computes delta-delta (second derivative / acceleration) coefficients.

Equivalent to applying deltas twice.

Errors

Same as deltas.

Trait Implementations

impl Clone for MfccExtractor

fn clone(&self) -> MfccExtractor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MfccExtractor

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

Formats the value using the given formatter.