source: src/pitch/pitchyin.c @ 6a2478c

/*
  Copyright (C) 2003-2009 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/>.

*/

/* This algorithm was developped 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.  
 *
 * see http://recherche.ircam.fr/equipes/pcm/pub/people/cheveign.html
 */

#include "aubio_priv.h"
#include "fvec.h"
#include "mathutils.h"
#include "pitch/pitchyin.h"

struct _aubio_pitchyin_t {
  fvec_t * yin;
  smpl_t tol;
};

/** compute difference function
  
  \param input input signal 
  \param yinbuf output buffer to store difference function (half shorter than input)

*/
void aubio_pitchyin_diff(fvec_t * input, fvec_t * yinbuf);

/** in place computation of the YIN cumulative normalised function 
  
  \param yinbuf input signal (a square difference function), also used to store function 

*/
void aubio_pitchyin_getcum(fvec_t * yinbuf);

/** detect pitch in a YIN function
  
  \param yinbuf input buffer as computed by aubio_pitchyin_getcum

*/
uint_t aubio_pitchyin_getpitch(fvec_t *yinbuf);

aubio_pitchyin_t * new_aubio_pitchyin (uint_t bufsize) {
  aubio_pitchyin_t * o = AUBIO_NEW(aubio_pitchyin_t);
  o->yin = new_fvec (bufsize/2, 1);
  o->tol = 0.15;
  return o;
}

void del_aubio_pitchyin (aubio_pitchyin_t *o) {
  del_fvec(o->yin);
  AUBIO_FREE(o);
}

/* outputs the difference function */
void aubio_pitchyin_diff(fvec_t * input, fvec_t * yin){
  uint_t c,j,tau;
  smpl_t tmp;
  for (c=0;c<input->channels;c++)
  {
    for (tau=0;tau<yin->length;tau++)
    {
      yin->data[c][tau] = 0.;
    }
    for (tau=1;tau<yin->length;tau++)
    {
      for (j=0;j<yin->length;j++)
      {
        tmp = input->data[c][j] - input->data[c][j+tau];
        yin->data[c][tau] += SQR(tmp);
      }
    }
  }
}

/* cumulative mean normalized difference function */
void aubio_pitchyin_getcum(fvec_t * yin) {
  uint_t c,tau;
  smpl_t tmp;
  for (c=0;c<yin->channels;c++)
  {
    tmp = 0.;
    yin->data[c][0] = 1.;
    //AUBIO_DBG("%f\t",yin->data[c][0]);
    for (tau=1;tau<yin->length;tau++)
    {
      tmp += yin->data[c][tau];
      yin->data[c][tau] *= tau/tmp;
      //AUBIO_DBG("%f\t",yin->data[c][tau]);
    }
    //AUBIO_DBG("\n");
  }
}

uint_t aubio_pitchyin_getpitch(fvec_t * yin) {
  uint_t c=0,tau=1;
  do 
  {
    if(yin->data[c][tau] < 0.1) { 
      while (yin->data[c][tau+1] < yin->data[c][tau]) {
        tau++;
      }
      return tau;
    }
    tau++;
  } while (tau<yin->length);
  //AUBIO_DBG("No pitch found");
  return 0;
}


/* all the above in one */
void aubio_pitchyin_do(aubio_pitchyin_t *o, fvec_t * input, fvec_t * out){
  smpl_t tol = o->tol;
  fvec_t * yin = o->yin;
  uint_t c , j,tau = 0;
  sint_t period;
  smpl_t tmp = 0., tmp2 = 0.;
  for (c = 0; c < input->channels; c++) {
    yin->data[c][0] = 1.;
    for (tau=1;tau<yin->length;tau++)
    {
      yin->data[c][tau] = 0.;
      for (j=0;j<yin->length;j++)
      {
        tmp = input->data[c][j] - input->data[c][j+tau];
        yin->data[c][tau] += SQR(tmp);
      }
      tmp2 += yin->data[c][tau];
      yin->data[c][tau] *= tau/tmp2;
      period = tau-3;
      if(tau > 4 && (yin->data[c][period] < tol) && 
          (yin->data[c][period] < yin->data[c][period+1])) {
        out->data[c][0] = fvec_quadint(yin,period,c);
        goto beach;
      }
    }
    out->data[c][0] = fvec_quadint(yin,fvec_min_elem(yin),c);
beach:
    continue;
  }
  //return 0;
}

uint_t aubio_pitchyin_set_tolerance (aubio_pitchyin_t *o, smpl_t tol) {
  o->tol = tol;
  return 0;
}

smpl_t aubio_pitchyin_get_tolerance (aubio_pitchyin_t *o) {
  return o->tol;
}