polmineR (version 0.7.11)

partition_class: Partition class and methods.

Description

The partition class is used to manage subcorpora. It is an S4 class, and a set of methods is defined for the class. The class inherits from the classes count and textstat.

Usage

# S4 method for partition
summary(object)
# S4 method for partition
p_attributes(.Object, p_attribute = NULL, ...)
# S4 method for partition
split(x, gap, ...)
is.partition(x)
# S4 method for partition
$(x, name)
# S4 method for partition,ANY
==(e1, e2)
# S4 method for partition,ANY
!=(e1, e2)
# S4 method for partition
%in%(x, table)
# S4 method for partition
zoom(x, ...)
# S4 method for partition
enrich(.Object, p_attribute = NULL,
  decode = TRUE, verbose = TRUE, mc = FALSE, ...)
# S4 method for partition
as.regions(x)

Arguments

object

A partition object.

.Object

A partition object.

p_attribute

a p-attribute (for enriching) / performing count.

...

further parameters passed into count when calling enrich, and ...

x

A partition object.

gap

An integer value specifying the minimum gap between regions for performing the split.

name

An s-attribute that will be assigned as key to a partition.

e1

A first expression, a partition object in this case.

e2

A second expression, the value of an s-attribute.

table

Values a s-attribute shall assume.

decode

logical value, whether to decode token ids into strings when performing count

verbose

logical value, whether to output messages

mc

logical or, if numeric, providing the number of cores

Slots

name

A name to identify the object (character vector with length 1); useful when multiple partition objects are combined to a partition_bundle.

corpus

The CWB indexed corpus the partition is derived from (character vector with length 1).

encoding

Encoding of the corpus (character vector with length 1).

s_attributes

A named list with the s-attributes specifying the partition.

explanation

Object of class character, an explanation of the partition.

cpos

A matrix with left and right corpus positions defining regions (two columns).

annotations

Object of class list.

size

Total size of the partition (integer vector, length 1).

stat

An (optional) data.table with counts. If present, speeds up computation of cooccurrences, as count is already present.

metadata

Object of class data.frame, metadata information.

strucs

Object of class intger, the strucs defining the partition.

p_attribute

Object of class character indicating the p_attribute of the count in slot stat.

xml

Object of class character, whether the xml is flat or nested.

s_attribute_strucs

Object of class character the base node

key

Experimental, an s-attribute that is used as a key.

call

Object of class character the call that generated the partition

Details

As partition objects inherit from count and textstat class, methods available are view to inspect the table in the stat slot, name and name<- to retrieve/set the name of an object, and more.

The p_attributes-method returns the p-attributes defined for the corpus the partition is derived from, if argument p_attribute is NULL (the default). If p_attribute is defined, the unique values for the p-attribute are returned.

The split-method will split a partition object into a partition_bundle if gap between strucs exceeds a minimum number of tokens specified by gap. Relevant to split up a plenary protocol# into speeches. Note: To speed things up, the returned partitions will not include frequency lists. The lists can be prepared by applying enrich on the partition_bundle object that is returned.

The is.partition function returns a logical value whether x is a partition, or not.

The `$`-method will assign the argument name to the slot key and return the modified object.

The enrich-method will add a count of tokens defined by argument p_attribute to slot stat of the partition object.

See Also

The partition-class inherits from the textstat-class, see respective documentation to learn more.

Examples

# NOT RUN {
m <- partition("GERMAPARLMINI", speaker = "Merkel", regex = TRUE)
m2 <- m$speaker
m2@key
m <- partition("GERMAPARLMINI", speaker = "Merkel", regex = TRUE)
m$date == "2009-10-28"
s <- partition("GERMAPARLMINI", interjection = "speech")
s$party != "NA"
s <- partition("GERMAPARLMINI", interjection = "speech")
s$date %in% c("2009-10-27", "2009-10-28")
m <- partition("GERMAPARLMINI", speaker = "Merkel", regex = TRUE)
y <- zoom(m, date == "2009-10-28")

speeches <- partition("GERMAPARLMINI", interjection = "speech")
m <- zoom(speeches, date == "2009-10-28" & speaker == "Angela Dorothea Merkel")

not_unknown <- zoom(speeches, party != c("NA", "FDP"))
s_attributes(not_unknown, "party")
# }