\HeaderA{panel.bwplot}{Default Panel Function for bwplot}{panel.bwplot}
\keyword{dplot}{panel.bwplot}
\begin{Description}\relax
This is the default panel function for \code{bwplot}.
\end{Description}
\begin{Usage}
\begin{verbatim}
panel.bwplot(x, y, box.ratio = 1,
             box.width = box.ratio / (1 + box.ratio),
             horizontal = TRUE,
             pch, col, cex, 
             font, fontfamily, fontface, 
             fill, varwidth = FALSE,
             ...,
             levels.fos,
             stats = boxplot.stats,
             coef = 1.5,
             do.out = TRUE)
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{x, y}] numeric vector or factor. Boxplots drawn for each unique value of
\code{y} (\code{x}) if \code{horizontal} is \code{TRUE} (\code{FALSE})
\item[\code{box.ratio}] ratio of box thickness to inter box space
\item[\code{box.width}] thickness of box in absolute units; overrides
\code{box.ratio}.  Useful for specifying thickness when the
categorical variable is not a factor, as use of \code{box.ratio}
alone cannot achieve a thickness greater than 1. 
\item[\code{horizontal}] logical. If FALSE, the plot is \sQuote{transposed} in the sense that
the behaviours of x and y are switched. x is now the
\sQuote{factor}.  Interpretation of other arguments change
accordingly. See documentation of \code{\LinkA{bwplot}{bwplot}} for a fuller
explanation.

\item[\code{pch, col, cex, font, fontfamily, fontface}] graphical parameters
controlling the dot.  \code{pch="|"} is treated specially, by
replacing the dot with a line (similar to \code{\LinkA{boxplot}{boxplot}})

\item[\code{fill}] color to fill the boxplot
\item[\code{varwidth}] logical. If TRUE, widths of boxplots are proportional
to the number of points used in creating it.
\item[\code{stats}] a function, defaulting to \code{\LinkA{boxplot.stats}{boxplot.stats}},
that accepts a numeric vector and returns a list similar to the
return value of \code{boxplot.stats}.  The function must accept
arguments \code{coef} and \code{do.out} even if they do not use
them (a \code{...} argument is good enough).  This function is
used to determine the box and whisker plot.  
\item[\code{coef, do.out}] passed to \code{stats}
\item[\code{levels.fos}] numeric values corresponding to positions of the
factor or shingle variable.  For internal use. 
\item[\code{...}] further arguments, ignored.

\end{ldescription}
\end{Arguments}
\begin{Details}\relax
Creates Box and Whisker plot of \code{x} for every level of
\code{y} (or the reverse if \code{horizontal=FALSE}).  By default, the
actual boxplot statistics are calculated using \code{boxplot.stats}.
Note that most arguments controlling the display can be supplied to
the high-level \code{bwplot} call directly.  Unlike the traditional
analog \code{\LinkA{boxplot}{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
(\code{"box.rectangle"} for the box, \code{"box.umbrella"} for the
whiskers and \code{"plot.symbol"} for the outliers).
\end{Details}
\begin{Author}\relax
Deepayan Sarkar \email{Deepayan.Sarkar@R-project.org}
\end{Author}
\begin{SeeAlso}\relax
\code{\LinkA{bwplot}{bwplot}}, \code{\LinkA{boxplot.stats}{boxplot.stats}}
\end{SeeAlso}
\begin{Examples}
\begin{ExampleCode}

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)))

\end{ExampleCode}
\end{Examples}

