lminfo(3)

LIBRARY ROUTINE
lminfo - obtain information about a matrix

LIBRARY CALL
#include "vinclude.h"
int lminfo(image,fptr)
  FILE *fptr;
  struct xvimage *image;

INPUT

image
    an image containg one or more matrices (one per band).

OUTPUT

Return Value:
    1 on success, 0 on failure.

MODIFICATIONS

Jeremy Worley 27 Jan 1992 09:57 MST
    Changed declaration of llminfo() to static int in lminfo().

Jeremy Worley 05 Mar 1992 08:44 MST
    Moved the static declaration of leigen into the includes section.

DESCRIPTION
obtain information about a matrix. The information output includes the matrix' dimensions, an estimate of its condition, its determinant if it is square, and its norm, "Euclidean norm", and 1-norm.

The condition of the matrix is determined by calculating the ratio of the largest and smallest singular values of the matrix.

The norm is defined as the largest singular value of the matrix. The 1-norm and Euclidean norm are obtained by selecting the max of the norms of the column vectors. The vector norm for the 1-norm is defined as the sum of the elements of the vector. For the Euclidean norm, the vector norm is defined as the square root of the sum of the squares of the elements of the vector (i.e. the n-space distance from the origin).

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

RESTRICTIONS

AUTHOR
Jeremy Worley

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