use: Add corpora in R data packages to session registry.

View source: R/use.R

useR Documentation

Add corpora in R data packages to session registry.


Use CWB indexed corpora in R data packages by adding registry file to session registry.


use(pkg, corpus, lib.loc = .libPaths(), tmp = FALSE, verbose = TRUE)



A package including at least one CWB indexed corpus.


A corpus (or corpora) to be loaded selectively.


A character vector with path names of R libraries.


A logical value, whether to use a temporary data directory.


Logical, whether to output status messages.


pkg is expected to be an installed data package that includes CWB indexed corpora. The use()-function will add the registry files describing the corpus (or the corpora) to the session registry directory and adjust the path pointing to the data in the package.

The registry files within the package are assumed to be in the subdirectory './extdata/cwb/registry' of the installed package. The data directories for corpora are assumed to be in a subdirectory named after the corpus (lower case) in the package subdirectory './extdata/cwb/indexed_corpora/'. When adding a corpus to the registry, templates for formatting fulltext output are reloaded.

If the path to the data directory in a package includes a non-ASCII character, binary data files of the corpora in package are copied to a subdirectory of the per-session temporary data directory.


A logical value: TRUE if corpus has been loaded successfully, or FALSE, if any kind of error occurred.

See Also

To get the temporary registry directory, see registry.



polmineR documentation built on March 31, 2023, 8:17 p.m.