mcovar(1)

PROGRAM
mcovar - Compute the covariance matrix of a vector image

SYNTAX

mcovar

-i  input image

-o  resulting output image

[-V]
    Gives the version for mcovar

[-U]
    Gives the usage for mcovar

[-P]
    Prompts for command line options

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

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

DESCRIPTION
mcovar computes the maximum likelihood estimate of the covariance matrix describing the distribution of the vector data in the input image. The result is a single band image containing the covariance matrix. The covariance matrix is symmetric and positive semidefinite.

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.

There is no dependence on the location of the vectors in the image data; an Nx1 matrix is just as good as NxM and 1x(N*M) matrices.

REQUIRED ARGUMENTS

-i  type: infile
    desc: input image

-o  type: outfile
    desc: resulting output image

OPTIONAL ARGUMENTS
none

EXAMPLES
mcovar -i vectors.xv -o covariance.xv

SEE ALSO
intro(1), verror(3), vgparms(3), vutils(3), lmcovar(3) vstats(1),deigen(1)

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

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