create bar charts from data
create column graphs from data
BarChart(X, options, plotoptions)
ColumnGraph(X, options, plotoptions)
(optional) equation(s) of the form option=value where option is one of datasetlabels, color, colorscheme, offset, distance, width, format or scale; specify options for generating the bar chart
options to be passed to the plots[display] command
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 e.g. a Vector - 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.
If the ['interactive'] option is used, then a dialog box appears that allows for customized creation of the plot.
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 displays, for each bar, the relative frequency of the corresponding value. The absolute option displays the absolute frequency of the corresponding value. Finally, you can specify data set labels as a list of strings or expressions.
color=name, list, range, Matrix or DataFrame
When specified as a list or a range of colors, the option is used for coloring individual data sets. For a list of colors, each of the bars is colored with the corresponding color in the list. If a range of colors is given, a list is generated by selecting an appropriate number of equally spaced points in the corresponding hue range.
If both color and X are specified as Matrices, then each of the values in X gets mapped to the color located in the corresponding cell of the color Matrix and the bars are then colored accordingly. For DataFrames this mapping is done while taking the appropriate labels into account.
In the case where X consists of a list of data samples, each data sample gets mapped to the corresponding column of the color Matrix or DataFrame.
colorscheme=[ "valuesplit", V', mapping ]
The first parameter in colorscheme specifies the arguments to the plotting command and for BarChart must always be set to "valuesplit" when colorscheme is defined.
V is an optional rtable or a list of n elements, where n is the total number of expected bars in the plot structure.
The ith entry in V corresponds to the ith entry in the data sample.
If X is specified as a list of data samples and V is given as a Matrix then each data sample corresponds to a column in V.
When both X and V are specified as Matrices, each of the values in X gets mapped to the value located in the corresponding cell of V. For DataFrames the appropriate labels are taken into account.
If V is not provided, X itself is used instead in place of V.
The mapping argument is commonly defined as a list of equalities specifying the mapping of values in V to colors. In the event where the mapping parameter is not supplied, a suitable color mapping for each of the distinct elements of V is automatically created with colors chosen from a default color palette. (See the plot/color help page for information about default colors for plotting.)
For details about the colorscheme/valuesplit option see valuesplit(colorscheme).
Initial offset along the x-axis. The default value is 0.
Note: By default, the view wraps tightly around all visible plot objects and the horizontal axis is marked by data set labels, not regular coordinates, so this option will have no (visual) effect. It is meant for the case where this plot is combined with other plot elements.
This option controls the distance between the boxes. The default value is 0.25.
This option controls the cluster width. The default value is 0.75.
The following plot illustrates how the options offset, distance, and width are interpreted
Note the lengths of the arrows labeled "offset", "width", and "distance" correspond to values for the offset, width, and distance options respectively.
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 is generated.
scale=absolute or relative
This option controls whether the absolute or relative data scale is used. If scale is set to relative and format is set to default then all data samples are 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 is generated.
Note that the labels for the data sets are placed on the axes, and should not be confused for coordinates.
In the event where the options colorscheme and color are both specified, the colorscheme option takes precedence over the color option.
Plot options such as background color or gridlines are passed to the plots:-display command:
The commands to create the plots from the Plotting Guide using the data above are
The BarChart and ColumnGraph commands also accept a Matrix. The columns are understood as individual data samples.
Using Data Frames to specify the color option
The colorscheme option can also be used to color bars by their values
Additional options such as style and size are passed to the plots[display] command.
The Statistics[BarChart] and Statistics[ColumnGraph] commands were updated in Maple 2017.
The colorscheme option was introduced in Maple 2017.
The color option was updated in Maple 2017.
For more information on Maple 2017 changes, see Updates in Maple 2017.
Download Help Document
What kind of issue would you like to report? (Optional)