polmineR (version 0.7.8)

count: Get counts.

Description

Count all tokens, or number of occurrences of a query (CQP syntax may be used), or matches for the query.

Usage

count(.Object, ...)
# S4 method for partition
count(.Object, query = NULL, cqp = is.cqp,
  breakdown = FALSE, decode = TRUE,
  pAttribute = getOption("polmineR.pAttribute"),
  mc = getOption("polmineR.cores"), verbose = TRUE, progress = FALSE)
# S4 method for partitionBundle
count(.Object, query, cqp = FALSE,
  pAttribute = NULL, freq = FALSE, total = TRUE, mc = FALSE,
  progress = TRUE, verbose = FALSE)
# S4 method for character
count(.Object, query = NULL, cqp = is.cqp,
  pAttribute = getOption("polmineR.pAttribute"), breakdown = FALSE,
  sort = FALSE, decode = TRUE, verbose = TRUE)
# S4 method for vector
count(.Object, corpus, pAttribute)
# S4 method for Corpus
count(.Object, query = NULL, pAttribute)

Arguments

.Object

a "partition" or "partitionBundle" object, or a character vector (length 1) providing the name of a corpus

...

further parameters

query

a character vector (one or multiple terms to be looked up), CQP syntax can be used.

cqp

either logical (TRUE if query is a CQP query), or a function to check whether query is a CQP query or not (defaults to is.query auxiliary function)

breakdown

logical, whether to count occurrences for different matches for a query

decode

logical, whether to add rownames (only if query is NULL)

pAttribute

the p-attribute(s) to use

mc

logical, whether to use multicore (defaults to FALSE)

verbose

logical, whether to be verbose

progress

logical, whether to show progress

freq

logical, if FALSE, counts will be reported, if TRUE, frequencies

total

defaults to FALSE, if TRUE, the added value of counts (column: TOTAL) will be amended to the data.table that is returned

sort

logical, whether to sort stat

corpus

name of CWB corpus

Value

a "data.table"

Details

If .Object is a partitonBundle, the data.table returned will have the queries in the columns, and as many rows as there are in the partitionBundle.

If .Object is a character vector (length 1) and query is NULL, the count is performed for the whole partition. If breakdown is TRUE and one query is supplied, the function returns a frequency breakdown of the results of the query. If several queries are supplied, frequencies for the individual queries are retrieved.

References

Baker, Paul (2006): Using Corpora in Discourse Analysis. London: continuum, p. 47-69 (ch. 3).

See Also

For a metadata-based breakdown of counts (i.e. tabulation by s-attributes), see "dispersion".

count

Examples

# NOT RUN {
  use("polmineR")
  debates <- partition("GERMAPARLMINI", date = ".*", regex=TRUE)
  count(debates, query = "Arbeit") # get frequencies for one token
  count(debates, c("Arbeit", "Freizeit", "Zukunft")) # get frequencies for multiple tokens
  
  count("GERMAPARLMINI", query = c("Migration", "Integration"), pAttribute = "word")

  debates <- partitionBundle(
    "GERMAPARLMINI", sAttribute = "date", values = NULL,
    regex = TRUE, mc = FALSE, verbose = FALSE
  )
  y <- count(debates, query = "Arbeit", pAttribute = "word")
  y <- count(debates, query = c("Arbeit", "Migration", "Zukunft"), pAttribute = "word")
  
  count("GERMAPARLMINI", '"Integration.*"', breakdown = TRUE)

  P <- partition("GERMAPARLMINI", date = "2009-11-11")
  count(P, '"Integration.*"', breakdown = TRUE)
# }