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

