tile: Tile Plot

In vcd: Visualizing Categorical Data

Tile Plot

Description

Plots a tile display.

Usage

## Default S3 method:
tile(x,
         tile_type = c("area", "squaredarea", "height", "width"),
         halign = c("left", "center", "right"),
         valign = c("bottom", "center", "top"),
         split_vertical = NULL,
         shade = FALSE,
         spacing = spacing_equal(unit(1, "lines")),
         set_labels = NULL,
         margins = unit(3, "lines"),
         keep_aspect_ratio = FALSE,
         legend = NULL,
         legend_width = NULL,
         squared_tiles = TRUE,
         main = NULL, sub = NULL, ...)
## S3 method for class 'formula'
tile(formula, data,
  ..., main = NULL, sub = NULL, subset = NULL, na.action = NULL)

Arguments

x	a contingency table, or an object coercible to one.
formula	a formula specifying the variables used to create a contingency table from data

.

data	either a data frame, or an object of class "table" or "ftable".
subset	an optional vector specifying a subset of observations to be used.
na.action	a function which indicates what should happen when the data contain NAs. Ignored if data is a contingency table.
tile_type	character string indicating how the tiles should reflect the table frequencies (see details).
halign, valign	character string specifying the horizontal and vertical alignment of the tiles.
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.
spacing	spacing object, spacing function, or corresponding generating function (see strucplot for more information).
set_labels	An optional character vector with named components replacing the so-specified variable names. The component names must exactly match the variable names to be replaced.
shade	logical specifying whether shading should be enabled or not (see strucplot).
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.
legend	either a legend-generating function, or a legend function (see details and legends), or a logical. If legend is NULL or TRUE and gp is a function or missing, legend defaults to legend_resbased.
legend_width	An object of class "unit" of length 1 specifying the width of the legend (if any). Default: 5 lines.
keep_aspect_ratio	logical indicating whether the aspect ratio should be fixed or not. The default is FALSE to enable the creation of squared tiles.
squared_tiles	logical indicating whether white space should be added as needed to rows or columns to obtain squared tiles in case of an unequal number of row and column labels.
main, sub	either a logical, or a character string used for plotting the main (sub) title. If logical and TRUE, the name of the data object is used.
...	Other arguments passed to strucplot

Details

A tile plot is a matrix of tiles. For each tile, either the "width", "height", "area", or squared area is proportional to the corresponding entry. The first three options allow column-wise, row-wise and overall comparisons, respectively. The last variant allows to compare the tiles both column-wise and row-wise, considering either the width or the height, respectively.

In contrast to other high-level strucplot functions, tile also accepts a table with duplicated levels (see examples). In this case, artificial dimnames will be created, and the actual ones are drawn using set_labels.

Note that multiway-tables are first “flattened” using structable.

Value

The "structable" visualized is returned invisibly.

Author(s)

David Meyer [e-mail]

See Also

assoc, strucplot, mosaic, structable,

Examples

data("Titanic")

## default plot
tile(Titanic)
tile(Titanic, type = "expected")
tile(Titanic, shade = TRUE)

## some variations
tile(Titanic, tile_type = "squaredarea")
tile(Titanic, tile_type = "width", squared_tiles = FALSE)
tile(Titanic, tile_type = "height", squared_tiles = FALSE)
tile(Titanic, tile_type = "area", halign = "center", valign = "center")

## repeat levels
tile(Titanic[,,,c(1,2,1,2)])

vcd documentation built on Sept. 17, 2024, 1:08 a.m.