structable

0th

Percentile

Structured Contingency Tables

This function produces a flat representation of a high-dimensional contingency table constructed by recursive splits (similar to the construction of mosaic displays).

Keywords
hplot
Usage
## S3 method for class 'formula':
structable(formula, data,
direction = NULL, split_vertical = FALSE, \dots, subset, na.action)
## S3 method for class 'default':
structable(\dots, direction = NULL, split_vertical = FALSE)
Arguments
formula
a formula object with possibly both left and right hand sides specifying the column and row variables of the flat table.
data
a data frame, list or environment containing the variables to be cross-tabulated, or a contingency table.
subset
an optional vector specifying a subset of observations to be used. Ignored if data is a contingency table.
na.action
a function which indicates what should happen when the data contain NAs. Ignored if data is a contingency table
...
Robjects which can be interpreted as factors (including character strings), or a list (or data frame) whose components can be so interpreted, or a contingency table object of class "table" or "ftable".
split_vertical
logical vector indicating, for each dimension, whether it should be split vertically or not. Values are recycled as needed. If the argument is of length 1, the value is alternated for all dimensions. (Ignored if direction is
direction
character vector alternatively specifying the splitting direction ("h" for horizontal and "v" for vertical splits). Values are recycled as needed. If the argument is of length 1, the value is alternated for all dime
Details

This function produces textual representations of mosaic displays, and thus flat contingency tables. The formula interface is quite similar to the one of ftable, but also accepts the mosaic-like formula interface (empty left-hand side). Note that even if the ftable interface is used, the split_vertical or direction argument is needed to specify the order of the horizontal and vertical splits. If pretabulated data with a Freq column is used, than the left-hand side should be left empty---the Freq column will be handled correctly.

Value

  • An object inheriting from class "ftable" with the splitting information ("split_vertical") as additional attribute.

See Also

strucplot, mosaic, ftable

Aliases
  • structable.default
  • structable.formula
  • structable
Examples
structable(Titanic)
structable(Titanic, split_vertical = c(TRUE, TRUE, FALSE, FALSE))
structable(Titanic, direction = c("h","h","v","v"))
structable(Sex + Class ~ Survived + Age, data = Titanic)
Documentation reproduced from package vcd, version 0.9-0, License: GPL

Community examples

Looks like there are no examples yet.