This help topic is for R version 0.90. For the current version of R, try https://stat.ethz.ch/R-manual/R-patched/library/base/html/mosaicplot.html
mosaicplot {base}R Documentation

Mosaic Plots

Usage

mosaicplot(x, ...)
mosaicplot.default(X, main = NULL, xlab = NULL, ylab = NULL,
                   sort = NULL, off = NULL, dir = NULL,
                   color = FALSE)
mosaicplot.formula(formula, data = NULL, subset, na.action, ...)

Arguments

x

an R object.

X

a contingency table, with optional category labels specified in the dimnames(x) attribute. The table is best created by the table() command, which produces an object of type array.

main

character string for the mosaic title.

xlab, ylab

x- and y-axis labels; by default, names(dimnames(X)).

sort

vector ordering of the variables, containing a permutation of the integers 1:length(dim(x)) (the default).

off

vector of offsets to determine percentage spacing at each level of the mosaic (appropriate values are between 0 and 20, and the default is 10 at each level). There should be one offset for each dimension of the contingency table.

dir

vector of split directions ("v" for vertical and "h" for horizontal) for each level of the mosaic, one direction for each dimension of the contingency table. The default consists of alternating directions, beginning with a vertical split.

color

(TRUE or vector of integer colors) for color shading or (FALSE, the default) for empty boxes with no shading.

formula

a formula, such as y ~ x. \itemdataa data.frame (or list) from which the variables in formula should be taken. \itemsubsetan optional vector specifying a subset of observations to be used in the fitting process. \itemna.actiona function which indicates what should happen when the data contain NAs. \item...further arguments to the default mosaicplot method.

Plots a mosaic on the current graphics device. This is a generic function. It currently has a default method (mosaicplot.default) and a formula interface (mosaicplot.formula).

See Emerson (1998) for more information and a case study with television viewer data from Nielsen Media Research. S-PLUS original by John Emerson emerson@stat.yale.edu. Slightly modified for R by KH. Hartigan, J.A., and Kleiner, B. (1984). A mosaic of television ratings. The American Statistician, 38, 32-35.

John W. Emerson (1998). Mosaic displays in S-PLUS: a general implementation and a case study. Statistical Computing and Graphics Newsletter (ASA), 9, 1, 17-23.

Friendly, M. (1994). Mosaic displays for multi-way contingency tables. Journal of the American Statistical Association, 89, 190-200.
The home page of Michael Friendly (http://hotspur.psych.yorku.ca/SCS/friendly.html) provides information on various aspects of graphical methods for analyzing categorical data, including mosaic plots. ## FIXME: Use interesting data!

## Artificial 4-way table Y <- table(trunc(3*runif(1000)), trunc(3*runif(1000)), trunc(5*runif(1000))-10, trunc(3*runif(1000))) dimnames(Y)[[2]] <- c("Cat", "Dog", "Horse") mosaicplot(Y, main = "Sample Mosaic", color = TRUE)

## FIXME: Provide an example for the formula interface

[Package base version 0.90 ]