R: Box Plots from Summaries

bxp {base}

R Documentation

Box Plots from Summaries

Description

bxp(..) draws box plots based on the given summaries in z. It is usually called from within boxplot(..), but can be invoked directly.

Usage

bxp(z, notch = FALSE, width = NULL, varwidth = FALSE, notch.frac = 0.5,
    boxwex = 0.8, border = par("fg"), col = NULL, log = "",
    pars = NULL, ...)

Arguments

z

a list containing data summaries to be used in constructing the plots. These are usually the result of a call to boxplot, but can be generated in any fashion.

notch

if notch is TRUE, a notch is drawn in each side of the boxes. If the notches of two plots do not overlap then the medians are significantly different at the 5 percent level.

width

a vector giving the relative widths of the boxes making up the plot.

varwidth

if varwidth is TRUE, the boxes are drawn with widths proportional to the square-roots of the number of observations in the groups.

boxwex

a scale factor to be applied to all boxes. When there are only a few groups, the appearance of the plot can be improved by making the boxes narrower.

notch.frac

numeric in (0,1). When notch=TRUE, the fraction of the box width that the notches should use.

border

character, the color of the box borders. Is recycled for multiple boxes.

col

character; the color within the box. Is recycled for multiple boxes

log

character, indicating if any axis should be drawn in logarithmic scale, as in plot.default.

pars, ...

Graphical parameters can be passed as arguments to this function, either as a list (pars) or normally(...).

Value

An invisible vector with the x-coordinates of box centers, useful for adding to the plot.

Examples

str(bx.p <- boxplot(split(rnorm(100), gl(5,20)), plot = FALSE))
op <- par(mfrow= c(2,2))
bxp(bx.p)
bxp(bx.p, notch = TRUE)
bxp(bx.p, notch = TRUE, col= 'lightblue')
bxp(bx.p, notch = TRUE, col= 'lightblue', border='red', log = 'x')
par(op)

[Package base version 1.1 ]