lmcovar(3)

LIBRARY ROUTINE
lmcovar - Compute the covariance matrix of a vector image

LIBRARY CALL
#include "vinclude.h"
int
lmcovar(image,covimage)
struct xvimage *image,**covimage;

INPUT

image
    pointer to xvimage structure to be processed

OUTPUT

covimage
    points to the result image. The data storage type is FLOAT and the image (actually matrix) is square symmetric and positive definate.

Return Value:
    1 on success, 0 on failure.

MODIFICATIONS

DESCRIPTION
lmcovar computes the maximum likelihood estimate of the covariance matrix describing the distribution of the vector data in the input image. The result is returned as a single band image containing the covariance matrix.

The input image must be of type FLOAT or BYTE. The output image is of type float, and is a square matrix with the number of columns equal to the number of bands in the input image.

Note that the argument covimage is a pointer to an xvimage pointer; the covariance image is attached to the pointer indicate by covimage so it is best to be sure that there is no image or memory attached to this pointer before calling lmcovar or that memory will be lost.

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

RESTRICTIONS
lmcovar works only on images of type FLOAT or BYTE.

AUTHOR
Scott Wilson

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