plbin
( | nbin, |
| x, | |
| y, | |
opt); |
Plots a histogram consisting of
bins. The value
associated with the nbini'th bin is placed in
, and the number of
points in the bin is placed in
x[i]. For proper
operation, the values in
y[i] must form a strictly
increasing sequence. By default,
x[i] is the left-hand edge
of the x[i]i'th bin. If
is
used, the bin boundaries are placed midway between the values in the
opt=PL_BIN_CENTRED array. Also see xplhist
for drawing histograms from unbinned data.
nbin
(PLINT, input)
Number of bins (i.e., number of values in
and
x arrays.)
y
x
(const PLFLT *, input)
Pointer to array containing values associated with bins. These must form a strictly increasing sequence.
y
(const PLFLT *, input)
Pointer to array containing number of points in bin. This is a
PLFLT (instead of PLINT)
array so as to allow histograms of probabilities, etc.
opt
(PLINT, input)
Is a combination of several flags:
:
The opt=PL_BIN_DEFAULT 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.
x
:
The bin boundaries are to be midway between the
opt=PL_BIN_CENTRED|... values. If the
values in x are
equally spaced, the values are the center values of the bins.
x
:
The outer bins are drawn with equal size as the ones inside.
opt=PL_BIN_NOEXPAND|...
:
Bins with zero height are not drawn (there is a gap for
such bins).
opt=PL_BIN_NOEMPTY|...
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.