koRpus (version 0.04-27)

query: A method to get information out of koRpus objects

Description

The method query returns query information from objects of classes kRp.corp.freq-class and kRp.tagged-class.

Arguments

obj

An object of class kRp.corp.freq-class.

var

A character string naming a variable in the object.

query

A character vector (for words) or single number naming values to be matched in the variable. Can be a vector of two numbers to query a range of frequency data.

rel

A character string defining the relation of the queried value and desired results. Must either be "eq" (equal, the default), "gt" (greater than), "ge" (greater of equal), "lt" (less than) or

Value

• Depending on the arguments, might include whole objects, lists, single values etc.

Details

kRp.corp.freq: Depending on the setting of the var parameter, will return entries with a matching character (var="word"), or all entries of the desired frequency (see the examples). A special case is the need for a range of frequencies, which can be achieved by providing a nomerical vector of two values as the query value, for start and end of the range, respectively. In these cases, if rel is set to "gt" or "lt", the given range borders are excluded, otherwise they will be included as true matches.

kRp.tagged: var can be any of the variables in slot TT.res. For rel currently only "eq" and "num" are implemented. The latter isn't a relation, but will return a vector with the row numbers in which the query was found.

This method calls subset, which might actually be even more flexible if you need more control.

See Also

kRp.corp.freq-class, subset

Examples

# look up frequencies for the word "aber"
query(LCC.data, var="word", query="aber")
# show all entries with a frequency of exactly 3000 in the corpus
query(LCC.data, "freq", 3000)
# now, which words appear more than 40000 times in a million?
query(LCC.data, "pmio", 40000, "gt")
# example for a range request: words with a log10 between 2 and 2.1
# (including these two values)
query(LCC.data, "log10", c(2, 2.1))
# (and without them)
query(LCC.data, "log10", c(2, 2.1), "gt")
# get all "he" lemmata in a previously tagged text object
query(tagged.txt, "lemma", "he")