Advanced Analysis Library Only
AnalysisLibErrType CxSVDEx (void *inputMatrix, int numberOfRows, int numberOfColumns, int sizeOption, void *uMatrix, double singularValuesVector[], void *vMatrix);
Calculates the Singular Value Decomposition (SVD) factorization for a complex matrix, as follows: A = USVH. U is a column orthogonal matrix. That is, UHU = I, where I is the identity matrix, and UH is the conjugate transpose of U. S is a diagonal matrix whose diagonal elements are the singular values of A. V is also a column orthogonal matrix. That is, VHV = I, where VH is the conjugate transpose of V.
National Instruments recommends you use CxSVDEx for SVD operation instead of CxSVD. CxSVDEx can do full-size decomposition.
Input | ||
Name | Type | Description |
inputMatrix | numeric array | The matrix to be decomposed. |
numberOfRows | integer | The number of rows in inputMatrix. |
numberOfColumns | integer | The number of columns in inputMatrix. |
sizeOption | integer | The size option of SVD. sizeOption must one of the following values:
|
Output | ||
Name | Type | Description |
uMatrix | numeric array | The orthogonal matrix U. If uMatrix = NULL, only singular values are computed. |
singularValuesVector | double-precision array | The singular values, whose size is min(numberOfRows, numberOfColumns), in descending order. If you want only singular values, call CxSVDEx with either uMatrix = NULL or vMatrix = NULL. In this case, uMatrix and vMatrix are not referenced. |
vMatrix | numeric array | The orthogonal matrix V. If vMatrix = NULL, only singular values are computed. |
Name | Type | Description |
status | AnalysisLibErrType | A value that specifies the type of error that occurred. Refer to analysis.h for definitions of these constants. |