The R Project SVN R

Rev

Rev 286 | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 286 Rev 636
Line 1... Line 1...
1 
\name{boxplot}
 1 
\name{boxplot}
2 
\title{Box Plots}
 2 
\title{Box Plots}
3 
\usage{
 3 
\usage{
4 
boxplot(\dots, range = 1.5, width = NULL, varwidth = FALSE,
 4 
boxplot(\dots, range = 1.5, width = NULL, varwidth = FALSE,
5 
        notch = FALSE, names, data = sys.frame(sys.parent()),
 5 
        notch = FALSE, names.x, data = sys.frame(sys.parent()),
6 
        plot = TRUE, border = par("fg"), col = NULL, log = "",
 6 
        plot = TRUE, border = par("fg"), col = NULL, log = "",
7 
        pars = NULL)
 7 
        pars = NULL)
8 
}
 8 
}
9 
\alias{boxplot}
 9 
\alias{boxplot}
10 
\arguments{
 10 
\arguments{
Line 28... Line 28...
28 
    with widths proportional to the square-roots of the number of
 28 
    with widths proportional to the square-roots of the number of
29 
    observations in the groups.}
 29 
    observations in the groups.}
30 
  \item{notch}{if \code{notch} is \code{TRUE}, a notch is drawn in each
 30 
  \item{notch}{if \code{notch} is \code{TRUE}, a notch is drawn in each
31 
    side of the boxes.  If the notches of two plots do not overlap then
 31 
    side of the boxes.  If the notches of two plots do not overlap then
32 
    the medians are significantly different at the 5 percent level.}
 32 
    the medians are significantly different at the 5 percent level.}
33 
  \item{names}{group labels which while be printed under each boxplot.}
 33 
  \item{names.x}{group labels which while be printed under each boxplot.}
- 
 
 34 
  \item{data}{\code{\link{data.frame}}, \code{\link{list}}, or
- 
 
 35 
    \code{\link{environment}} in which variable names are evaluated when
34 
  \item{data}{???}
 36 
    \code{x} is a formula.}
35 
  \item{plot}{if \code{TRUE} (the default) then a boxplot is produced.
 37 
  \item{plot}{if \code{TRUE} (the default) then a boxplot is produced.
36 
    If not, the summaries which the boxplots are based on are returned.}
 38 
    If not, the summaries which the boxplots are based on are returned.}
37 
  \item{border}{an optional vector of colors for the outlines of the
 39 
  \item{border}{an optional vector of colors for the outlines of the
38 
    boxplots.  The values in \code{border} are recycled if the length of
 40 
    boxplots.  The values in \code{border} are recycled if the length of
39 
    \code{border} is less than the number of plots.}
 41 
    \code{border} is less than the number of plots.}
40 
  \item{col}{if \code{col} is non-null it is assumed to contain colors
 42 
  \item{col}{if \code{col} is non-null it is assumed to contain colors
41 
    to be used to col the bodies of the box plots.}
 43 
    to be used to col the bodies of the box plots.}
42 
  \item{log}{???}
 44 
  \item{log}{character indicating if x- or y- or both coordinates should
43 
  \item{pars}{???}
 45 
    be plotted in log scale.}
44 
  \item{\dots}{graphical parameters can also be passed as arguments to
 46 
  \item{pars, \dots}{graphical parameters can also be passed as arguments to
45 
    \code{boxplot}.}
 47 
    \code{boxplot}.}
46 
}
 48 
}
47 
\value{
 49 
\value{
48 
  This function is usually invoked for its side effect which is to
 50 
  This function is usually invoked for its side effect which is to
49 
  produce box-and-whisker plots of the given values.  However, it also
 51 
  produce box-and-whisker plots of the given values.  However, it also
Line 62... Line 64...
62 
  \code{\link{bxp}} for the plotting.
 64 
  \code{\link{bxp}} for the plotting.
63 
}
 65 
}
64 
\examples{
 66 
\examples{
65 
data(insects)
 67 
data(insects)
66 
boxplot(count ~ spray, data = insects, col = "lightgray")
 68 
boxplot(count ~ spray, data = insects, col = "lightgray")
- 
 
 69 
 
- 
 
 70 
data(bees)
- 
 
 71 
boxplot(decrease ~ treatment, data = bees, log = "y", col="bisque")
67 
}
 72 
}
68 
\keyword{hplot}
 73 
\keyword{hplot}