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

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

.TH NOISE 1 "1 September 1993"

.SH NAME
noise \-   generate samples of a normally distributed deviate (white noise)
in binary shorts or floats.

.SH SYNTAX 
noise [options]

.SH DESCRIPTION
Generate uniformly distributed numbers in the range [0,1] and then convert
these to normally distributed numbers with zero mean
and unit variance, using the Box-Muller method described in Numerical
Recipes [p203].
The period of the random sequences is claimed to be infinite,
[Numerical Recipes, p196].
The random sequence is written to the stdout in binary numbers which are
either shorts or floats depending upon the `type' option.
The `duration' options sets the duration of the output sequence in samples,
converted from time units (s or ms) using the given `samplerate' option.

.SH OPTIONS

1. mean, variance.

Each sample is scaled using the given mean and variance parameters so that
samples are drawn from a normal distribution of given mean and variance.

2. seed

When seed=off the system call getpid() is used to supply a new seed each run.
Otherwise the seed can be set in order to give the same initialization to
generate the same random sequence on different runs.

.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.