The BarChart command generates a bar chart for the specified data. Several formats are available for multiple data sets: default, stacked and percent stacked. See format option below for more information. The ColumnGraph command is similar to BarChart except that numerical values are represented by vertical columns.

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. Alternatively, X can be specified as a list of equations of type value=frequency.

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=none, relative, absolute, or list

This option controls data set labels on the bars. The relative option will display, for each bar, the relative frequency of the corresponding value. The absolute option will display the absolute frequency of the corresponding value. Finally, one can specify data set labels as a list of strings or expressions.

color=name, list, or range

This option specifies colors for the individual data sets. When a list of colors is given, each of the bars 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.

distance=realcons

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

format=default or stacked

By default, individual data sets are clustered together, so that the first cluster contains the first element from each data set, the second cluster contains the second element from each data set, etc. A stacked bar chart shows related data groups, one on top of the other. A percent bar chart is similar to a stacked bar chart, except that it is rescaled to a height of 1 while preserving proportionality. If scale is set to relative and format is set to stacked then a percent stacked plot will be generated.

offset=realcons

Initial offset along the x-axis.

scale=absolute, or relative

This option controls whether the absolute or relative data scale should be used. If scale is set to relative and format is set to default then all data samples will be rescaled so that their range belongs to an interval between -1 and 1. If scale is set to relative and format is set to stacked then a percent stacked plot will be generated.

width=realcons

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