hbevd#

Functions

void chbevd(
    const char*          jobz,
    const char*          uplo,
    const INT            n,
    const INT            kd,
          c64*  restrict AB,
    const INT            ldab,
          f32*  restrict W,
          c64*  restrict Z,
    const INT            ldz,
          c64*  restrict work,
    const INT            lwork,
          f32*  restrict rwork,
    const INT            lrwork,
          INT*  restrict iwork,
    const INT            liwork,
          INT*           info
);
void chbevd(const char *jobz, const char *uplo, const INT n, const INT kd, c64 *restrict AB, const INT ldab, f32 *restrict W, c64 *restrict Z, const INT ldz, c64 *restrict work, const INT lwork, f32 *restrict rwork, const INT lrwork, INT *restrict iwork, const INT liwork, INT *info)#

CHBEVD computes all the eigenvalues and, optionally, eigenvectors of a complex Hermitian band matrix A.

If eigenvectors are desired, it uses a divide and conquer algorithm.

Parameters

in
jobz

= ‘N’: Compute eigenvalues only = ‘V’: Compute eigenvalues and eigenvectors

in
uplo

= ‘U’: Upper triangle of A is stored = ‘L’: Lower triangle of A is stored

in
n

The order of the matrix A. n >= 0.

in
kd

The number of super-diagonals (if uplo=’U’) or sub-diagonals (if uplo=’L’). kd >= 0.

inout
AB

The banded matrix A. Array of dimension (ldab, n).

in
ldab

The leading dimension of AB. ldab >= kd+1.

out
W

The eigenvalues in ascending order. Array of dimension (n).

out
Z

If jobz=’V’, the orthonormal eigenvectors. Array of dimension (ldz, n).

in
ldz

The leading dimension of Z. ldz >= 1, and >= n if jobz=’V’.

out
work

Complex workspace array of dimension (lwork).

in
lwork

The dimension of work. If lwork=-1, workspace query.

out
rwork

Single precision workspace array of dimension (lrwork).

in
lrwork

The dimension of rwork. If lrwork=-1, workspace query.

out
iwork

Integer workspace array of dimension (liwork).

in
liwork

The dimension of iwork. If liwork=-1, workspace query.

out
info

  • = 0: successful exit

  • < 0: if info = -i, the i-th argument had an illegal value

  • > 0: if info = i, the algorithm failed to converge

Functions

void zhbevd(
    const char*          jobz,
    const char*          uplo,
    const INT            n,
    const INT            kd,
          c128* restrict AB,
    const INT            ldab,
          f64*  restrict W,
          c128* restrict Z,
    const INT            ldz,
          c128* restrict work,
    const INT            lwork,
          f64*  restrict rwork,
    const INT            lrwork,
          INT*  restrict iwork,
    const INT            liwork,
          INT*           info
);
void zhbevd(const char *jobz, const char *uplo, const INT n, const INT kd, c128 *restrict AB, const INT ldab, f64 *restrict W, c128 *restrict Z, const INT ldz, c128 *restrict work, const INT lwork, f64 *restrict rwork, const INT lrwork, INT *restrict iwork, const INT liwork, INT *info)#

ZHBEVD computes all the eigenvalues and, optionally, eigenvectors of a complex Hermitian band matrix A.

If eigenvectors are desired, it uses a divide and conquer algorithm.

Parameters

in
jobz

= ‘N’: Compute eigenvalues only = ‘V’: Compute eigenvalues and eigenvectors

in
uplo

= ‘U’: Upper triangle of A is stored = ‘L’: Lower triangle of A is stored

in
n

The order of the matrix A. n >= 0.

in
kd

The number of super-diagonals (if uplo=’U’) or sub-diagonals (if uplo=’L’). kd >= 0.

inout
AB

The banded matrix A. Array of dimension (ldab, n).

in
ldab

The leading dimension of AB. ldab >= kd+1.

out
W

The eigenvalues in ascending order. Array of dimension (n).

out
Z

If jobz=’V’, the orthonormal eigenvectors. Array of dimension (ldz, n).

in
ldz

The leading dimension of Z. ldz >= 1, and >= n if jobz=’V’.

out
work

Complex workspace array of dimension (lwork).

in
lwork

The dimension of work. If lwork=-1, workspace query.

out
rwork

Double precision workspace array of dimension (lrwork).

in
lrwork

The dimension of rwork. If lrwork=-1, workspace query.

out
iwork

Integer workspace array of dimension (liwork).

in
liwork

The dimension of iwork. If liwork=-1, workspace query.

out
info

  • = 0: successful exit

  • < 0: if info = -i, the i-th argument had an illegal value

  • > 0: if info = i, the algorithm failed to converge

On this page

This Page