Advanced Analysis Library Only
AnalysisLibErrType CxSpecialMatrix (int matrixType, int matrixSize, ComplexNum inputArray1[], int sizeArray1, ComplexNum inputArray2[], int sizeArray2, void *outputMatrix);
Generates a special type of complex matrix depending on the value of matrixType. There are five possible matrix types: Identity, Diagonal, Toeplitz, Vandermonde, and Companion.
Input | ||||||||||||||||||||
Name | Type | Description | ||||||||||||||||||
matrixType | integer | Type of matrix to generate. The following table shows each matrix type and its behavior. Let n represent matrixSize, x represent inputArray1, nx represent sizeArray1, y represent inputArray2, ny represent sizeArray2, and B represent the outputMatrix.
|
||||||||||||||||||
matrixSize | integer | Number of rows and columns to generate when matrixType is Identity matrix. | ||||||||||||||||||
inputArray1 | ComplexNum array | Complex vector used to generate a Diagonal matrix, Toeplitz matrix, Vandermonde matrix, or Companion matrix. The following C typedef statement defines the ComplexNum structure:
typedef struct { |
||||||||||||||||||
sizeArray1 | integer | Number of elements in vector inputArray1. Because the first vector is used in constructing the Diagonal matrix, Toeplitz matrix, the Vandermonde matrix and the Companion matrix, sizeArray1 also determines the size of the generated matrix. |
||||||||||||||||||
inputArray2 | ComplexNum array | Second vector to use to generate the Toeplitz matrix. The following C typedef statement defines the ComplexNum structure:
typedef struct { |
||||||||||||||||||
sizeArray2 | integer | Number of elements in vector inputArray2. | ||||||||||||||||||
Output | ||||||||||||||||||||
Name | Type | Description | ||||||||||||||||||
outputMatrix | integer | Generated matrix as an array of ComplexNum. |
Name | Type | Description |
status | AnalysisLibErrType | A value that specifies the type of error that occurred. Refer to analysis.h for definitions of these constants. |