MATRIX (kmatrix) functions
LIBRARY ROUTINE
lmsvd - compute singular value decomposition (SVD)
LIBRARY CALL
int lmsvd(
kobject in_obj,
kobject u_obj,
kobject s_obj,
kobject v_obj)
INPUT
- in_obj - input matrix object
OUTPUT
- u_obj - matrix object to receive the U matrix
kobject
- s_obj - matrix object to receive the S matrix
kobject
- v_obj - matrix object to receive the V matrix
RETURN VALUE
TRUE (1) on success, FALSE (0) otherwise
DESCRIPTION
lmsvd computes the singular value decomposition of a
general matrix, A=USVt, where U and V are orthogonal/unitary
and S is diagonal, real, and non-negative. Here, Vt means
transpose(V).
For MxN matrix A, U is MxM, S is MxN, and V is NxN where
the columns of U and V contain the left and right singular
vectors respectively and the diagonal elements of S are the
singular values in descending sorted order.
lmsvd uses the DGESVD and ZGESVD routines from LAPACK to
obtain the decomposition.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$MATRIX/objects/library/kmatrix/src/lmsvd.c
SEE ALSO
kmatrix(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.