Skip to main content

pitchyin​

pitchyin(
    @framesize 2048
    @interpolate 1
    @maxfrequency 22050
    @minfrequency 20
    @samplerate 44100
    @tolerance 0.15
    @mode 0
) -> llll

Generates audio descriptor to estimate the fundamental frequency of a monophonic buffer. It is an implementation of the Yin algorithm for computations in the time domain. See analyze.

The resulting buffer will be updated with the following keys:

  • pitchyin
  • pitchyin_confidence
info

pitchyin is a mirror implementation of the same algorithm in the Essentia library. For more details on the algorithm, please check the Essentia Algorithms reference.

Arguments​

  • @framesize [int]: number of samples in the input frame. (default: 2048).
  • @interpolate [int]: enable interpolation. (default: 1).
    • 0: off
    • 1: on
  • @maxfrequency [int/float]: the maximum allowed frequency. (default: 22050).
  • @minfrequency [int/float]: the minimum allowed frequency. (default: 20).
  • @samplerate [int]: sampling rate of the input audio. (default: 44100).
  • @tolerance [int/float]: tolerance for peak detection. (default: 0.15).
  • @mode [int]: analysis mode. (default: 0).
    • 0: global
    • 1: time series
    • 2: time-tagged time series
    • 3: buffer

Output​

pitchyin descriptor [llll]

Usage​

pitchyin is meant to be used with the analyze function:

$buffer = importaudio('singing.wav'); ## input buffer
$descr = pitchyin(); ## generate pitchyin audio descriptor
$buffer.inspect('before analysis');
$buffer = $buffer.analyze($descr); ## apply analysis
$buffer.inspect('after analysis')