panel_pairs_diagonal: Diagonal Panel Functions for Table Pairs Plot

In vcd: Visualizing Categorical Data

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 [e-mail]

See Also

pairs.table, pairs_assoc, pairs_mosaic

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 documentation built on Dec. 23, 2023, 3:02 a.m.