plhist
(n, data, datmin, datmax, nbin, opt); |
Plots a histogram from n
data points stored in the array
data
. 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 *, input)
Pointer to array with 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.