naginterfaces.library.lapacklin.zgeequ

naginterfaces.library.lapacklin.zgeequ(a)[source]

zgeequ computes real diagonal scaling matrices and intended to equilibrate a complex matrix and reduce its condition number.

For full information please refer to the NAG Library document for f07at

https://support.nag.com/numeric/nl/nagdoc_30.2/flhtml/f07/f07atf.html

Parameters
acomplex, array-like, shape

The matrix whose scaling factors are to be computed.

Returns
rfloat, ndarray, shape

If no exception or warning is raised or > , contains the row scale factors, the diagonal elements of . The elements of will be positive.

cfloat, ndarray, shape

If no exception or warning is raised, contains the column scale factors, the diagonal elements of . The elements of will be positive.

rowcndfloat

If no exception or warning is raised or > , contains the ratio of the smallest value of to the largest value of . If and is neither too large nor too small, it is not worth scaling by .

colcndfloat

If no exception or warning is raised, contains the ratio of the smallest value of to the largest value of .

If , it is not worth scaling by .

amaxfloat

. If is very close to overflow or underflow, the matrix should be scaled.

Raises
NagValueError
(errno )

On entry, error in parameter .

Constraint: .

(errno )

On entry, error in parameter .

Constraint: .

Warns
NagAlgorithmicWarning
(errno )

Row of is exactly zero.

(errno )

Column of is exactly zero.

Notes

zgeequ computes the diagonal scaling matrices. The diagonal scaling matrices are chosen to try to make the elements of largest absolute value in each row and column of the matrix given by

have absolute value . The diagonal elements of and are restricted to lie in the safe range , where is the value returned by function machine.real_safe. Use of these scaling factors is not guaranteed to reduce the condition number of but works well in practice.