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 (const 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¶
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.