tomwalters@0
|
1 .TH NOISE 1 "1 September 1993"
|
tomwalters@0
|
2
|
tomwalters@0
|
3 .SH NAME
|
tomwalters@0
|
4 noise \- generate samples of a normally distributed deviate (white noise)
|
tomwalters@0
|
5 in binary shorts or floats.
|
tomwalters@0
|
6
|
tomwalters@0
|
7 .SH SYNTAX
|
tomwalters@0
|
8 noise [options]
|
tomwalters@0
|
9
|
tomwalters@0
|
10 .SH DESCRIPTION
|
tomwalters@0
|
11 Generate uniformly distributed numbers in the range [0,1] and then convert
|
tomwalters@0
|
12 these to normally distributed numbers with zero mean
|
tomwalters@0
|
13 and unit variance, using the Box-Muller method described in Numerical
|
tomwalters@0
|
14 Recipes [p203].
|
tomwalters@0
|
15 The period of the random sequences is claimed to be infinite,
|
tomwalters@0
|
16 [Numerical Recipes, p196].
|
tomwalters@0
|
17 The random sequence is written to the stdout in binary numbers which are
|
tomwalters@0
|
18 either shorts or floats depending upon the `type' option.
|
tomwalters@0
|
19 The `duration' options sets the duration of the output sequence in samples,
|
tomwalters@0
|
20 converted from time units (s or ms) using the given `samplerate' option.
|
tomwalters@0
|
21
|
tomwalters@0
|
22 .SH OPTIONS
|
tomwalters@0
|
23
|
tomwalters@0
|
24 1. mean, variance.
|
tomwalters@0
|
25
|
tomwalters@0
|
26 Each sample is scaled using the given mean and variance parameters so that
|
tomwalters@0
|
27 samples are drawn from a normal distribution of given mean and variance.
|
tomwalters@0
|
28
|
tomwalters@0
|
29 2. seed
|
tomwalters@0
|
30
|
tomwalters@0
|
31 When seed=off the system call getpid() is used to supply a new seed each run.
|
tomwalters@0
|
32 Otherwise the seed can be set in order to give the same initialization to
|
tomwalters@0
|
33 generate the same random sequence on different runs.
|
tomwalters@0
|
34
|
tomwalters@0
|
35 .SH COPYRIGHT
|
tomwalters@0
|
36 .LP
|
tomwalters@0
|
37 Copyright (c) Applied Psychology Unit, Medical Research Council, 1995
|
tomwalters@0
|
38 .LP
|
tomwalters@0
|
39 Permission to use, copy, modify, and distribute this software without fee
|
tomwalters@0
|
40 is hereby granted for research purposes, provided that this copyright
|
tomwalters@0
|
41 notice appears in all copies and in all supporting documentation, and that
|
tomwalters@0
|
42 the software is not redistributed for any fee (except for a nominal
|
tomwalters@0
|
43 shipping charge). Anyone wanting to incorporate all or part of this
|
tomwalters@0
|
44 software in a commercial product must obtain a license from the Medical
|
tomwalters@0
|
45 Research Council.
|
tomwalters@0
|
46 .LP
|
tomwalters@0
|
47 The MRC makes no representations about the suitability of this
|
tomwalters@0
|
48 software for any purpose. It is provided "as is" without express or
|
tomwalters@0
|
49 implied warranty.
|
tomwalters@0
|
50 .LP
|
tomwalters@0
|
51 THE MRC DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
|
tomwalters@0
|
52 ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
|
tomwalters@0
|
53 THE A.P.U. BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES
|
tomwalters@0
|
54 OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
|
tomwalters@0
|
55 WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
|
tomwalters@0
|
56 ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
|
tomwalters@0
|
57 SOFTWARE.
|
tomwalters@0
|
58
|