
mcovar(1)                    Khoros                     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.

Khoros                    Release: 1.0                          1

