TMtx.EigSchure Method

Overload List

#SignatureDescription
1void EigSchure(TVec D, TMtx VS, TMtx T, TSelectTwoFunction dSelect, TSelectOneFunctionC zSelect, TSelectTwoFunctionSingle sSelect, TSelectOneFunctionSingleC cSelect)Computes eigenvalues and optionally Schure matrix
2void EigSchure(TVec D, TMtx VS, TMtx T, TVec rconde, TVec rcondv, TSelectTwoFunction dSelect, TSelectOneFunctionC zSelect, TSelectTwoFunctionSingle sSelect, TSelectOneFunctionSingleC cSelect)Computes eigenvalues and optionally Schure matrix

Overload 1: void EigSchure(TVec D, TMtx VS, TMtx T, TSelectTwoFunction dSelect, TSelectOneFunctionC zSelect, TSelectTwoFunctionSingle sSelect, TSelectOneFunctionSingleC cSelect)

Computes eigenvalues and optionally Schure matrix

#NameTypeDescription
1DTVecsource TVec
2VSTMtxsource TMtx
3TTMtxsource TMtx
4dSelectTSelectTwoFunction
5zSelectTSelectOneFunctionC
6sSelectTSelectTwoFunctionSingle
7cSelectTSelectOneFunctionSingleC

Result: stored in self (calling object)

Remarks:

Computes for an N-by-N nonsymmetric matrix A, the eigenvalues, the Schur form T, and, optionally, the matrix of Schur vectors VS. This gives the Schur factorization A = VS*T*(VS**H).

Optionally the routine also orders the eigenvalues on the diagonal of the Schur form so that selected eigenvalues are at the top left. The Select function parameters accepts a function with two parameters. First is the real and the second is the imaginary part of the eigenvalue. The function is to return true, if the specified eigenvalue is to be included in to sorting at the top left of the Schur form. If sorting is not required pass nil (NULL) for this parameter.

Overload 2: void EigSchure(TVec D, TMtx VS, TMtx T, TVec rconde, TVec rcondv, TSelectTwoFunction dSelect, TSelectOneFunctionC zSelect, TSelectTwoFunctionSingle sSelect, TSelectOneFunctionSingleC cSelect)

Computes eigenvalues and optionally Schure matrix

#NameTypeDescription
1DTVecsource TVec
2VSTMtxsource TMtx
3TTMtxsource TMtx
4rcondeTVecsource TVec
5rcondvTVecsource TVec
6dSelectTSelectTwoFunction
7zSelectTSelectOneFunctionC
8sSelectTSelectTwoFunctionSingle
9cSelectTSelectOneFunctionSingleC

Result: stored in self (calling object)

Remarks:

Computes for an N-by-N nonsymmetric matrix A, the eigenvalues, the Schur form T, and, optionally, the matrix of Schur vectors VS. This gives the Schur factorization A = VS*T*(VS**H).

Optionally, it also orders the eigenvalues on the diagonal of the Schur form so that selected eigenvalues are at the top left. If this is needed specify the Select function parameter and return true for each eigenvalue desired. Optionally computes a reciprocal condition number for the average of the selected eigenvalues (rconde[0]) and computes a reciprocal condition number for the right invariant subspace corresponding to the selected eigenvalues (rcondv[0]). The leading columns of VS form an orthonormal basis for this invariant subspace.