\Header{bxp}{Box Plots from Summaries}
\keyword{aplot}{bxp}
\begin{Description}\relax
\code{bxp(..)} draws box plots based on the given summaries in
\code{z}.  It is usually called from within \code{\Link{boxplot}(..)},
but can be invoked directly.\end{Description}
\begin{Usage}
\begin{verbatim}
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, ...)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{z}] a list containing data summaries to be used in constructing the plots.
These are usually the result of a call to \code{\Link{boxplot}},
but can be generated in any fashion.
\item[\code{notch}] if \code{notch} is \code{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.
\item[\code{width}] a vector giving the relative widths of the boxes making up
the plot.
\item[\code{varwidth}] if \code{varwidth} is \code{TRUE}, the boxes are drawn
with widths proportional to the square-roots of the number of
observations in the groups.
\item[\code{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.
\item[\code{notch.frac}] numeric in (0,1). When \code{notch=TRUE}, the fraction
of the box width that the notches should use.
\item[\code{border}] character, the color of the box borders. Is recycled for
multiple boxes.
\item[\code{col}] character; the color within the box. Is recycled for
multiple boxes
\item[\code{log}] character, indicating if any axis should be drawn in
logarithmic scale, as in \code{\Link{plot.default}}.
\item[\code{frame.plot}] logical, indicating if a ``frame''
(\code{\Link{box}()}) should be drawn; defaults to \code{TRUE}, unless
\code{axes = FALSE} is specified.
\item[\code{horizontal}] logical indicating if the  boxplots should be
horizontal; default \code{FALSE} means vertical boxes.
\item[\code{add}] logical, if true \emph{add} boxplot to current plot.
\item[\code{pars,...}] Graphical parameters can be passed as arguments to
this function, either as a list (\code{pars}) or normally(\code{...}).
\end{ldescription}
\end{Arguments}
\begin{Value}
An invisible vector with the x-coordinates of box centers, useful
for adding to the plot.\end{Value}
\begin{Examples}
\begin{ExampleCode}
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)
\end{ExampleCode}
\end{Examples}

