
vggauss(1)                   Khoros                    vggauss(1)

PROGRAM
     vggauss - Creates a Gaussian (noise) image.

SYNTAX
     vggauss

     -o             resulting image

     [-i]           input file

     [-trigger]     trigger input

     [-r]           rows of image

     [-c]           columns of image

     [-b]           # bands in image

     [-m]           noise mean value

     [-v]           noise variance

     [-t]           lets user choose data type of image:
                     'float' (select data type),
                      or 'complex' (byte data type)
                       [default = float]

     [-V]           Gives the version for vggauss

     [-U]           Gives the usage for vggauss

     [-P]           Prompts for command line options

     [-A [file1]]   Creates the answer file called vggauss.ans or
                    file1

     [-a [file1]]   Uses vggauss.ans or file1 as the answer file

DESCRIPTION
     creates a two dimensional multi-band Gaussian (noise) image
     of dimension rows * columns or adds noise to the optional
     input image. The Gaussian image is generated using the Box-
     Muller transformation.

     The trigger input can be used to cause vggauss to re-execute
     when used inside cantata. No image is read from this input.

REQUIRED ARGUMENTS
     -o     type: outfile
            desc: resulting image

OPTIONAL ARGUMENTS
     -i     type: infile
            desc: input file

     -trigger
            type: infile
            desc: trigger input

     -r     type: integer
            desc: rows of image
            default: 512
            bounds: value > 0

     -c     type: integer
            desc: columns of image
            default: 512
            bounds: value > 0

     -b     type: integer
            desc: # bands in image
            default: 1
            bounds: value > 0

     -m     type: float
            desc: noise mean value
            default: 0
            bounds: value >= 0.0

     -v     type: float
            desc: noise variance
            default: 1
            bounds: value >= 0.0

     -t     type: string
            desc: lets user choose data type of image
            allowed values:
             'float' (select data type),
              or 'complex' (byte data type)

EXAMPLES
     vggauss -o gnoise.xv -r 256 -c 512 -m 4.0 -t complex

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lvggauss(3)

RESTRICTIONS
     can only generate VFF_TYP_FLOAT and VFF_TYP_COMPLEX type
     images.

COPYRIGHT
     Copyright 1991, University of New Mexico.  All rights
     reserved.

Khoros                    Release: 1.0                          1

