view man/man1/convert.1 @ 0:5242703e91d3 tip

Initial checkin for AIM92 aimR8.2 (last updated May 1997).

.TH CONVERT 1 "15 September 1993"

.SH NAME
convert \- Convert units: frequency, time, and sample numbers.  

.SH SYNTAX 
convert [options] arguments


.SH DESCRIPTION
Convert time to samples and vice verca. Options of the general form:

        -to<units>  |  to=<units>

may be intersperced with arguments, which are treated as values to convert
into the units given by the previous option on the command line.
Time in seconds or milliseconds is converted to and from sample points using
the given samplerate. Time (in seconds, miliseconds or samples) is converted
to and from frequency by reciprocal.

.SH EXAMPLES

.nf
1. Convert 100 samples to time in ms, and the 10ms to a number of 
   samples, both at the default sample-rate of 20kHz. Then at a 
   sample-rate of 10kHz print the number of samples in 32ms.


convert to=ms 100p to=p 10ms samplerate=10kHz to=p 32ms
.fi

.nf
2. Convert 0.1 seconds to sample points.

convert -topoints 0.1sec
.fi

.SH COPYRIGHT
.LP
Copyright (c) Applied Psychology Unit, Medical Research Council, 1995
.LP
Permission to use, copy, modify, and distribute this software without fee 
is hereby granted for research purposes, provided that this copyright 
notice appears in all copies and in all supporting documentation, and that 
the software is not redistributed for any fee (except for a nominal 
shipping charge). Anyone wanting to incorporate all or part of this 
software in a commercial product must obtain a license from the Medical 
Research Council.
.LP
The MRC makes no representations about the suitability of this 
software for any purpose.  It is provided "as is" without express or 
implied warranty.
.LP
THE MRC DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING 
ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL 
THE A.P.U. BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES 
OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, 
WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, 
ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS 
SOFTWARE.