The BoxPlot command generates a box plot for the specified data.

The first parameter X is either a single data sample - given as a Vector or list - or a list of data samples. Note, that the individual samples may be of variable size.

The options argument can contain one or more of the options shown below. All unrecognized options will be passed to the plots[display] command. See plot[options] for details.

datasetlabels=default or list

Data set labels to be added to the individual boxes. By default, datasetlabels will be set to 1, 2, 3, etc.

color=name, list, or range

This option specifies colors for the individual data sets. When a list of colors is given, each of the boxes will be colored with the corresponding color in the list. If a range of colors is given, the colors will be generated by selecting an appropriate number of equally-spaced points in the corresponding hue range.

deciles=truefalse

If this options is set to true then the deciles will be included in the plot. Deciles are represented by points with symbol type set to BOX. The default value is true.

distance=realcons

This option can be used to control the distance between the boxes. The default value is 0.25.

mean=truefalse

If this options is set to true then the mean will be included in the plot. The default value is true.

notched=truefalse

Draws notches on box-and-whisker plots. The default is false.

offset=realcons

Initial offset along the x-axis.

orientation=horizontal, or vertical

Indicate the orientation of the box plots. The default is vertical.

outliers=truefalse

Outliers are points that are farther than 3/2 times the interquartile range away from the upper and lower quartiles. If this option is set to false, then the outlying points will not be included in the plot. In this case, the whiskers will be extended past outliers to the maximum and minimum points.

width=realcons

This option can be used to control the width of the boxes. The default value is 0.75.