koRpus (version 0.06-5)

kRp.text.analysis: Analyze texts using TreeTagger and word frequencies

Description

The function kRp.text.analysis analyzes texts in various ways.

Usage

kRp.text.analysis(txt.file, tagger = "kRp.env", force.lang = NULL, desc.stat = TRUE, lex.div = TRUE, corp.freq = NULL, corp.rm.class = "nonpunct", corp.rm.tag = c(), ...)

Arguments

txt.file

Either an object of class kRp.tagged-class, kRp.txt.freq-class, kRp.analysis-class or kRp.txt.trans-class, or a character vector which must be be a valid path to a file containing the text to be analyzed.

tagger

A character string defining the tokenizer/tagger command you want to use for basic text analysis. Can be omitted if txt.file is already of class kRp.tagged-class. Defaults to "kRp.env" to get the settings by get.kRp.env. Set to "tokenize" to use tokenize.

force.lang

A character string defining the language to be assumed for the text, by force.

desc.stat

Logical, whether a descriptive statistical analysis should be performed.

lex.div

Logical, whether some lexical diversity analysis should be performed, using lex.div.

corp.freq

An object of class kRp.corp.freq-class. If present, a frequency index for the analyzed text is computed (see details).

corp.rm.class

A character vector with word classes which should be ignored for frequency analysis. The default value "nonpunct" has special meaning and will cause the result of kRp.POS.tags(lang, c("punct","sentc"), list.classes=TRUE) to be used.

corp.rm.tag

A character vector with POS tags which should be ignored for frequency analysis.

...

Additional options to be passed through to the function defined with tagger.

Value

An object of class kRp.analysis-class.

Details

The function is basically a wrapper for treetag(), freq.analysis() and lex.div().

By default, if the text has to be tagged yet, the language definition is queried by calling get.kRp.env(lang=TRUE) internally. Or, if txt.file has already been tagged, by default the language definition of that tagged object is read and used. Set force.lang=get.kRp.env(lang=TRUE) or to any other valid value, if you want to forcibly overwrite this default behaviour, and only then. See kRp.POS.tags for all supported languages.

References

[1] http://www.ims.uni-stuttgart.de/projekte/corplex/TreeTagger/DecisionTreeTagger.html

See Also

set.kRp.env, get.kRp.env, kRp.POS.tags, lex.div

Examples

## Not run: 
# kRp.text.analysis("/some/text.txt")
# ## End(Not run)