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.