`plhist`: Plot a histogram from unbinned data
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 ``data`` vector. 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_VECTOR``, input)

  A vector containing the 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 | Up | Next
`plgzax`: Get z axis parameters | Home | `plhlsrgb`: Convert HLS color to RGB