ref: 1878b506fecc1b5131c78c41cf3120eb9458b046
dir: /src/spectral/filterbank_mel.h/
/*
Copyright (C) 2007-2013 Paul Brossier <piem@aubio.org>
and Amaury Hazan <ahazan@iua.upf.edu>
This file is part of aubio.
aubio is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
aubio is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with aubio. If not, see <http://www.gnu.org/licenses/>.
*/
/** \file
Filterbank object coefficients initialization
Functions to create set the ::aubio_filterbank_t coefficients to
- ::aubio_filterbank_set_triangle_bands: overlapping triangular bands,
- ::aubio_filterbank_set_mel_coeffs_slaney: Mel frequency bands.
\example spectral/test-filterbank_mel.c
*/
#ifndef AUBIO_FILTERBANK_MEL_H
#define AUBIO_FILTERBANK_MEL_H
#ifdef __cplusplus
extern "C"
{
#endif
/** filterbank initialization with triangular and overlapping bands
\param fb filterbank object
\param freqs arbitrary array of boundary frequencies
\param samplerate audio sampling rate
This function computes the coefficients of the filterbank based on the
boundaries found in freqs, in Hz, and using triangular overlapping bands.
*/
uint_t aubio_filterbank_set_triangle_bands (aubio_filterbank_t * fb,
const fvec_t * freqs, smpl_t samplerate);
/** filterbank initialization for Mel filters using Slaney's coefficients
\param fb filterbank object
\param samplerate audio sampling rate, in Hz
The filter coefficients are built to match exactly Malcolm Slaney's Auditory
Toolbox implementation (see file mfcc.m). The number of filters should be 40.
References
----------
Malcolm Slaney, *Auditory Toolbox Version 2, Technical Report #1998-010*
https://engineering.purdue.edu/~malcolm/interval/1998-010/
*/
uint_t aubio_filterbank_set_mel_coeffs_slaney (aubio_filterbank_t * fb,
smpl_t samplerate);
/** Mel filterbank initialization
\param fb filterbank object
\param samplerate audio sampling rate
\param fmin start frequency, in Hz
\param fmax end frequency, in Hz
The filterbank will be initialized with bands linearly spaced in the mel
scale, from `fmin` to `fmax`.
References
----------
Malcolm Slaney, *Auditory Toolbox Version 2, Technical Report #1998-010*
https://engineering.purdue.edu/~malcolm/interval/1998-010/
*/
uint_t aubio_filterbank_set_mel_coeffs(aubio_filterbank_t * fb,
smpl_t samplerate, smpl_t fmin, smpl_t fmax);
/** Mel filterbank initialization
\param fb filterbank object
\param samplerate audio sampling rate
\param fmin start frequency, in Hz
\param fmax end frequency, in Hz
The bank of filters will be initalized to to cover linearly spaced bands in
the Htk mel scale, from `fmin` to `fmax`.
References
----------
Douglas O'Shaughnessy (1987). *Speech communication: human and machine*.
Addison-Wesley. p. 150. ISBN 978-0-201-16520-3.
HTK Speech Recognition Toolkit: http://htk.eng.cam.ac.uk/
*/
uint_t aubio_filterbank_set_mel_coeffs_htk(aubio_filterbank_t * fb,
smpl_t samplerate, smpl_t fmin, smpl_t fmax);
#ifdef __cplusplus
}
#endif
#endif /* AUBIO_FILTERBANK_MEL_H */