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 (PLFLT *, input)
- Pointer to array containing values associated with bins.
These must form a strictly increasing sequence.
- y (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¶
Geoffrey Furnish and Maurice LeBrun wrote and maintain PLplot. This man page was
automatically generated from the DocBook source of the PLplot documentation,
maintained by Alan W. Irwin and Rafael Laboissiere.
SEE ALSO¶
PLplot documentation at
http://plplot.sourceforge.net/resources.