

   MMoossaaiicc PPlloottss

        mosaicplot(x, main = NA, sort = NA, off = NA, dir = NA, color = FALSE)

   AArrgguummeennttss::

          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.

       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 alter-
             nating 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.

   DDeessccrriippttiioonn::

        Plots a mosaic on the current graphics device.

   DDeettaaiillss::

        See Emerson (1998) for more information and a case
        study with television viewer data from Nielsen Media
        Research.

   AAuutthhoorr((ss))::

        S-PLUS original by John Emerson emerson@stat.yale.edu.
        Slightly modified for R by KH.

   RReeffeerreenncceess::

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

        The home page of Michael Friendly (<URL: http://hot-
        spur.psych.yorku.ca/SCS/friendly.html>) provides infor-
        mation on various aspects of graphical methods for ana-
        lyzing categorical data, including mosaic plots.

   EExxaammpplleess::

        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)

