SRC/zhegs2.f(3)

NAME
SRC/zhegs2.f

SYNOPSIS

  Functions/Subroutines
subroutine zhegs2 (itype, uplo, n, a, lda, b, ldb, info)
ZHEGS2 reduces a Hermitian definite generalized eigenproblem to standard form, using the factorization results obtained from cpotrf (unblocked algorithm).

Function/Subroutine Documentation

  subroutine zhegs2 (integer itype, character uplo, integer n, complex*16, dimension( lda, * ) a, integer lda, complex*16, dimension( ldb, * ) b, integer ldb, integer info)

ZHEGS2 reduces a Hermitian definite generalized eigenproblem to standard form, using the factorization results obtained from cpotrf (unblocked algorithm).

Purpose:

    !>
    !> ZHEGS2 reduces a complex Hermitian-definite generalized
    !> eigenproblem to standard form.
    !>
    !> If ITYPE = 1, the problem is A*x = lambda*B*x,
    !> and A is overwritten by inv(U**H)*A*inv(U) or inv(L)*A*inv(L**H)
    !>
    !> If ITYPE = 2 or 3, the problem is A*B*x = lambda*x or
    !> B*A*x = lambda*x, and A is overwritten by U*A*U**H or L**H *A*L.
    !>
    !> B must have been previously factorized as U**H *U or L*L**H by ZPOTRF.
    !>

Parameters
    ITYPE

    !>          ITYPE is INTEGER
    !>          = 1: compute inv(U**H)*A*inv(U) or inv(L)*A*inv(L**H);
    !>          = 2 or 3: compute U*A*U**H or L**H *A*L.
    !>

    UPLO

    !>          UPLO is CHARACTER*1
    !>          Specifies whether the upper or lower triangular part of the
    !>          Hermitian matrix A is stored, and how B has been factorized.
    !>          = 'U':  Upper triangular
    !>          = 'L':  Lower triangular
    !>

    N

    !>          N is INTEGER
    !>          The order of the matrices A and B.  N >= 0.
    !>

    A

    !>          A is COMPLEX*16 array, dimension (LDA,N)
    !>          On entry, the Hermitian matrix A.  If UPLO = 'U', the leading
    !>          n by n upper triangular part of A contains the upper
    !>          triangular part of the matrix A, and the strictly lower
    !>          triangular part of A is not referenced.  If UPLO = 'L', the
    !>          leading n by n lower triangular part of A contains the lower
    !>          triangular part of the matrix A, and the strictly upper
    !>          triangular part of A is not referenced.
    !>
    !>          On exit, if INFO = 0, the transformed matrix, stored in the
    !>          same format as A.
    !>

    LDA

    !>          LDA is INTEGER
    !>          The leading dimension of the array A.  LDA >= max(1,N).
    !>

    B

    !>          B is COMPLEX*16 array, dimension (LDB,N)
    !>          The triangular factor from the Cholesky factorization of B,
    !>          as returned by ZPOTRF.
    !>          B is modified by the routine but restored on exit.
    !>

    LDB

    !>          LDB is INTEGER
    !>          The leading dimension of the array B.  LDB >= max(1,N).
    !>

    INFO

    !>          INFO is INTEGER
    !>          = 0:  successful exit.
    !>          < 0:  if INFO = -i, the i-th argument had an illegal value.
    !>

Author
    Univ. of Tennessee

    Univ. of California Berkeley

    Univ. of Colorado Denver

    NAG Ltd.

Definition at line 127 of file zhegs2.f.

Author

Generated automatically by Doxygen for LAPACK from the source code.