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

OUTPUT

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.