The Histogram command generates a histogram for the specified data. Ordinary and average shifted histograms are supported. An average shifted histogram is obtained by calculating  histograms with the same binwidth , shifting them by  and taking the average. Average shifted histograms are smoother than ordinary histograms and are less dependent on the choice of the origin.

The first parameter X is a single data sample, given as a Vector or list.

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.

discrete=truefalse

If discrete is set to true, the Histogram command will tally the data and plot each data point with the corresponding frequency.  The default value is false. If discrete = true, then the averageshifted, binbounds, bincount, binwidth, maxbins, and minbins options are ignored.

averageshifted=posint

This option specifies how many frequency plots are used to compute the average. The default value is 1. Values other than 1 are only compatible with binbounds = deduce (the default value for that option).

frequencyscale=relative or absolute

This option controls whether the absolute or relative data frequencies should be plotted. If frequencyscale is set to relative (the default) then the area of each bar is proportional to the number of data points in the corresponding bin. If the bins are equally wide, then the height of the bars is also proportional to the number of data points in the bin. Furthermore, the histogram is rescaled so that the total area of the bars is equal to 1.

If, on the other hand, frequencyscale = absolute is specified, then the height of each bar is the exact number of data points in the bin. In this case, if the bins are not equally wide, then the area of the bars is not proportional to the number of data points in the corresponding bins.

binbounds=proportional or list or quantiles(...) or quartiles(...) or deciles(...) or percentiles(...) or deduce

This option specifies the bounds for each of the bins.

binbounds = deduce (the default) specifies that the bins should be equally wide and determined by the bincount, binwidth, maxbins, minbins, and range options. All other values of binbounds override all of these options, unless mentioned otherwise below. This is the only value for binbounds that is compatible with averageshifted being different from 1.

binbounds = [x0, x1, ..., xn] with x0 < x1 < ... < xn specifies that numbers given in the list are the boundaries between the bins. So binbounds = [x0, x1, x2, x3] would specify three bins: from x0 to x1, from x1 to x2, and from x2 to x3. Instead of a list, you can also specify a Vector or other 1-dimensional rtable.

binbounds = quantiles(x0, x1, ..., xn) with 0 <= x0 < x1 < `...` < xn <= 1 is equivalent to specifying the list . See the Quantile help page for details. If the option ignore=true is specified, then it is also passed to the Quantile command.

binbounds = quartiles(x0, x1, ..., xn) or deciles(x0, x1, ..., xn) or percentiles(x0, x1, ..., xn) is similar to quantiles(x0, x1, ..., xn), except the commands used are Quartile, Decile, and Percentile, respectively, instead of Quantile.

binbounds = proportional determines the bin count in the same way as binbounds = deduce, resulting in, say,  bins. It then proceeds as binbounds = quantiles(0, 1/n, 2/n, ..., 1). Consequently, every bin has roughly the same number of data points in it.

range=deduce or range

The default value is deduce and all available data will be used to generate the histogram.  If a range is specified, all data points outside the given range will be ignored.

bincount=positive or deduce

This option controls the number of bins for the histogram. If the number of bins is explicitly specified through this option, the maxbins, minbins, and binwidth options will be ignored.

binwidth=positive, Sturges, Scott, or FreedmanDiaconis

This option controls the bin width (and consequently the number of bins) for the histogram. The bin width can be either specified explicitly (which overrides the maxbins and minbins options) or can be calculated using one of three methods: Sturges, Scott, or FreedmanDiaconis. The default value is Sturges.

maxbins=posint

This option specifies the maximum number of bins in a histogram. If the computed bin width is too small, it will be increased. The default is 500.

minbins=posint

This option specifies the minimum number of bins in a histogram. If the computed bin width is too large, it will be decreased. The default is 30.

color=name, list, or range

This option specifies the color of the histogram. When a list or range of colors is given, the first color is used.

ignore=truefalse

This option is used to specify how to handle non-numeric data. If ignore is set to true all non-numeric items in X will be ignored.  The default is false.

The binbounds option was introduced in Maple 16.

For more information on Maple 16 changes, see Updates in Maple 16.

Error, (in Statistics:-Histogram) unable to determine the data range, use option 'ignore' to remove all undefined data