The FrequencyPlot command generates a frequency plot for the specified data. A frequency plot is similar to a histogram except that a frequency plot has lines connecting frequency values and a histogram has bars at the frequency values. Unlike the Histogram command, the FrequencyPlot command supports multiple data samples. Ordinary and average shifted frequency plots are supported. An average shifted frequency plot is obtained by calculating $m$ frequency plots with the same binwidth $w$, shifting them by $\frac{w}{m}$ and taking the average. Average shifted frequency plots are smoother than ordinary frequency plots and are less dependent on the choice of the origin.

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.

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.

frequencyscale=relative or absolute

This option controls whether the absolute or relative data frequencies are plotted. If frequencyscale is set to relative (the default) then the frequency plot is rescaled to that the area under the plot is equal to 1. Otherwise, the vertical axis gives the exact number of data points in each bin. Using frequencyscale = absolute together with non-constant bin widths (specified using the binbounds option) is not recommended, since the resulting frequency plot may be misleading.

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).

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 one-dimensional rtable.

binbounds = quantiles(x0, x1, ..., xn) with 0 <= x0 < x1 < `...` < xn <= 1 is equivalent to specifying the list $\left[\mathrm{Quantile}\left(X\&comma;\mathrm{x0}\right)\&comma;\mathrm{Quantile}\left(X\&comma;\mathrm{x1}\right)\&comma;\mathrm{...}\&comma;\mathrm{Quantile}\left(X\&comma;\mathrm{xn}\right)\right]$. 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, $n$ 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 is used to generate the frequency plot.  If range is specified, all data points outside the given range are 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 are ignored.

binwidth=positive, Sturges, Scott, or FreedmanDiaconis

This option controls the bin width (and consequently the number of bins) for the frequency plot. 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 frequency plot. If the computed bin width is too small, it will be increased.

minbins=posint

This option specifies the minimum number of bins in a frequency plot. If the computed bin width is too large, it will be decreased.

color=name, list, or range

This option specifies the color of the frequency plot. When a list of colors is given, the colors are used in order for each of the data samples. (In particular, if there is only one data sample, only the first color is used.) When a range of colors is given, the colors are generated by selecting an appropriate number of equally spaced points in the corresponding hue range.

discrete=truefalse

If discrete is set to true, the FrequencyPlot command tallies the data and plots each data point with the corresponding frequency. The default value is false.

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 is ignored.  The default is false.

legend=s

Legend entry for the resulting plot. For information on how to specify s, see plot/typesetting. If s is a list, then it must have as many elements as there are data samples, and the order of the legends corresponds to the order of the datat samples.

$\mathrm{with}\left(\mathrm{Statistics}\right)\&colon;$

$A≔\mathrm{Sample}\left(\mathrm{Normal}\left(0\&comma;1\right)\&comma;500\right)\&colon;$

$P≔\mathrm{DensityPlot}\left(\mathrm{Normal}\left(0\&comma;1\right)\&comma;\mathrm{color}=''Niagara\; Red''\&comma;\mathrm{linestyle}=\mathrm{dash}\right)\&colon;$

$Q≔\mathrm{FrequencyPlot}\left(A\&comma;\mathrm{averageshifted}=4\right)\&colon;$

$\mathrm{plots}\left[\mathrm{display}\right]\left(P\&comma;Q\right)$

$\mathrm{FrequencyPlot}\left(A\right)$

$\mathrm{FrequencyPlot}\left(A\&comma;\mathrm{binbounds}=\mathrm{proportional}\right)$

$\mathrm{bounds}≔\left[-\mathrm{\infty }\&comma;-1\&comma;-\frac{1}{2}\&comma;-\frac{1}{4}\&comma;-\frac{1}{8}\&comma;0\&comma;\frac{1}{8}\&comma;\frac{1}{4}\&comma;\frac{1}{2}\&comma;1\&comma;\mathrm{\infty }\right]$

$\mathrm{bounds}≔\left[-\mathrm{\infty }\&comma;\mathrm{-1}\&comma;-\frac{1}{2}\&comma;-\frac{1}{4}\&comma;-\frac{1}{8}\&comma;0\&comma;\frac{1}{8}\&comma;\frac{1}{4}\&comma;\frac{1}{2}\&comma;1\&comma;\mathrm{\infty }\right]$

$\mathrm{FrequencyPlot}\left(A\&comma;\mathrm{binbounds}=\mathrm{bounds}\&comma;\mathrm{frequencyscale}=\mathrm{absolute}\right)$

$B≔\mathrm{Sample}\left(\mathrm{Geometric}\left(\frac{1}{3}\right)\&comma;500\right)\&colon;$

$P≔\mathrm{FrequencyPlot}\left(B\&comma;\mathrm{bincount}=10\&comma;\mathrm{color}=''Niagara\; Red''\right)\&colon;$

$Q≔\mathrm{Histogram}\left(B\&comma;\mathrm{discrete}=\mathrm{true}\right)\&colon;$

$\mathrm{plots}\left[\mathrm{display}\right]\left(P\&comma;Q\right)$

$C≔\mathrm{Sample}\left(\mathrm{Cauchy}\left(0\&comma;1\right)\&comma;{10}^4\right)$

$\mathrm{FrequencyPlot}\left(C\right)$

$\mathrm{FrequencyPlot}\left(C\&comma;\mathrm{range}=-5..5\&comma;\mathrm{binwidth}=\mathrm{FreedmanDiaconis}\right)$

$\mathrm{FrequencyPlot}\left(\left[1\&comma;2\&comma;3\&comma;\mathrm{undefined}\right]\right)$

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

$\mathrm{FrequencyPlot}\left(\left[1\&comma;2\&comma;3\&comma;\mathrm{undefined}\right]\&comma;\mathrm{ignore}\right)$

$A≔\mathrm{Sample}\left(\mathrm{Normal}\left(0\&comma;1\right)\&comma;500\right)$

$B≔\mathrm{Sample}\left(\mathrm{Normal}\left(1\&comma;2\right)\&comma;500\right)$

$\mathrm{FrequencyPlot}\left(\left[A\&comma;B\right]\right)$

$M≔⟨A^{\mathrm{\%T}}\left|B^{\mathrm{\%T}}\right|{\left(A+B\right)}^{\mathrm{\%T}}⟩$

$\mathrm{FrequencyPlot}\left(M\&comma;\mathrm{color}=''Niagara\; Red''..''Niagara\; Blue''\right)$

The binbounds option was introduced in Maple 16.

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