snake: Snake

In soundgen: Sound Synthesis and Acoustic Analysis

Snake

Description

Internal soundgen function.

Usage

snake(
  pitch,
  pitchCands,
  pitchCert,
  certWeight,
  pitchCenterGravity,
  snakeStep = 0.05,
  snakePlot = FALSE
)

Arguments

pitch	numeric vector representing our best guess at pitch contour, which we are now attempting to improve by minimizing its elastic tension
pitchCands	a matrix of multiple pitch candidates per fft frame. Each column is one fft frame, each row is one candidate (the last row is always "manual")
pitchCert	a matrix of the same dimensionality as pitchCands specifying our certainty in pitch candidates
certWeight	(0 to 1) in pitch postprocessing, specifies how much we prioritize the certainty of pitch candidates vs. pitch jumps / the internal tension of the resulting pitch curve
pitchCenterGravity	numeric vector giving the mean of all pitch candidates per fft frame weighted by our certainty in each of these candidates
snakeStep	optimized path through pitch candidates is further processed to minimize the elastic force acting on pitch contour. To disable, set snakeStep = 0
snakePlot	if TRUE, plots the snake

Details

Internal helper function for postprocessing of pitch contour. Wiggles a snake along the gradient of internal + external forces. NB: if the snake is run, the final contour may deviate from the actually measured pitch candidates!

Value

Returns optimized pitch contour (numeric vector of the same length as pitch).

soundgen documentation built on Sept. 12, 2024, 6:29 a.m.