cotab_panel {vcd} | R Documentation

## Panel-generating Functions for Contingency Table Coplots

### Description

Panel-generating functions visualizing contingency tables that can be passed to `cotabplot`.

### Usage

    cotab_mosaic(x = NULL, condvars = NULL, ...)
    cotab_assoc(x = NULL, condvars = NULL, ylim = NULL, ...)
    cotab_sieve(x = NULL, condvars = NULL, ...)
    cotab_fourfold(x = NULL, condvars = NULL, ...)
    cotab_coindep(x, condvars,
      test = c("max", "Chisq"), level = NULL, n = 1000,
      h = NULL, c = NULL, l = NULL, lty = 1,
      type = c("mosaic", "assoc"),
      legend = FALSE, ylim = NULL, ...)

### Arguments

`x` | an contingency tables in array form.
`condvars` | margin name(s) of the conditioning variables.
`ylim` | y-axis limits for `assoc` plot. By default this is computed from `x`.
`test` | character indicating which type of statistic should be used for assessing conditional independence.
`level,n,h,c,l,lty` | variables controlling the HCL shading of the residuals, see `shading_max` for more details.
`type` | character indicating which type of plot should be produced.
`legend` | logical. Should a legend be produced in each panel?
`...` | further arguments passed to the plotting function (such as `mosaic` or `assoc` or `sieve` respectively).

### Details

These functions of class `"panel_generator"` are panel-generating functions for use with `cotabplot`, i.e., they return functions with the interface

`panel(x, condlevels)`

required for `cotabplot`. The functions produced by `cotab_mosaic`, `cotab_assoc` and `cotab_sieve` essentially only call `co_table` to produce the conditioned table and then call `mosaic`, `assoc` or `sieve` respectively with the arguments specified.

The function `cotab_coindep` is similar but additionally chooses an appropriate residual-based shading visualizing the associated conditional independence model. The conditional independence test is carried out via `coindep_test` and the shading is set up via `shading_hcl`.

A description of the underlying ideas is given in Zeileis, Meyer, Hornik (2005).

### Author(s)

Achim Zeileis Achim.Zeileis@R-project.org

### References

Zeileis, A., Meyer, D., Hornik K. (2005), Residual-based shadings for visualizing (conditional) independence, Research Report, 20. http://epub.wu-wien.ac.at/

### See Also

`cotabplot`, `mosaic`, `assoc`, `sieve`, `co_table`, `coindep_test`, `shading_hcl`

### Examples

    data(UCBAdmissions)

    cotabplot(~ Admit + Gender | Dept, data = UCBAdmissions)
    cotabplot(~ Admit + Gender | Dept, data = UCBAdmissions, panel = cotab_assoc)
    cotabplot(~ Admit + Gender | Dept, data = UCBAdmissions, panel = cotab_fourfold)

    ucb <- cotab_coindep(UCBAdmissions, condvars = "Dept", type = "assoc", n = 5000, margins = c(3, 1, 1, 3))
    cotabplot(~ Admit + Gender | Dept, data = UCBAdmissions, panel = ucb)

[Package vcd version 0.9-6 Index]