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, cap.shrink = 1.) 

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?
cap.shrink
ratio of the widths of the whisker ends to the widths of the boxes.

VALUE:

an invisible NULL.

SIDE EFFECTS:

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

SEE ALSO:

, , .