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

View source: R/countMatchingAnnotations.R

countMatchingAnnotationsR Documentation

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)

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

Value

The number of annotations that match the expression.

See Also

getMatchingAnnotations

Examples

## Not run: 
## 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)")

## End(Not run)


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