HISTINIT - allocate and initialize a histogram.
Usage:
B:
hg = histinit( [type, difx, difw, lowest, highest] );
C:
void *histinit( [int type, int difx, int difw,
int lowest, int highest] );
Where:
- hg
- is a pointer that will be used to identify this
histogram.
- type
- describes how the values are gathered.
- 1
- non-weighted values only
- 2
- weighted values only
- 3
- weighted and non-weighted values (default)
- difx
- tells how the values supplied by the user should be used.
- 0
- Use the actual values supplied by the user
(default).
- 1
- Use the difference of successive values. This is
useful for a histogram of times, where the value
in the call would be the current clock.
- difw
- tells how the weights supplied by the user should be
used. It works the same as "difx".
- lowest
- indicates the minimum value displayed. Values less than
"lowest" are not shown in the histogram plot.
- highest
- indicates the maximum value plotted. Values greater than
or equal to this are not shown in the histogram plot.
Description:
HISTINIT allocates and initializes the space for histogram
control information.
Values outside the range "lowest" to
"highest" are still counted in calculating the basic
statistics about the data; they simply are not included in the
plot. Thus by specifying a "lowest" and
"highest" value, you may expand the display of some
subsection of the total histogram. If you wish to exclude some
range of values from the calculation completely, eliminate data
points in that range before they are passed to HISTOGRAM.
Normally, "lowest" and "highest" are not
used.
See Also:
expl b lib hist
Copyright © 1996, Thinkage Ltd.