tomwalters@0: .TH NOISE 1 "1 September 1993"
tomwalters@0: 
tomwalters@0: .SH NAME
tomwalters@0: noise \-   generate samples of a normally distributed deviate (white noise)
tomwalters@0: in binary shorts or floats.
tomwalters@0: 
tomwalters@0: .SH SYNTAX 
tomwalters@0: noise [options]
tomwalters@0: 
tomwalters@0: .SH DESCRIPTION
tomwalters@0: Generate uniformly distributed numbers in the range [0,1] and then convert
tomwalters@0: these to normally distributed numbers with zero mean
tomwalters@0: and unit variance, using the Box-Muller method described in Numerical
tomwalters@0: Recipes [p203].
tomwalters@0: The period of the random sequences is claimed to be infinite,
tomwalters@0: [Numerical Recipes, p196].
tomwalters@0: The random sequence is written to the stdout in binary numbers which are
tomwalters@0: either shorts or floats depending upon the `type' option.
tomwalters@0: The `duration' options sets the duration of the output sequence in samples,
tomwalters@0: converted from time units (s or ms) using the given `samplerate' option.
tomwalters@0: 
tomwalters@0: .SH OPTIONS
tomwalters@0: 
tomwalters@0: 1. mean, variance.
tomwalters@0: 
tomwalters@0: Each sample is scaled using the given mean and variance parameters so that
tomwalters@0: samples are drawn from a normal distribution of given mean and variance.
tomwalters@0: 
tomwalters@0: 2. seed
tomwalters@0: 
tomwalters@0: When seed=off the system call getpid() is used to supply a new seed each run.
tomwalters@0: Otherwise the seed can be set in order to give the same initialization to
tomwalters@0: generate the same random sequence on different runs.
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: