`plbin`: Plot a histogram from binned data
Prev | Chapter 18. The Common API for PLplot | Next

#### `plbin`: Plot a histogram from binned data

`plbin (` | nbin,
| x,
| y,
| opt`)`;

Plots a histogram consisting of ``nbin`` bins. The value associated with the `i`'th bin is placed in ``x`[i]`, and the number of points in the bin is placed in ``y`[i]`. For proper operation, the values in ``x`[i]` must form a strictly increasing sequence. By default, ``x`[i]` is the left-hand edge of the `i`'th bin. If ``opt`=PL_BIN_CENTRED` is used, the bin boundaries are placed midway between the values in the ``x`` vector. Also see `plhist` for drawing histograms from unbinned data.

`nbin` (``PLINT``, input)

  Number of bins (i.e., number of values in ``x`` and ``y`` vectors.)

`x` (``PLFLT_VECTOR``, input)

  A vector containing values associated with bins. These must form a strictly increasing sequence.

`y` (``PLFLT_VECTOR``, input)

  A vector containing a number which is proportional to the number of points in each bin. This is a `PLFLT` (instead of `PLINT`) vector so as to allow histograms of probabilities, etc.

`opt` (``PLINT``, input)

  Is a combination of several flags:

  - ``opt`=PL_BIN_DEFAULT`: The ``x`` represent the lower bin boundaries, the outer bins are expanded to fill up the entire x-axis and bins of zero height are simply drawn.

  - ``opt`=PL_BIN_CENTRED|...`: The bin boundaries are to be midway between the ``x`` values. If the values in ``x`` are equally spaced, the values are the center values of the bins.

  - ``opt`=PL_BIN_NOEXPAND|...`: The outer bins are drawn with equal size as the ones inside.

  - ``opt`=PL_BIN_NOEMPTY|...`: Bins with zero height are not drawn (there is a gap for such bins).

Redacted form:

- General: `plbin(x, y, opt)`

- Perl/PDL: `plbin(nbin, x, y, opt)`

- Python: `plbin(nbin, x, y, opt)`

This function is not used in any examples.

Prev | Up | Next
`plaxes`: Draw a box with axes, etc. with arbitrary origin | Home | `plbop`: Begin a new page