NAME¶
plbin - Plot a histogram from binned data
SYNOPSIS¶
plbin(
nbin,
x,
y,
opt)
DESCRIPTION¶
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 array. Also see
plhist(3plplot) for drawing histograms from unbinned data.
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.
ARGUMENTS¶
- nbin (PLINT, input)
- Number of bins (i.e., number of values in x and y
arrays.)
- 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: 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).
AUTHORS¶
Many developers (who are credited at
http://plplot.sourceforge.net/credits.php)
have contributed to PLplot over its long history.
SEE ALSO¶
PLplot documentation at
http://plplot.sourceforge.net/documentation.php.