vcd: panel_pairs_diagonal – R documentation

Pricing

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

Get Started for Free

Documentation

vcd

panel_pairs_diagonal

Diagonal Panel Functions for Table Pairs Plot

Description

Diagonal panel functions for pairs.table.

Usage

pairs_barplot(gp_bars = NULL,
  gp_vartext = gpar(fontsize = 17),
  gp_leveltext = gpar(),
  gp_axis = gpar(),
  just_leveltext = c("center", "bottom"),
  just_vartext = c("center", "top"),
  rot = 0, abbreviate = FALSE, check_overlap = TRUE, fill = "grey",
  var_offset = unit(1, "npc"), ...)
pairs_text(dimnames = TRUE, gp_vartext = gpar(fontsize = 17), 
  gp_leveltext = gpar(), gp_border = gpar(), ...) 
pairs_diagonal_text(varnames = TRUE, gp_vartext = gpar(fontsize = 17, fontface = "bold"),
  gp_leveltext = gpar(), gp_border = gpar(), pos = c("right","top"),
  distribute = c("equal","margin"), rot = 0, ...)
pairs_diagonal_mosaic(split_vertical = TRUE, margins = unit(0, "lines"),
  offset_labels = -0.4, offset_varnames = 0,
  gp = NULL, fill = "grey", labeling = labeling_values, alternate_labels = TRUE, ...)

Arguments

`dimnames`	vector of logicals indicating whether the factor levels should be displayed (only used for `pairs_text`).
`varnames`	vector of logicals indicating whether the variable names should be displayed (only used for `pairs_text_diagonal`).
`gp_bars`	object of class `"gpar"` used for bars (only used for `pairs_barplot`). If unspecified, the default is to set the `fill` component of this object to the `fill` argument.
`gp_vartext`	object of class `"gpar"` used for the factor names.
`gp_leveltext`	object of class `"gpar"` used for the factor levels.
`gp_axis`	object of class `"gpar"` used for the y axis.
`gp_border`	object of class `"gpar"` used for the border (only used for `pairs_text`).
`gp`	object of class `"gpar"` used for the tiles (only used for `pairs_diagonal_mosaic`). If unspecified, the default is to set the `fill` component of this object to the `fill` argument.
`fill`	color vector or palette function used for the fill colors of bars (for `pairs_barplot`) or tiles (for `pairs_diagonal_mosaic`).
`labeling`	labeling function, passed to `mosaic()`
`alternate_labels`	should labels alternate top/bottom?
`just_leveltext, just_vartext`	character string indicating the justification for variable names and levels.
`pos`	character string of length 2 controlling the horizontal and vertical position of the variable names (only used for `pairs_text_diagonal`).
`rot`	rotation angle for the variable levels.
`distribute`	character string indicating whether levels should be distributed equally or according to the margins (only used for `pairs_text_diagonal`).
`abbreviate`	integer or logical indicating the number of characters the labels should be abbreviated to. `TRUE` means 1 character, `FALSE` causes no abbreviation.
`check_overlap`	If `TRUE`, some levels will suppressed to avoid overlapping, if any.
`split_vertical`	vector of logicals of length k, where k is the number of margins of `x` (values are recycled as needed). A `TRUE` component indicates that the tile(s) of the corresponding dimension should be split vertically, `FALSE` means horizontal splits. Default is `FALSE.`
`margins`	either an object of class `"unit"` of length 4, or a numeric vector of length 4. The elements are recycled as needed. The four components specify the top, right, bottom, and left margin of the plot, respectively. When a numeric vector is supplied, the numbers are interpreted as `"lines"` units. In addition, the unit or numeric vector may have named arguments (top, right, bottom, and left), in which case the non-named arguments specify the default values (recycled as needed), overloaded by the named arguments.
`offset_labels, offset_varnames`	numeric vector of length 4 indicating the offset of the labels (variable names) for each of the four sides of the plot.
`var_offset`	object of class `"unit"` specifying the offset of variable names from the bottom of the bar plots created by `pairs_barplot`. If numeric, the unit defaults to "npc".
`...`	other parameters passed to the underlying graphics functions.

Details

In the diagonal cells, the pairsplot visualizes statistics or information for each dimension (that is: the single factors) alone. pairs_text displays the factor's name, and optionally also the factor levels. pairs_barplot produces a bar plot of the corresponding factor, along with the factor's name.

Value

A function with one argument: the marginal table for the corresponding dimension.

Author(s)

David Meyer David.Meyer@R-project.org

Examples

data("UCBAdmissions")

pairs(UCBAdmissions) # pairs_barplot is default
pairs(UCBAdmissions, diag_panel = pairs_text)

pairs(UCBAdmissions, diag_panel = pairs_diagonal_text)
pairs(Titanic, diag_panel = pairs_diagonal_text)
pairs(Titanic, diag_panel = pairs_diagonal_text(distribute = "margin"))
pairs(Titanic,
      diag_panel = pairs_diagonal_text(distribute = "margin", rot = 45))

vcd

Visualizing Categorical Data

v1.4-10

GPL-2

Authors

David Meyer [aut, cre], Achim Zeileis [aut] (<https://orcid.org/0000-0003-0918-3766>), Kurt Hornik [aut], Florian Gerber [ctb], Michael Friendly [ctb]

Initial release