HISTOGRAM - Bin and plot a histogram of the data

Description:

The data in the XCOL data area are binned and plotted as a histogram. It is possible to plot several histograms with different bin sizes from the same data in XCOL because the data are unaffected by HISTOGRAM.

This command is a synonym for PLOTHIST H.

Usage:

histogram [binmin] [binmax] [nbin]

Parameters:

BINMIN = _REAL (Read and Write)

The lower limit of the binning.

If no value is specified on the command line, the current value is used. If there is no current value, the value of the global parameter PONGO_XMIN is used.

BINMAX = _REAL (Read and Write)

The upper limit of the binning.

If no value is specified on the command line, the current value is used. If there is no current value, the value of the global parameter PONGO_XMAX.

NBIN = _INTEGER (Read and Write)

The number of equally sized bins to be drawn between the limits of the histogram.

If no value is specified on the command line, the current value is used. The current value is initially set to 10.

AUTOSCALE = _LOGICAL (Read and Write)

If TRUE, PGPLOT auto-scaling is used to determine the plotting limits. If FALSE, the limits defined by the bins of the histogram determine the plotting limits. Here, the plotting limits must previously have been set using the LIMITS application and the plot frame drawn using BOXFRAME. Setting NOAUTOSCALE can be used to draw more than one histogram on the same plot.

If no value is specified on the command line, the current value is used. The current value is initially set to TRUE.

FILL = _LOGICAL (Read)

When ACTION is "H" this parameter controls whether the histogram will be drawn filled with the current fill, colour and hatching styles. [FALSE]