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, frame.plot = axes, horizontal = FALSE, add = FALSE, ...)

### 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`.
`frame.plot` | logical, indicating if a ``frame'' (`box()`) should be drawn; defaults to `TRUE`, unless `axes = FALSE` is specified.
`horizontal` | logical indicating if the boxplots should be horizontal; default `FALSE` means vertical boxes.
`add` | logical, if true add boxplot to current plot.
`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))))
    op <- par(mfrow= c(2,2))
    bxp(bx.p, xaxt = "n")
    bxp(bx.p, notch = TRUE, axes = FALSE)
    bxp(bx.p, notch = TRUE, col= 'lightblue', frame = FALSE)
    bxp(bx.p, notch = TRUE, col= 'lightblue', border='red',
        log = "x", ylim = c(-1,4), main = "bxp(*, log='x', ylim=*)")
    par(op)