Get or set global options affecting functions across quanteda.

quanteda_options(..., reset = FALSE, initialize = FALSE)



options to be set, as key-value pair, same as options. This may be a list of valid key-value pairs, useful for setting a group of options at once (see examples).


logical; if TRUE, reset all quanteda options to their default values


logical; if TRUE, reset only the quanteda options that are not already defined. Used for setting initial values when some have been defined previously, such as in `.Rprofile`.


When called using a key = value pair (where key can be a label or quoted character name)), the option is set and TRUE is returned invisibly.

When called with no arguments, a named list of the package options is returned.

When called with reset = TRUE as an argument, all arguments are options are reset to their default values, and TRUE is returned invisibly.


Currently available options are:


logical; if TRUE then use this as the default for all functions with a verbose argument


integer; specifies the number of threads to use in parallelized functions


integer; specifies the number of documents to display when using the defaults for printing a dfm


integer; specifies the number of features to display when using the defaults for printing a dfm


character; stem name for documents that are unnamed when a corpus, tokens, or dfm are created or when a dfm is converted from another object


character; stem name for features that are unnamed when they are added, for whatever reason, to a dfm through an operation that adds features


character; stem name for components that are created by matrix factorization


character; language option for char_wordstem, tokens_wordstem, and dfm_wordstem


(opt <- quanteda_options())
#> $threads #> [1] 2 #> #> $verbose #> [1] FALSE #> #> $print_dfm_max_ndoc #> [1] 20 #> #> $print_dfm_max_nfeat #> [1] 20 #> #> $base_docname #> [1] "text" #> #> $base_featname #> [1] "feat" #> #> $base_compname #> [1] "comp" #> #> $language_stemmer #> [1] "english" #>
quanteda_options(verbose = TRUE) quanteda_options("verbose" = FALSE) quanteda_options("threads")
#> [1] 2
quanteda_options(print_dfm_max_ndoc = 50L) # reset to defaults quanteda_options(reset = TRUE) # reset to saved options quanteda_options(opt)