nzilbb.labbcat (version 1.5-1)

fragmentData: Gets binary annotation data in fragments.

Description

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

Usage

fragmentData(
  matches,
  layer.id,
  path = "",
  no.progress = FALSE,
  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.id

The ID of the MIME-typed layer.

path

Optional path to directory where the files should be saved.

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

Details

In some annotation layers, the annotations have not only a textual label, but also binary data associated with it; e.g. an image or a data file. In these cases, the 'type' of the layer is a MIME type, e.g. 'image/png'. This function gets annotations between given start/end times on the given MIME-typed layer, and retrieves the binary data as files, whose names are returned by the function.

See Also

• processWithPraat

• getMatches

Examples

if (FALSE) {
## Get all tokens of "vivid"
vivid.tokens <- getMatches(labbcat.url, "vivid")
## Get mediapipe image annotations for during the tokens
vivid.faces <- vivid.tokens |>
    fragmentData(
        "mediapipe", path = "png",
        start.column=Target.word.start, end.column=Target.word.end)
}