lattice (version 0.17-13)

panel.bwplot: Default Panel Function for bwplot

Description

This is the default panel function for bwplot.

Usage

panel.bwplot(x, y, box.ratio = 1,
             box.width = box.ratio / (1 + box.ratio),
             horizontal = TRUE,
             pch, col, alpha, cex, 
             font, fontfamily, fontface, 
             fill, varwidth = FALSE,
             ...,
             levels.fos,
             stats = boxplot.stats,
             coef = 1.5,
             do.out = TRUE)

Arguments

x, y

numeric vector or factor. Boxplots drawn for each unique value of y (x) if horizontal is TRUE (FALSE)

box.ratio

ratio of box thickness to inter box space

box.width

thickness of box in absolute units; overrides box.ratio. Useful for specifying thickness when the categorical variable is not a factor, as use of box.ratio alone cannot achieve a thickness greater than 1.

horizontal

logical. If FALSE, the plot is transposed in the sense that the behaviours of x and y are switched. x is now the factor. Interpretation of other arguments change accordingly. See documentation of

pch, col, alpha, cex, font, fontfamily, fontface

graphical parameters controlling the dot. pch="|" is treated specially, by replacing the dot with a line (similar to boxplot)

fill

color to fill the boxplot

varwidth

logical. If TRUE, widths of boxplots are proportional to the number of points used in creating it.

stats

a function, defaulting to boxplot.stats, that accepts a numeric vector and returns a list similar to the return value of boxplot.stats. The function must accept arguments

coef, do.out

passed to stats

levels.fos

numeric values corresponding to positions of the factor or shingle variable. For internal use.

...

further arguments, ignored.

Details

Creates Box and Whisker plot of x for every level of y (or the reverse if horizontal=FALSE). By default, the actual boxplot statistics are calculated using boxplot.stats. Note that most arguments controlling the display can be supplied to the high-level bwplot call directly. Unlike the traditional analog boxplot, notches are not implemented.

Although the graphical parameters for the dot representing the median can be controlled by optional arguments, many others can not. These parameters are obtained from the relevant settings parameters ("box.rectangle" for the box, "box.umbrella" for the whiskers and "plot.symbol" for the outliers).

See Also

bwplot, boxplot.stats

Examples

bwplot(voice.part ~ height, data = singer,
       xlab = "Height (inches)",
       panel = function(...) {
           panel.grid(v = -1, h = 0)
           panel.bwplot(...)
       },
       par.settings = list(plot.symbol = list(pch = 4)))