expressionFromAttributeValues: Generates a query expression for matching a...

In nzilbb.labbcat: Accessing Data Stored in 'LaBB-CAT' Instances

Generates a query expression for matching a transcript/participant attribute, for use with getMatches.

Description

This function generates a query expression fragment which can be passed as the transcript.expression or participant.expression parameter of getMatches, (or the expression parameter of getMatchingTranscriptIds or getMatchingParticipantIds) using a list of possible values for a given transcript attribute.

Usage

expressionFromAttributeValues(transcript.attribute, values, not = FALSE)

Arguments

transcript.attribute	The transcript attribute to filter by.
values	A list of possible values for transcript.attribute.
not	Whether to match the given IDs (FALSE), or everything *except* the given IDs.

Details

The attribute defined by transcript.attribute is expected to have possibly more than one value. If it can have only one value, use expressionFromAttributeValue instead.

Value

A transcript query expression which can be passed as the transcript.expression parameter of getMatches or the expression parameter of getMatchingTranscriptIds

See Also

expressionFromAttributeValue

expressionFromTranscriptTypes

expressionFromIds

getMatches

Examples

## Not run: 
## define the LaBB-CAT URL
labbcat.url <- "https://labbcat.canterbury.ac.nz/demo/"

## Perform a search
languages <- c("en","es")
results <- getMatches(labbcat.url, list(segment="I"),
                      participant.expression = expressionFromAttributeValues(
                            "participant_languagesSpoken", languages))

## End(Not run)

nzilbb.labbcat documentation built on July 26, 2023, 6:08 p.m.