ILMatheig Method (InArraycomplex, OutArraycomplex, MatrixProperties, Boolean)

public static RetArray<complex> eig(
	InArray<complex> A,
	OutArray<complex> V,
	ref MatrixProperties propsA,
	bool balance
)

Public Shared Function eig ( 
	A As InArray(Of complex),
	V As OutArray(Of complex),
	ByRef propsA As MatrixProperties,
	balance As Boolean
) As RetArray(Of complex)

Dim A As InArray(Of complex)
Dim V As OutArray(Of complex)
Dim propsA As MatrixProperties
Dim balance As Boolean
Dim returnValue As RetArray(Of complex)

returnValue = ILMath.eig(A, V, propsA, 
	balance)

Parameters

A

Type: ILNumericsInArraycomplex
Input: square matrix, size [n x n].

V

Type: ILNumericsOutArraycomplex
[Optional] Output, matrix of eigenvectors of A. Size [n x n]. If null: do not compute. If not null on entry V returns the Eigenvectors.

propsA

Type: ILNumericsMatrixProperties
Matrix properties, on input - if specified, will be used to choose an advantageous path to the solution. On exit will be filled according to the properties of A (symmetric | hermitian).

balance

Type: SystemBoolean
True: permute A in order to increase the numerical stability, false: do not permute A.

Return Value

The eigenvalues of A are found by use of the Lapack functions dgeevx, sgeevx, cgeevx and zgeevx.

The matrices returned will be complex, since A may be nonsymmetric. Use eigSymm(InArraycomplex) for computing real eigenvalues of symmetric matrices.

Depending on the parameter balanceA will be balanced first. This includes permutations and scaling of A in order to improve the conditioning of the eigenvalues.

[ILNumerics Computing Engine]

Reference