DATAMANIP commands


PROGRAM NAME

kgnoise - Generate Noise Data

DESCRIPTION

kgnoise generates noise of the specified type in the output data object (-o). kgnoise can generate the following kinds of noise: Gaussian, Rayleigh, Uniform, Poisson and Exponential. The appropriate parameters must be specified for the kind of noise being generated e.g. Mean & Variance for the Gaussian distribution and just the Variance for the Exponential distribution.

The size of all five dimensions of the object can be specified. The data type of the output object can also be specified. kgnoise can also generate complex valued noise data.

REQUIRED ARGUMENTS

-o
type: outfile
desc: Output file containing noise data

Mutually Exclusive Group; you must specify ONE of:

ALL OF the Mutually Inclusive Group:

-gauss
type: flag
desc: Generate Gaussian noise
AND
-gmean
type: double
desc: Mean for Gaussian noise
default: 0
bounds: no range checking
AND
-gvar
type: double
desc: Variance for Gaussian noise
default: 1
bounds: value > 0.0

ALL OF the Mutually Inclusive Group:

-ray
type: flag
desc: Generate Rayleigh Noise
AND
-rvar
type: double
desc: Variance for Rayleigh noise
default: 1
bounds: value > 0.0

ALL OF the Mutually Inclusive Group:

-unif
type: flag
desc: Generate uniformly distributed noise
AND
-umax
type: double
desc: Maximum value for uniform distribution
default: 1
bounds: no range checking
AND
-umin
type: double
desc: Minimum value for uniform noise
default: 0
bounds: no range checking

ALL OF the Mutually Inclusive Group:

-poiss
type: flag
desc: Generate Poisson Noise
AND
-ptime
type: double
desc: Amount of time
default: 1
bounds: value > 0.0
AND
-pvar
type: double
desc: Variance for Poisson distribution
default: 1
bounds: value > 0.0

ALL OF the Mutually Inclusive Group:

-exp
type: flag
desc: Generate exponential noise
AND
-evar
type: double
desc: Variance for exponential distribution
default: 1
bounds: value > 0.0

OPTIONAL ARGUMENTS

-wsize
type: integer
desc: Width size of noise value data
default: 512
bounds: value > 0
-hsize
type: integer
desc: Height size of noise value data
default: 512
bounds: value > 0
-dsize
type: integer
desc: Depth size of noise value data
default: 1
bounds: value > 0
-tsize
type: integer
desc: Time size of noise value data
default: 1
bounds: value > 0
-esize
type: integer
desc: Element dimension size of noise data
default: 1
bounds: value > 0
-type
type: list
desc: Data type of noise value data
default: 10 "float"

EXAMPLES

kgnoise -o random -wsize 512 -hsize 256 -esize 3 -type float -exp -evar 100

Creates a data object called random having width 512, height 256, depth 1, time 1 and 3 elements. The data storage type is float. The data object contains random data which is exponentially distributed and has a variance of 100.

SEE ALSO

RESTRICTIONS

REFERENCES

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.