EigenVBack
Advanced Analysis Library Only
AnalysisLibErrType EigenVBack (void *inputEigenvectors, ssize_t numberOfEigenvectors, int side, int method, ssize_t indexLow, ssize_t indexHigh, double scale[], void *outputEigenvectors);
Purpose
Transforms the eigenvectors of a balanced matrix to those of the original matrix. If you want more accurate eigenvectors, complete the following steps:
- Balance the original matrix using MatrixBalance.
- Call GenEigenValueVector to get the eigenvectors of the balanced matrix.
- Call EigenVBack to back-transform the eigenvectors of the balanced matrix to the eigenvectors of the original matrix. Call CxEigenVBack if the eigenvectors are complex.
Parameters
| Input | ||
| Name | Type | Description |
| inputEigenvectors | void * | The eigenvectors of the balanced matrix. |
| numberOfEigenvectors | ssize_t | The order of inputEigenvectors. |
| side | int | Specifies whether inputEigenvectors contains right side eigenvectors or left side eigenvectors. side must be one of the following values:
|
| method | int | Specifies how the original matrix is balanced. Pass the same value for method that was passed to MatrixBalance when the original matrix was balanced. |
| indexLow | ssize_t | The permutation information from MatrixBalance. |
| indexHigh | ssize_t | The permutation information from MatrixBalance. |
| scale | double [] | The scale information from MatrixBalance. |
| Output | ||
| Name | Type | Description |
| outputEigenvectors | void * | The eigenvectors of the original matrix. If you call EigenVBack with outputEigenvectors = NULL or outputEigenvectors = inputEigenvectors, the back-transformed eigenvectors overwrite inputEigenvectors. |
Return Value
| Name | Type | Description |
| status | AnalysisLibErrType | A value that specifies the type of error that occurred. Refer to analysis.h for definitions of these constants. |
Additional Information
Library: Advanced Analysis Library
Include file: analysis.h
LabWindows/CVI compatibility: LabWindows/CVI 8.0 and later