CxSolveEqs
- Updated2023-02-21
- 2 minute(s) read
Advanced Analysis Library Only
AnalysisLibErrType CxSolveEqs (void *inputArray, ssize_t numberOfRows, ssize_t numberOfColumns, int matrixType, void *rightHandSideVectors, ssize_t numberOfRightHandVectors, void *outputArray);
Purpose
CxSolveEqs is a versatile complex linear equations solver that solves complex linear equations of the format AX = B.
National Instruments recommends you use this function instead of CxGenLinEqs. CxSolveEqs provides functionality in addition to the functionality CxGenLinEqs provides. CxSolveEqs supports in place operation if matrixType is not 0 (General matrix). That is, you can call the function with outputArray = NULL or outputArray = rightHandSideVectors so that the answer vector(s) overwrites rightHandSideVectors directly. Also, CxSolveEqs supports multiple right hand known vectors, whereas CxGenLinEqs supports only a single right hand known vector.
Parameters
| Input | ||
| Name | Type | Description |
| inputArray | void * | The coefficient matrix A. |
| numberOfRows | ssize_t | The number of rows in inputArray. |
| numberOfColumns | ssize_t | The number of columns in inputArray. |
| matrixType | int | The matrix type of inputArray. matrixType must be one of the following values:
|
| rightHandSideVectors | void * | The right-hand known vector(s). rightHandSideVectors is a matrix in a linear system with multiple right-hand known vectors. In this case, each column of rightHandSideVectors is a known vector. |
| numberOfRightHandVectors | ssize_t | The number of columns of rightHandSideVectors, which is the number of right-hand known vectors in AX = B. |
| Output | ||
| Name | Type | Description |
| outputArray | void * | The answer vector(s). |
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