ref: 89c44aa13a29d4ee59286d8847804e3adfba39f8
dir: /src/pitch/pitchyinfast.h/
/* Copyright (C) 2003-2017 Paul Brossier <piem@aubio.org> 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 Pitch detection using YIN algorithm (fast implementation) This algorithm was developed by A. de Cheveigne and H. Kawahara and published in: De Cheveigné, A., Kawahara, H. (2002) "YIN, a fundamental frequency estimator for speech and music", J. Acoust. Soc. Am. 111, 1917-1930. This implementation compute the autocorrelation function using time domain convolution computed in the spectral domain. see http://recherche.ircam.fr/equipes/pcm/pub/people/cheveign.html http://recherche.ircam.fr/equipes/pcm/cheveign/ps/2002_JASA_YIN_proof.pdf */ #ifndef AUBIO_PITCHYINFAST_H #define AUBIO_PITCHYINFAST_H #ifdef __cplusplus extern "C" { #endif /** pitch detection object */ typedef struct _aubio_pitchyinfast_t aubio_pitchyinfast_t; /** creation of the pitch detection object \param buf_size size of the input buffer to analyse */ aubio_pitchyinfast_t *new_aubio_pitchyinfast (uint_t buf_size); /** deletion of the pitch detection object \param o pitch detection object as returned by new_aubio_pitchyin() */ void del_aubio_pitchyinfast (aubio_pitchyinfast_t * o); /** execute pitch detection an input buffer \param o pitch detection object as returned by new_aubio_pitchyin() \param samples_in input signal vector (length as specified at creation time) \param cands_out pitch period candidates, in samples */ void aubio_pitchyinfast_do (aubio_pitchyinfast_t * o, const fvec_t * samples_in, fvec_t * cands_out); /** set tolerance parameter for YIN algorithm \param o YIN pitch detection object \param tol tolerance parameter for minima selection [default 0.15] */ uint_t aubio_pitchyinfast_set_tolerance (aubio_pitchyinfast_t * o, smpl_t tol); /** get tolerance parameter for YIN algorithm \param o YIN pitch detection object \return tolerance parameter for minima selection [default 0.15] */ smpl_t aubio_pitchyinfast_get_tolerance (aubio_pitchyinfast_t * o); /** get current confidence of YIN algorithm \param o YIN pitch detection object \return confidence parameter */ smpl_t aubio_pitchyinfast_get_confidence (aubio_pitchyinfast_t * o); #ifdef __cplusplus } #endif #endif /* AUBIO_PITCHYINFAST_H */