HISTPRINT - print accumulated histogram.
Usage:
B:
histprint( hg, tty, title [,t1,t2,t3,t4] );
C:
void histprint(void *hg, int tty,
const char *title, ...);
Where:
- hg
- identifies the histogram to be printed.
- tty
- is an integer value controlling print width.
- 0
- full printer width histogram.
- 1 through 9
- produces a narrow histogram to fit a terminal
screen (78 columns). This format is often too
small to show much useful information. The
default is to fit the histogram into 16 lines.
- 10 through 70
- also produces a narrow histogram, but uses the
value of "tty" as the default vertical
size (line count). For example, a value of 35
gives a narrow histogram, 35 lines long.
- larger than 70
- is the same as 1 through 9.
- -1 through -9
- produces a wide histogram defaulting to 51 lines
long. The histogram is widened both by making the
scale of the graph larger and by including extra
stats for each bar, including:
cumulative percentage
cumulative remainder
multiple of mean (x/xbar)
number of standard deviations from the mean
( (x-xbar)/sigma )
- -10 through -70
- same as -1 through -9, except that HISTPRINT
takes the absolute value of "tty" as
the default vertical size of the histogram. For
example, a value of -35 gives a wide histogram,
35 lines long.
- less than -70
- same as -1 through -9.
- title
- is a title string for the histogram.
- t1,t2,t3,t4
- are extra parts of the title. Actually, "title"
is a PRINTF format string,
which controls the use of "t1", "t2",
"t3", "t4".
Description:
HISTPRINT prints out the histogram which has been accumulated
thus far. HISTPRINT does not destroy the accumulated information,
so more values may be added and HISTPRINT called again.
See Also:
expl b lib hist
Copyright © 1996, Thinkage Ltd.