nzilbb.labbcat (version 1.3-0)

countMatchingAnnotations: Gets the number of annotations matching a particular pattern.

Description

Returns the number of annotations in the corpus that match the given expression.

Usage

countMatchingAnnotations(labbcat.url, expression)

Value

The number of annotations that match the expression.

Arguments

labbcat.url

URL to the LaBB-CAT instance

expression

An expression that determines which annotations match. This must match by either id or layer.id. The expression language is currently not well defined, but is based on JavaScript syntax. e.g.

• id == 'ew_0_456'

• ['ew_2_456', 'ew_2_789', 'ew_2_101112'].includes(id)

• layerId == 'orthography' && !/th[aeiou].+/.test(label)

• graph.id == 'AdaAicheson-01.trs' && layer.id == 'orthography' && start.offset > 10.5

• layer.id == 'utterance' && all('word').includes('ew_0_456')

• layerId = 'utterance' && labels('orthography').includes('foo')

• layerId = 'utterance' && labels('participant').includes('Ada')

See Also

getMatchingAnnotations

Examples

if (FALSE) {
## define the LaBB-CAT URL
labbcat.url <- "https://labbcat.canterbury.ac.nz/demo/"

## count the number of topic tags that include the word 'quake'
countMatchingAnnotations(labbcat.url, "layer.id == 'topic' && /.*quake.*/.test(label)")
}