tCorpus-cash-fold_rsyntax: Fold rsyntax annotations

In corpustools: Managing, Querying and Analyzing Tokenized Text

Fold rsyntax annotations

Description

If a tCorpus has rsyntax annotations (see annotate_rsyntax), it can be convenient to aggregate tokens that have a certain semantic label. For example, if you have a query for labeling "source" and "quote", you can add an aggegated value for the sources (such as a unique ID) as a column, and then remove the quote tokens.

Arguments

annotation	The name of an rsyntax annotation column
by_label	The labels in this column for which you want to aggregate the tokens
...	Specify the new aggregated columns in name-value pairs. The name is the name of the new column, and the value should be a function over a column in $tokens. For example: subject = paste(token, collapse = ' ') would create the column 'subject', of which the values are the concatenated tokens. See examples for more.
txt	If TRUE, add _txt column with concatenated tokens for by_label
rm_by	If TRUE (default), remove the column(s) specified in by_label
copy	If TRUE, return a copy of the transformed tCorpus, instead of transforming the tCorpus by reference

Details

Usage:

## R6 method for class tCorpus. Use as tc$method (where tc is a tCorpus object).

fold_rsyntax(annotation, by_label, ..., 
             to_label=NULL, rm_by=T, copy=F)

Examples

tc = tc_sotu_udpipe$copy()
tc$udpipe_clauses()

tc$fold_rsyntax('clause', by_label = 'subject', subject = paste(token, collapse=' '))
tc$tokens

corpustools documentation built on May 31, 2023, 8:45 p.m.