nzilbb.labbcat (version 1.5-1)

fragmentTranscripts: Gets transcript fragments in a given format.

Description

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

Usage

fragmentTranscripts(
  matches,
  layer.ids,
  mime.type = "text/praat-textgrid",
  path = "",
  start.column = Line,
  end.column = LineEnd,
  labbcat.url = 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.

mime.type

Optional content-type - "text/praat-textgrid" is the default, but your LaBB-CAT installation may support other formats, which can be discovered using getSerializerDescriptors.

path

Optional path to directory where the files should be saved.

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).

Details

It gets fragments of transcripts from LaBB-CAT, converted to a given file format (by default, Praat TextGrid).

NB Although many formats will generate exactly one file for each interval (e.g. mime.type=text/praat-textgrid), this is not guaranteed; some formats generate a single file or a fixed collection of files regardless of how many fragments there are.

See Also

• processWithPraat

• getMatches

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

Examples

if (FALSE) {
## Get all tokens of "the"
the.tokens <- getMatches(labbcat.url, "the")
## Get a TextGrid for each matched utterance, including word and segment intervals
the.textgrids <- the.tokens |> fragmentTranscripts(c("utterance", "word", "segment"))
## Get a CSV for the same utterances
the.textgrids <- the.tokens |> fragmentTranscripts(
    c("utterance", "word", "segment"), mime.type = "text/csv", path="csv")
}