Previous: cgetrs Up: ../lapack-c.html Next: cggbal

cggbak

 NAME
      CGGBAK - form the right or left eigenvectors of the general-
      ized eigenvalue problem by backward transformation on the
      computed eigenvectors of the balanced matrix output by
      CGGBAL

 SYNOPSIS
      SUBROUTINE CGGBAK( JOB, SIDE, N, ILO, IHI, LSCALE, RSCALE,
                         M, E, LDE, INFO )

          CHARACTER      JOB, SIDE

          INTEGER        IHI, ILO, INFO, LDE, M, N

          REAL           LSCALE( * ), RSCALE( * )

          COMPLEX        E( LDE, * )

 PURPOSE
      CGGBAK forms the right or left eigenvectors of the general-
      ized eigenvalue problem by backward transformation on the
      computed eigenvectors of the balanced matrix output by
      CGGBAL.

 ARGUMENTS
      JOB     (input) CHARACTER*1
              Specifies the type of backward transformation
              required:
              = 'N':  do nothing, return immediately;
              = 'P':  do backward transformation for permutation
              only;
              = 'S':  do backward transformation for scaling only;
              = 'B':  do backward transformations for both permu-
              tation and scaling.  JOB must be the same as the
              argument JOB supplied to CGGBAL.

      SIDE    (input) CHARACTER*1
              = 'R':  E contains right eigenvectors;
              = 'L':  E contains left eigenvectors.

      N       (input) INTEGER
              The number of rows of the matrix E.  N >= 0.

      ILO     (input) INTEGER
              IHI     (input) INTEGER The integers ILO and IHI
              determined by CGGBAL.

      LSCALE  (input) REAL array, dimension (N)
              Details of the permutations and/or scaling factors
              applied to the left side of A and B, as returned by
              CGGBAL.

      RSCALE  (input) REAL array, dimension (N)
              Details of the permutations and/or scaling factors
              applied to the right side of A and B, as returned by
              CGGBAL.

      M       (input) INTEGER
              The number of columns of the matrix E.

      E       (input/output) COMPLEX array, dimension (LDE,M)
              On entry, the matrix of right or left eigenvectors
              to be transformed, as returned by CTGEVC.  On exit,
              E is overwritten by the transformed eigenvectors.

      LDE     (input) INTEGER
              The leading dimension of the matrix E. LDE >=
              max(1,N).

      INFO    (output) INTEGER
              = 0:  successful exit.
              < 0:  if INFO = -i, the i-th argument had an illegal
              value.

 FURTHER DETAILS
      See R.C. Ward, Balancing the generalized eigenvalue problem,
                     SIAM J. Sci. Stat. Comp. 2 (1981), 141-152.