praatScriptIntensity.Rd
This function generates a Praat script fragment which can be passed as the praat.script parameter of processWithPraat, in order to extract maximum intensity value.
praatScriptIntensity(
minimum.pitch = 100,
time.step = 0,
subtract.mean = TRUE,
get.maximum = TRUE,
sample.points = NULL,
interpolation = "cubic",
skip.errors = TRUE
)
Minimum pitch (Hz).
Time step in seconds, or 0.0 for 'auto'.
Whether to subtract the mean or not.
Extract the maximum intensity for the sample.
A vector of numbers (0 <= sample.points <= 1) specifying multiple points at which to take the measurement. The default is NULL, meaning no individual measurements will be taken (only the aggregate values identified by get.mean, get.minimum, and get.maximum). A single point at 0.5 means one measurement will be taken halfway through the target interval. If, for example, you wanted eleven measurements evenly spaced throughout the interval, you would specify sample.points as being c(0.0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1.0).
If sample.points are specified, this is the interpolation to use when getting individual values. Possible values are 'nearest', 'linear', 'cubic', 'sinc70', or 'sinc700'.
Sometimes, for some segments, Praat fails to create an Intensity object. If skip.errors = TRUE, analysis those segments will be skipped, and corresponding pitch values will be returned as "--undefined--". If skip.errors = FALSE, the error message from Praat will be returned in the Error field, but no pitch measures will be returned for any segments in the same recording.
if (FALSE) {
## Perform a search
results <- getMatches(labbcat.url, list(segment="s"))
## Get max intensity, and intensity at three points during the segment, for all matches
intensity <- processWithPraat(
labbcat.url,
results$MatchId, results$Target.segment.start, results$Target.segment.end,
praatScriptIntensity(sample.points = c(.25, .5, .75)))
}