heevr_2stage#

Functions

void cheevr_2stage(
    const char*          jobz,
    const char*          range,
    const char*          uplo,
    const INT            n,
          c64*  restrict A,
    const INT            lda,
    const f32            vl,
    const f32            vu,
    const INT            il,
    const INT            iu,
    const f32            abstol,
          INT*           m,
          f32*  restrict W,
          c64*  restrict Z,
    const INT            ldz,
          INT*  restrict isuppz,
          c64*  restrict work,
    const INT            lwork,
          f32*  restrict rwork,
    const INT            lrwork,
          INT*  restrict iwork,
    const INT            liwork,
          INT*           info
);
void cheevr_2stage(const char *jobz, const char *range, const char *uplo, const INT n, c64 *restrict A, const INT lda, const f32 vl, const f32 vu, const INT il, const INT iu, const f32 abstol, INT *m, f32 *restrict W, c64 *restrict Z, const INT ldz, INT *restrict isuppz, c64 *restrict work, const INT lwork, f32 *restrict rwork, const INT lrwork, INT *restrict iwork, const INT liwork, INT *info)#

CHEEVR_2STAGE computes selected eigenvalues and, optionally, eigenvectors of a complex Hermitian matrix A using the 2stage technique for the reduction to tridiagonal.

Eigenvalues and eigenvectors can be selected by specifying either a range of values or a range of indices for the desired eigenvalues.

Parameters

in
jobz

= ‘N’: eigenvalues only; = ‘V’: not available in this release.

in
range

= ‘A’: all eigenvalues; = ‘V’: eigenvalues in (vl,vu]; = ‘I’: il-th through iu-th eigenvalues.

in
uplo

= ‘U’: upper triangle stored; = ‘L’: lower triangle stored

in
n

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

inout
A

Hermitian matrix A. On exit, destroyed.

in
lda

Leading dimension of A. lda >= max(1, n).

in
vl

Lower bound if range=’V’.

in
vu

Upper bound if range=’V’. vl < vu.

in
il

Smallest eigenvalue index if range=’I’.

in
iu

Largest eigenvalue index if range=’I’.

in
abstol

Absolute error tolerance for eigenvalues.

out
m

Number of eigenvalues found.

out
W

Selected eigenvalues in ascending order.

out
Z

Eigenvectors if jobz=’V’; not referenced if jobz=’N’.

in
ldz

Leading dimension of Z. ldz >= 1, or ldz >= n if jobz=’V’.

out
isuppz

Support of eigenvectors in Z. Dimension (2*max(1,M)).

out
work

Complex workspace. On exit, work[0] = optimal LWORK.

in
lwork

Length of work. If -1, workspace query.

out
rwork

Single precision workspace. On exit, rwork[0] = optimal LRWORK.

in
lrwork

Length of rwork. If -1, workspace query.

out
iwork

Integer workspace. On exit, iwork[0] = optimal LIWORK.

in
liwork

Length of iwork. If -1, workspace query.

out
info

  • = 0: success; < 0: illegal argument; > 0: internal error.

Functions

void zheevr_2stage(
    const char*          jobz,
    const char*          range,
    const char*          uplo,
    const INT            n,
          c128* restrict A,
    const INT            lda,
    const f64            vl,
    const f64            vu,
    const INT            il,
    const INT            iu,
    const f64            abstol,
          INT*           m,
          f64*  restrict W,
          c128* restrict Z,
    const INT            ldz,
          INT*  restrict isuppz,
          c128* restrict work,
    const INT            lwork,
          f64*  restrict rwork,
    const INT            lrwork,
          INT*  restrict iwork,
    const INT            liwork,
          INT*           info
);
void zheevr_2stage(const char *jobz, const char *range, const char *uplo, const INT n, c128 *restrict A, const INT lda, const f64 vl, const f64 vu, const INT il, const INT iu, const f64 abstol, INT *m, f64 *restrict W, c128 *restrict Z, const INT ldz, INT *restrict isuppz, c128 *restrict work, const INT lwork, f64 *restrict rwork, const INT lrwork, INT *restrict iwork, const INT liwork, INT *info)#

ZHEEVR_2STAGE computes selected eigenvalues and, optionally, eigenvectors of a complex Hermitian matrix A using the 2stage technique for the reduction to tridiagonal.

Eigenvalues and eigenvectors can be selected by specifying either a range of values or a range of indices for the desired eigenvalues.

Parameters

in
jobz

= ‘N’: eigenvalues only; = ‘V’: not available in this release.

in
range

= ‘A’: all eigenvalues; = ‘V’: eigenvalues in (vl,vu]; = ‘I’: il-th through iu-th eigenvalues.

in
uplo

= ‘U’: upper triangle stored; = ‘L’: lower triangle stored

in
n

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

inout
A

Hermitian matrix A. On exit, destroyed.

in
lda

Leading dimension of A. lda >= max(1, n).

in
vl

Lower bound if range=’V’.

in
vu

Upper bound if range=’V’. vl < vu.

in
il

Smallest eigenvalue index if range=’I’.

in
iu

Largest eigenvalue index if range=’I’.

in
abstol

Absolute error tolerance for eigenvalues.

out
m

Number of eigenvalues found.

out
W

Selected eigenvalues in ascending order.

out
Z

Eigenvectors if jobz=’V’; not referenced if jobz=’N’.

in
ldz

Leading dimension of Z. ldz >= 1, or ldz >= n if jobz=’V’.

out
isuppz

Support of eigenvectors in Z. Dimension (2*max(1,M)).

out
work

Complex workspace. On exit, work[0] = optimal LWORK.

in
lwork

Length of work. If -1, workspace query.

out
rwork

Double precision workspace. On exit, rwork[0] = optimal LRWORK.

in
lrwork

Length of rwork. If -1, workspace query.

out
iwork

Integer workspace. On exit, iwork[0] = optimal LIWORK.

in
liwork

Length of iwork. If -1, workspace query.

out
info

  • = 0: success; < 0: illegal argument; > 0: internal error.