nzilbb.labbcat (version 1.5-1)

fragmentLabels: Gets annotations in fragments.

Description

This is a version of getFragmentAnnotations that can have a dataframe of matches piped into it.

Usage

fragmentLabels(
  matches,
  layer.ids,
  sep = " ",
  partial.containment = FALSE,
  no.progress = FALSE,
  start.column = Line,
  end.column = LineEnd,
  labbcat.url = NULL,
  column.prefix = NULL
)

Value

matches with the acoustic measurements appended as new columns.

Arguments

matches

A dataframe returned by getMatches or getAllUtterances, identifying the results to which acoustic measurments should be appended.

layer.ids

A vector of layer IDs.

sep

The separator to use when concatenating labels when multiple annotations are in the given interval.

partial.containment

Whether to include annotations that are only partially contained in the given interval.

no.progress

TRUE to suppress visual progress bar. Otherwise, progress bar will be shown when interactive().

start.column

The column of matches containing the start time in seconds.

end.column

The column of matches containing the end time in seconds.

labbcat.url

URL to the LaBB-CAT instance (instead of inferring it from matches).

column.prefix

A string to prefix each new column name with.

Details

It gets annotations between given start/end times on given layers. If more than one annotation matches, labels are concatentated together.

See Also

• processWithPraat

• getMatches

Other Praat-related functions: appendFromPraat(), fragmentTranscripts(), praatScriptCentreOfGravity(), praatScriptFastTrack(), praatScriptFormants(), praatScriptIntensity(), praatScriptPitch(), processWithPraat()

Examples

if (FALSE) {
## Get all tokens of /I/
results <- getMatches(labbcat.url, list(topic = ".*quake.*")) |>
    fragmentLabels( ## concatenate labels of words between topic.start and topic.end
       c("word"), start.column=topic.start, end.column=topic.end)
}