NAME¶
plhist - Plot a histogram from unbinned data
SYNOPSIS¶
plhist(
n,
data,
datmin,
datmax,
nbin,
opt)
DESCRIPTION¶
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(3plplot) to draw the
resulting histogram. Parameter
opt allows, among other things, the
histogram either to be plotted in an existing window or causes
plhist(3plplot) to call
plenv(3plplot) with suitable limits
before plotting the histogram.
Redacted form:
plhist(data, datmin, datmax, nbin, opt)
This function is used in example 5.
ARGUMENTS¶
- 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(3plplot) 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).
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.