.TH RMS 1carl CARL
.SH NAME
rms \- calculates rms amplitude of sound signal
.SH SYNOPSIS
.B rms [-dB]
< floatsams > rms (ASCII display)
.br
or
.br
.B rms [-dB]
\-e < floatsams > floatsams, and >& rms
.SH DESCRIPTION
.B rms 
reads samples from stdin and finds the root mean square of the
energy of the signal.
The input data stream must be floatsams.
In the first usage given above,
it prints the rms value on stdout.
In the second usage, when the -e flag is given, the rms is written
to stderr, and the input samples are copied to stdout.  This allows
rms to be inserted in a sample data stream as a "test probe."
.PP
The optional flag -dB (abbreviating this to -d will work too) causes
the rms value to be printed in dB.
.PP
The following examples determine the rms amplitude for sound file boom:
.sp
.RS .5i
sndin boom | rms
.br
sndin boom | rms -e | sndout boom2 (rms placed on stderr)
.sp
.RE
.SH AUTHOR
F. R. Moore
.SH SEE ALSO
peak(1carl), energy(1carl)
