pathfinding_slow: Path through pitch candidates: slow

View source: R/utilities_pitch_postprocessing.R

pathfinding_slowR Documentation

Path through pitch candidates: slow

Description

Internal soundgen function.

Usage

pathfinding_slow(
  pitchCands = pitchCands,
  pitchCert = pitchCert,
  certWeight = certWeight,
  pitchCenterGravity = pitchCenterGravity,
  manual = NULL,
  annealPars = list(maxit = 5000, temp = 1000)
)

Arguments

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

manual

a dataframe of manual pitch candidates from pathfinder()

annealPars

a list of control parameters for postprocessing of pitch contour with SANN algorithm of optim. This is only relevant if pathfinding = 'slow'

Details

Optimizes the path through pitch candidates using simulated annealing with optim. This can be really slow, depending on control parameters.


soundgen documentation built on Aug. 14, 2022, 5:05 p.m.