naginterfaces.library.lapackeig.zhetrd

naginterfaces.library.lapackeig.zhetrd(uplo, a)[source]

zhetrd reduces a complex Hermitian matrix to tridiagonal form.

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

https://support.nag.com/numeric/nl/nagdoc_30.2/flhtml/f08/f08fsf.html

Parameters
uplostr, length 1

Indicates whether the upper or lower triangular part of is stored.

The upper triangular part of is stored.

The lower triangular part of is stored.

acomplex, array-like, shape

The Hermitian matrix .

Returns
acomplex, ndarray, shape

is overwritten by the tridiagonal matrix and details of the unitary matrix as specified by .

dfloat, ndarray, shape

The diagonal elements of the tridiagonal matrix .

efloat, ndarray, shape

The off-diagonal elements of the tridiagonal matrix .

taucomplex, ndarray, shape

Further details of the unitary matrix .

Raises
NagValueError
(errno )

On entry, error in parameter .

Constraint: or .

(errno )

On entry, error in parameter .

Constraint: .

Notes

zhetrd reduces a complex Hermitian matrix to real symmetric tridiagonal form by a unitary similarity transformation: .

The matrix is not formed explicitly but is represented as a product of elementary reflectors (see the F08 Introduction for details). Functions are provided to work with in this representation (see Further Comments).

References

Golub, G H and Van Loan, C F, 1996, Matrix Computations, (3rd Edition), Johns Hopkins University Press, Baltimore