Boxplots at Specified Locations

DESCRIPTION:
Adds boxplots to the current plot at the specified locations.

USAGE:
boxes(x, width, stats, out=NULL, group=<<see below>>,
     labels=rep("",length=length(x)), horizontal=F)

REQUIRED ARGUMENTS:
x:
positions for the boxplots - on the x axis for vertical boxes or the y axis for horizontal boxes. See horizontal below. Missing values are not accepted.
width:
the widths of the boxes. This is replicated to have the same length as x. Just the "whiskers" and the outliers will be drawn for plots with width=NA.
stats:
the statistics that define the boxes, a matrix with 5 rows and length(x) columns. The rows give, in order, the upper extreme, the upper quartile, the median, the lower quartile and the lower extreme.

OPTIONAL ARGUMENTS:
out:
vector of outlying points.
group:
vector of integers specifying to which plot each point in out belongs. If out is specified, then group is required and must be the same length as out.
labels:
vector of character strings of labels for the boxes. This must have the same length as x.
horizontal:
logical flag: should the boxes be plotted horizontally, using x as the position on the vertical axis?

VALUE:
an invisible NULL.

SIDE EFFECTS:
adds boxplots to the current plot. These do not cause a frame eject.

SEE ALSO:
boxplot , bxp , symbols .