Overload List
Overload 1: void EigSymGen(TMtx *B, TVec *D, TMtx *V, TEigGenType EigGenType = TEigGenType::etAzBz) const;
Computes all the eigenvalues, and optionally, the eigenvectors of a generalized symmetric-definite eigenproblem.
| # | Name | Type | Description |
|---|---|---|---|
| 1 | B | TMtx * | |
| 2 | D | TVec * | |
| 3 | V | TMtx * | |
| 4 | EigGenType = TEigGenType::etAzBz | TEigGenType |
It can find solution to either of the following problems:
A X = lambda B X, A B X = lambda X, or B A X = lambda X
Here A and B are assumed to be symmetric (Hermitian) and B is also positive definite. Eigenvector are stored within V in columns.
Overload 2: void EigSymGen(TMtx *B, TVec *D, TEigGenType EigGenType = TEigGenType::etAzBz) const;
| # | Name | Type | Description |
|---|---|---|---|
| 1 | B | TMtx * | |
| 2 | D | TVec * | |
| 3 | EigGenType = TEigGenType::etAzBz | TEigGenType |
Overload 3: void EigSymGen(TMtx *B, TVec *D, double Minimum, double Maximum, TMtx *V, DewArray<int> &VInfo, double Tolerance = 0, TEigGenType EigGenType = TEigGenType::etAzBz) const;
Computes generalized eigenvalues with reduction of the symmetric-definite generalized eigenvalues/eigenvectors problem to the normal eigenvalue case.
| # | Name | Type | Description |
|---|---|---|---|
| 1 | B | TMtx * | |
| 2 | D | TVec * | |
| 3 | Minimum | double | |
| 4 | Maximum | double | |
| 5 | V | TMtx * | |
| 6 | VInfo | DewArray<int> & | |
| 7 | Tolerance = 0 | double | |
| 8 | EigGenType = TEigGenType::etAzBz | TEigGenType |
The routine computes selected eigenvalues and optionally also eigenvectors. The problem is of type:
A X = lambda B X, A B X = lambda X, or B A X = lambda X
A and B are symmetric (Hermitian) and B is also positive definite. Eigenvalues and eigenvectors can be selected by specifying a range of values. Eigenvectors are not computed, if V is passed as nil. (NULL).
Tolerance parameter specifies the absolute error tolerance for the eigenvalues. An approximate eigenvalue is accepted as converged when it is determined to lie in an interval [a,b] of width less than or equal to
Tolerance + EPS / max( |a|,|b| ) ,
where EPS is the machine precision. If Tolerance is less than or equal to zero, then EPS*|T| will be used in its place, where |T| is the 1-norm of the tridiagonal matrix obtained by reducing A to tridiagonal form.
Eigenvalues will be computed most accurately when Tolerance is set to twice the underflow threshold, not zero. If this routine returns fails , indicating that some eigenvectors did not converge, try setting Tolerance to 2*UnderflowThreshold.
If V is assinged, VInfo contains values equal to 0 at indices for which eigenvector calculation converged. Eigenvector are stored within V in columns. The returned column count may vary between calls depending on the number of eigenvectors that converged. The eigenvectors are normalized as follows:
etAzBz, etBAz, Z**T*B*Z = I; etABz , Z**T*inv(B)*Z = I.
[Lapack Users Guide](Lapack Users Guide)
Overload 4: void EigSymGen(TMtx *B, TVec *D, double Minimum, double Maximum, double Tolerance = 0, TEigGenType EigGenType = TEigGenType::etAzBz) const;
| # | Name | Type | Description |
|---|---|---|---|
| 1 | B | TMtx * | |
| 2 | D | TVec * | |
| 3 | Minimum | double | |
| 4 | Maximum | double | |
| 5 | Tolerance = 0 | double | |
| 6 | EigGenType = TEigGenType::etAzBz | TEigGenType |
Overload 5: void EigSymGen(TMtx *B, TVec *D, int LowerRange, int UpperRange, TMtx *V, DewArray<int> &VInfo, double Tolerance = 0, TEigGenType EigGenType = TEigGenType::etAzBz) const;
Computes generalized eigenvalues with reduction of the symmetric-definite generalized eigenvalues/eigenvectors problem to the normal eigenvalue case.
| # | Name | Type | Description |
|---|---|---|---|
| 1 | B | TMtx * | |
| 2 | D | TVec * | |
| 3 | LowerRange | int | |
| 4 | UpperRange | int | |
| 5 | V | TMtx * | |
| 6 | VInfo | DewArray<int> & | |
| 7 | Tolerance = 0 | double | |
| 8 | EigGenType = TEigGenType::etAzBz | TEigGenType |
The routine computes selected eigenvalues and optionally also eigenvectors. The problem is of type:
A X = lambda B X, A B X = lambda X, or B A X = lambda X
A and B are symmetric (Hermitian) and B is also positive definite. Eigenvalues and eigenvectors can be selected by specifying a range of indexes of values. Eigenvectors are not computed, if V is passed as nil (NULL).
Tolerance parameter specifies the absolute error tolerance for the eigenvalues. An approximate eigenvalue is accepted as converged when it is determined to lie in an interval [a,b] of width less than or equal to
Tolerance + EPS / max( |a|,|b| ) ,
where EPS is the machine precision. If Tolerance is less than or equal to zero, then EPS*|T| will be used in its place, where |T| is the 1-norm of the tridiagonal matrix obtained by reducing A to tridiagonal form.
Eigenvalues will be computed most accurately when Tolerance is set to twice the underflow threshold, not zero. If this routine returns fails , indicating that some eigenvectors did not converge, try setting Tolerance to 2*UnderflowThreshold.
If V is assinged, VInfo contains values equal to 0 at indices for which eigenvector calculation converged. Eigenvector are stored within V in columns. The returned column count may vary between calls depending on the number of eigenvectors that converged. The eigenvectors are normalized as follows:
etAzBz, etBAz, Z**T*B*Z = I; etABz , Z**T*inv(B)*Z = I.
Overload 6: void EigSymGen(TMtx *B, TVec *D, int LowerRange, int UpperRange, double Tolerance = 0, TEigGenType EigGenType = TEigGenType::etAzBz) const;
| # | Name | Type | Description |
|---|---|---|---|
| 1 | B | TMtx * | |
| 2 | D | TVec * | |
| 3 | LowerRange | int | |
| 4 | UpperRange | int | |
| 5 | Tolerance = 0 | double | |
| 6 | EigGenType = TEigGenType::etAzBz | TEigGenType |