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.