.TH HIST 1carl CARL
.SH NAME
hist \- calculates histogram of sound signals
.SH SYNOPSIS
.B hist
< floatsams > histogram (ASCII display)
.br
or
.br
.B hist
\-e < floatsams > floatsams, and >& histogram
.SH DESCRIPTION
.B hist 
reads samples from stdin and calculates a histogram of the amplitude
values contained in that signal.
The input data stream must be floatsams.
In the first usage given above,
it prints this histogram and various amplitude measures after all samples
have been read on stdout.  
In the second usage, when the -e flag is given, the histogram is written
to stderr, and the input samples are copied to stdout.  This allows
hist to be inserted in a sample data stream as a "test probe."
.PP
The following examples determine a histogram for sound file boom:
.sp
.RS .5i
sndin boom | hist
.br
sndin boom | hist -e | sndout boom2 (histogram placed on stderr)
.sp
.RE
.SH AUTHOR
F. R. Moore
.SH SEE ALSO
rms(1carl), peak(1carl), getfloat(3carl)
