IMAGE commands


PROGRAM NAME

igauss_func - Generate Gaussian Function Image

DESCRIPTION

igauss_func generates an image containing one or more 2-dimensional Gaussian functions. The image has dimensions of wsize*hsize and can have one of the following types,bit, byte, unsigned byte, short, unsigned short, integer, unsigned integer, long, unsigned long, float and double. The parameters for the Gaussian function can be specified directly if only one Gaussian is desired; if multiple Gaussians are desired, then the parameters are specified as a multiband (E=6) image. Six parameters need to be specified for each Gaussian function to be generated. These are in order: x and y coordinate of the peak of the function, variance along x and y direction, correlation coefficient, and the amplitude of the Gaussian function.

The correlation coefficient can range between -1 and 1. It represents the degree of correlation between the Gaussian functions along the 2 dimensions. A value of 1 implies perfect correlation whereas a value of 0 implies that the two variables are independent of each other.

For the multiple Gaussian case, the data vector of the parameter image must contain 6 elements (E dimension must be 6) denoting the parameters for the 2D Gaussian function, in the order indicated above.

If the normalization flag is set, the amplitude value for the Gaussian function is ignored.

If the parameter image contains a map segment, then the data is mapped through that segment before being read for supplying parameters. An error occurs if the parameter image contains a mask segment or if the parameter image does not have 6 bands of data.

REQUIRED ARGUMENTS

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

Mutually Exclusive Group; you must specify ONE of:

ALL OF the Mutually Inclusive Group:

-wpeak
type: integer
desc: Width coordinate for peak of 2D Gaussian function
default: 256
bounds: no range checking
AND
-hpeak
type: integer
desc: Height coordinate for peak of 2D Gaussian function
default: 256
bounds: no range checking
AND
-wvar
type: double
desc: Variance of the 2D Gaussian function along width
default: 1
bounds: value > 0.0
AND
-hvar
type: double
desc: Variance of the 2D Gaussian function along height
default: 1
bounds: value > 0.0
AND
-coeff
type: double
desc: Correlation coefficient for 2D Gaussian function
default: 0
bounds: -1 < [-coeff] < 1
AND
-peakval
type: double
desc: Peak value of the 2D Gaussian function
default: 1
bounds: no range checking

ALL OF the Mutually Inclusive Group:

-i
type: infile
desc: Input file of parameters for multiple Gaussian functions
default: {none}
AND
-norm
type: boolean
desc: Normalize amplitude of the Gaussian function
default: true

OPTIONAL ARGUMENTS

-wsize
type: integer
desc: Width of output image (number of columns)
default: 512
bounds: value > 0
-hsize
type: integer
desc: Height of output image (number of rows)
default: 512
bounds: value > 0
-type
type: list
desc: Data type of 2D Gaussian function data
default: 10 "float"

EXAMPLES

SEE ALSO

RESTRICTIONS

REFERENCES

COPYRIGHT

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