plhist: Plot a histogram from unbinned data

The PLplot Plotting Library: Programmer's Reference Manual
Prev | Chapter 17. The Common API for PLplot | Next

### `plhist`: Plot a histogram from unbinned data

`plhist` (n, data, datmin, datmax, nbin, opt);

Plots a histogram from ``n`` data points stored in the array ``data``. This routine bins the data into ``nbin`` bins equally spaced between ``datmin`` and ``datmax``, and calls `plbin` to draw the resulting histogram. Parameter ``opt`` allows, among other things, the histogram either to be plotted in an existing window or causes `plhist` to call `plenv` with suitable limits before plotting the histogram.

`n` (`PLINT`, input) Number of data points. `data` (`PLFLT *`, input) Pointer to array with values of the ``n`` data points. `datmin` (`PLFLT`, input) Left-hand edge of lowest-valued bin. `datmax` (`PLFLT`, input) Right-hand edge of highest-valued bin. `nbin` (`PLINT`, input) Number of (equal-sized) bins into which to divide the interval ``xmin`` to ``xmax``. `opt` (`PLINT`, input) Is a combination of several flags: ``opt`=PL_HIST_DEFAULT`: The axes are automatically rescaled to fit the histogram data, the outer bins are expanded to fill up the entire x-axis, data outside the given extremes are assigned to the outer bins and bins of zero height are simply drawn. ``opt`=PL_HIST_NOSCALING|...`: The existing axes are not rescaled to fit the histogram data, without this flag, `plenv` is called to set the world coordinates. ``opt`=PL_HIST_IGNORE_OUTLIERS|...`: Data outside the given extremes are not taken into account. This option should probably be combined with ``opt`=PL_HIST_NOEXPAND|...`, so as to properly present the data. ``opt`=PL_HIST_NOEXPAND|...`: The outer bins are drawn with equal size as the ones inside. ``opt`=PL_HIST_NOEMPTY|...`: Bins with zero height are not drawn (there is a gap for such bins).

Redacted form: `plhist(data, datmin, datmax, nbin, opt)`

This function is used in example 5.

Prev | Home | Next
`plgzax`: Get z axis parameters | Up | `plhlsrgb`: Convert HLS color to RGB