HIST(1)                 ZOOT UTILITY PROGRAMS                 HIST(1)

NAME

     hist - generate statistics and a small ascii histogram

DESCRIPTION

    This program takes a file of numbers separated by spaces
    (or it takes them from stdin if requested) and generates
    some statistical figures and a histogram. It can also
    compute empirical p-values.

    At least two samples are required. All output goes to the
    standard output.

ARGUMENTS

    usage: hist [-p {-,<file of statistics>}] [-s] {-,<file of samples>}

    When using with APM, the "file of samples" is usually
    one of the tstat*.out files containing the simulated
    statistics, and the "file of statistics" is generally
    not used (though "-p -" is sometimes used to enter
    statistics manually to compute empirical p-values
    (see below)).

    If -p is specified, the program will compute empirical
    p-values after everything else is done. If the p-value
    statistics are being taken from standard input (as
    directed by using '-' instead of the file name), it will
    prompt for them.

    The -s option is required only if -p is specified, to avoid
    ambiguity. If -p is not used, just a file name may be given.

    If -p is specified, then there must be at least one file
    specification (for either the p-value statistics or the
    samples). Both kinds of data cannot be read in from the
    standard input.

EXAMPLES

    'hist <file>' reads samples from <file> and does not compute
       empirical p-values
    'hist -p <file> -s -' reads samples from stdin and statistics
       for empirical p-values from <file>
    'hist -p <file 1> -s <file 2>' reads statistics for p-values
       from <file 1> and samples from <file 2>
    'hist -p - -s <file>' reads the samples from <file> and the
       statistics for the p-values from stdin
    'hist' is illegal
    'hist -p - -s -' is illegal (both files can't be unspecified)

BUGS

    None known.

REFERENCES

    Just myself. But for references regarding APM, see the
    accompanying REFERENCES file.


APM Release 2.0  Last change: 23 Aug 1993