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 byhave 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.