ksvF0: ksvF0
In wrassp: Interface to the 'ASSP' Library

ksvF0

R Documentation

ksvF0

Description

ksvF0 function adapted from libassp

Usage

ksvF0(
  listOfFiles = NULL,
  optLogFilePath = NULL,
  beginTime = 0,
  endTime = 0,
  windowShift = 5,
  gender = "u",
  maxF = 600,
  minF = 50,
  minAmp = 50,
  maxZCR = 3000,
  toFile = TRUE,
  explicitExt = NULL,
  outputDirectory = NULL,
  forceToLog = useWrasspLogger,
  verbose = TRUE
)

Arguments

`listOfFiles`	vector of file paths to be processed by function
`optLogFilePath`	path to option log file
`beginTime`	= <time>: set begin of analysis interval to <time> seconds (default = 0: begin of data)
`endTime`	set end of analysis interval to <time> seconds (default = 0: end of data)
`windowShift`	= <dur>: set frame shift to <dur> ms (default: 5.0)
`gender`	= <code> set gender-specific F0 ranges; <code> may be: "f[emale]" (80.0 - 640.0 Hz) "m[ale]" (50.0 - 400.0 Hz) "u[nknown]" (default; 50.0 - 600.0 Hz)
`maxF`	= <freq>: set maximum F0 value to <freq> Hz (default: 500.0)
`minF`	= <freq>: set minimum F0 value to <freq> Hz (default: 50.0)
`minAmp`	= <amp>: set amplitude threshold for voiced samples to <amp> (default: 100)
`maxZCR`	maximum zero crossing rate in Hz (for voicing detection)
`toFile`	write results to file (default extension is .f0)
`explicitExt`	set if you wish to override the default extension
`outputDirectory`	directory in which output files are stored. Defaults to NULL, i.e. the directory of the input files
`forceToLog`	is set by the global package variable useWrasspLogger. This is set to FALSE by default and should be set to TRUE is logging is desired.
`verbose`	display infos & show progress bar

Details

F0 analysis of the signal in <listOfFiles> using the K. Schaefer-Vincent periodicity detection algorithm. Analysis results will be written to a file with the base name of the input file and extension '.f0'. Default output is in SSFF binary format (track 'F0'). Optionally, location and type of the signal extrema on which the F0 data are based, may be stored in a label file. The name of this file will consist of the base name of the F0 file and the extension '.prd'.

Value

nrOfProcessedFiles or if only one file to process return AsspDataObj of that file

Author(s)

Raphael Winkelmann

Lasse Bombien

References

Schaefer-Vincent K (1983) Pitch period detection and chaining: method and evaluation. Phonetica 1983, Vol 40, pp. 177-202

Examples

# get path to audio file
path2wav <- list.files(system.file("extdata", package = "wrassp"), 
                       pattern = glob2rx("*.wav"), 
                       full.names = TRUE)[1]

# calculate fundamental frequency contour
res <- ksvF0(path2wav, toFile=FALSE)

# plot the fundamental frequency contour
plot(seq(0,numRecs.AsspDataObj(res) - 1) / rate.AsspDataObj(res) +
       attr(res, 'startTime'),
     res$F0, 
     type='l', 
     xlab='time (s)', 
     ylab='F0 frequency (Hz)')

wrassp documentation built on May 29, 2024, 2:39 a.m.