# naginterfaces.library.lapacklin.zgecon¶

naginterfaces.library.lapacklin.zgecon(norm, a, anorm)[source]

zgecon estimates the condition number of a complex matrix , where has been factorized by zgetrf().

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

https://support.nag.com/numeric/nl/nagdoc_30.1/flhtml/f07/f07auf.html

Parameters
normstr, length 1

Indicates whether or is estimated.

or

is estimated.

is estimated.

acomplex, array-like, shape

The factorization of , as returned by zgetrf().

anormfloat

If or , the -norm of the original matrix .

If , the -norm of the original matrix .

may be computed by calling blas.zlange with the same value for the argument .

must be computed either before calling zgetrf() or else from a copy of the original matrix .

Returns
rcondfloat

An estimate of the reciprocal of the condition number of . is set to zero if exact singularity is detected or the estimate underflows. If is less than machine precision, is singular to working precision.

Raises
NagValueError
(errno )

On entry, error in parameter .

Constraint: , or .

(errno )

On entry, error in parameter .

Constraint: .

(errno )

On entry, error in parameter .

Constraint: .

Notes

zgecon estimates the condition number of a complex matrix , in either the -norm or the -norm:

Note that .

Because the condition number is infinite if is singular, the function actually returns an estimate of the reciprocal of the condition number.

The function should be preceded by a call to blas.zlange to compute or , and a call to zgetrf() to compute the factorization of . The function then uses Higham’s implementation of Hager’s method (see Higham (1988)) to estimate or .

References

Higham, N J, 1988, FORTRAN codes for estimating the one-norm of a real or complex matrix, with applications to condition estimation, ACM Trans. Math. Software (14), 381–396