lvgauss(3)

LIBRARY ROUTINE
lvgauss - Create an image containing one or more Gaussians

LIBRARY CALL
#include "vinclude.h"
int
lvgauss(image,r,c,x,y,vx,vy,ra,amp,n,params)
int r,c,n;
float x,y,vx,vy,ra,amp;
struct xvimage *params,**image;

INPUT

OUTPUT

MODIFICATIONS

DESCRIPTION
vgauss generates and image that contains one or more Gaussian distributions. The bivariate mean and variance can be specified along with a (possibly normalized) amplitude and rotation angle between the major and minor axes of the isocontour ellipse. These parameters can be specified on the command line when only a single Gaussian is desired in the output image. When multiple Gaussians are desired, the parameters are specified in a multiband image where the number of vectors in the image controls the number of Gaussians to be generated.

For the multiple Gaussian case the parameters image should contain six bands: 1) X peak location, 2) Y peak location, 3) X variance, 4) Y variance, 5) Rotation Angle, 6) Peak amplitude. All six bands must be present and be in the above order.

If the normalize flag (-n) is set then the amplitude information (either from the command line of the parameter image) is ignored, and the proper amplitude is computed so that the Gaussian distribution is a probability distribution.

The rotation angle argument controls the correlation between the variables in the distribution. The correleation coefficient is the sine of this angle (in degrees). This angle must lie in the range of -90 < 0 < 90. Note that +/- 90 degrees are EXCLUDED from the range since this is a degenerate case.

If the parameter image is supplied then the values it contains, overrides all other distribution parameters except the normalize flag.

SEE ALSO
vgauss(1), intro(3), vipl(3), verror(3), vutils(3)

RESTRICTIONS

The output image is of type FLOAT.

AUTHOR
Scott Wilson

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