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.