tomwalters@0: .TH CONVERT 1 "15 September 1993"
tomwalters@0: 
tomwalters@0: .SH NAME
tomwalters@0: convert \- Convert units: frequency, time, and sample numbers.  
tomwalters@0: 
tomwalters@0: .SH SYNTAX 
tomwalters@0: convert [options] arguments
tomwalters@0: 
tomwalters@0: 
tomwalters@0: .SH DESCRIPTION
tomwalters@0: Convert time to samples and vice verca. Options of the general form:
tomwalters@0: 
tomwalters@0:         -to<units>  |  to=<units>
tomwalters@0: 
tomwalters@0: may be intersperced with arguments, which are treated as values to convert
tomwalters@0: into the units given by the previous option on the command line.
tomwalters@0: Time in seconds or milliseconds is converted to and from sample points using
tomwalters@0: the given samplerate. Time (in seconds, miliseconds or samples) is converted
tomwalters@0: to and from frequency by reciprocal.
tomwalters@0: 
tomwalters@0: .SH EXAMPLES
tomwalters@0: 
tomwalters@0: .nf
tomwalters@0: 1. Convert 100 samples to time in ms, and the 10ms to a number of 
tomwalters@0:    samples, both at the default sample-rate of 20kHz. Then at a 
tomwalters@0:    sample-rate of 10kHz print the number of samples in 32ms.
tomwalters@0: 
tomwalters@0: 
tomwalters@0: convert to=ms 100p to=p 10ms samplerate=10kHz to=p 32ms
tomwalters@0: .fi
tomwalters@0: 
tomwalters@0: .nf
tomwalters@0: 2. Convert 0.1 seconds to sample points.
tomwalters@0: 
tomwalters@0: convert -topoints 0.1sec
tomwalters@0: .fi
tomwalters@0: 
tomwalters@0: .SH COPYRIGHT
tomwalters@0: .LP
tomwalters@0: Copyright (c) Applied Psychology Unit, Medical Research Council, 1995
tomwalters@0: .LP
tomwalters@0: Permission to use, copy, modify, and distribute this software without fee 
tomwalters@0: is hereby granted for research purposes, provided that this copyright 
tomwalters@0: notice appears in all copies and in all supporting documentation, and that 
tomwalters@0: the software is not redistributed for any fee (except for a nominal 
tomwalters@0: shipping charge). Anyone wanting to incorporate all or part of this 
tomwalters@0: software in a commercial product must obtain a license from the Medical 
tomwalters@0: Research Council.
tomwalters@0: .LP
tomwalters@0: The MRC makes no representations about the suitability of this 
tomwalters@0: software for any purpose.  It is provided "as is" without express or 
tomwalters@0: implied warranty.
tomwalters@0: .LP
tomwalters@0: THE MRC DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING 
tomwalters@0: ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL 
tomwalters@0: THE A.P.U. BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES 
tomwalters@0: OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, 
tomwalters@0: WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, 
tomwalters@0: ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS 
tomwalters@0: SOFTWARE.
tomwalters@0: