File:  [local] / rpl / lapack / lapack / dgges3.f
Revision 1.5: download - view: text, annotated - select for diffs - revision graph
Mon Aug 7 08:38:50 2023 UTC (9 months ago) by bertrand
Branches: MAIN
CVS tags: rpl-4_1_35, rpl-4_1_34, HEAD
Première mise à jour de lapack et blas.

    1: *> \brief <b> DGGES3 computes the eigenvalues, the Schur form, and, optionally, the matrix of Schur vectors for GE matrices (blocked algorithm)</b>
    2: *
    3: *  =========== DOCUMENTATION ===========
    4: *
    5: * Online html documentation available at
    6: *            http://www.netlib.org/lapack/explore-html/
    7: *
    8: *> \htmlonly
    9: *> Download DGGES3 + dependencies
   10: *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.tgz?format=tgz&filename=/lapack/lapack_routine/dgges3.f">
   11: *> [TGZ]</a>
   12: *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.zip?format=zip&filename=/lapack/lapack_routine/dgges3.f">
   13: *> [ZIP]</a>
   14: *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.txt?format=txt&filename=/lapack/lapack_routine/dgges3.f">
   15: *> [TXT]</a>
   16: *> \endhtmlonly
   17: *
   18: *  Definition:
   19: *  ===========
   20: *
   21: *       SUBROUTINE DGGES3( JOBVSL, JOBVSR, SORT, SELCTG, N, A, LDA, B, LDB,
   22: *                          SDIM, ALPHAR, ALPHAI, BETA, VSL, LDVSL, VSR,
   23: *                          LDVSR, WORK, LWORK, BWORK, INFO )
   24: *
   25: *       .. Scalar Arguments ..
   26: *       CHARACTER          JOBVSL, JOBVSR, SORT
   27: *       INTEGER            INFO, LDA, LDB, LDVSL, LDVSR, LWORK, N, SDIM
   28: *       ..
   29: *       .. Array Arguments ..
   30: *       LOGICAL            BWORK( * )
   31: *       DOUBLE PRECISION   A( LDA, * ), ALPHAI( * ), ALPHAR( * ),
   32: *      $                   B( LDB, * ), BETA( * ), VSL( LDVSL, * ),
   33: *      $                   VSR( LDVSR, * ), WORK( * )
   34: *       ..
   35: *       .. Function Arguments ..
   36: *       LOGICAL            SELCTG
   37: *       EXTERNAL           SELCTG
   38: *       ..
   39: *
   40: *
   41: *> \par Purpose:
   42: *  =============
   43: *>
   44: *> \verbatim
   45: *>
   46: *> DGGES3 computes for a pair of N-by-N real nonsymmetric matrices (A,B),
   47: *> the generalized eigenvalues, the generalized real Schur form (S,T),
   48: *> optionally, the left and/or right matrices of Schur vectors (VSL and
   49: *> VSR). This gives the generalized Schur factorization
   50: *>
   51: *>          (A,B) = ( (VSL)*S*(VSR)**T, (VSL)*T*(VSR)**T )
   52: *>
   53: *> Optionally, it also orders the eigenvalues so that a selected cluster
   54: *> of eigenvalues appears in the leading diagonal blocks of the upper
   55: *> quasi-triangular matrix S and the upper triangular matrix T.The
   56: *> leading columns of VSL and VSR then form an orthonormal basis for the
   57: *> corresponding left and right eigenspaces (deflating subspaces).
   58: *>
   59: *> (If only the generalized eigenvalues are needed, use the driver
   60: *> DGGEV instead, which is faster.)
   61: *>
   62: *> A generalized eigenvalue for a pair of matrices (A,B) is a scalar w
   63: *> or a ratio alpha/beta = w, such that  A - w*B is singular.  It is
   64: *> usually represented as the pair (alpha,beta), as there is a
   65: *> reasonable interpretation for beta=0 or both being zero.
   66: *>
   67: *> A pair of matrices (S,T) is in generalized real Schur form if T is
   68: *> upper triangular with non-negative diagonal and S is block upper
   69: *> triangular with 1-by-1 and 2-by-2 blocks.  1-by-1 blocks correspond
   70: *> to real generalized eigenvalues, while 2-by-2 blocks of S will be
   71: *> "standardized" by making the corresponding elements of T have the
   72: *> form:
   73: *>         [  a  0  ]
   74: *>         [  0  b  ]
   75: *>
   76: *> and the pair of corresponding 2-by-2 blocks in S and T will have a
   77: *> complex conjugate pair of generalized eigenvalues.
   78: *>
   79: *> \endverbatim
   80: *
   81: *  Arguments:
   82: *  ==========
   83: *
   84: *> \param[in] JOBVSL
   85: *> \verbatim
   86: *>          JOBVSL is CHARACTER*1
   87: *>          = 'N':  do not compute the left Schur vectors;
   88: *>          = 'V':  compute the left Schur vectors.
   89: *> \endverbatim
   90: *>
   91: *> \param[in] JOBVSR
   92: *> \verbatim
   93: *>          JOBVSR is CHARACTER*1
   94: *>          = 'N':  do not compute the right Schur vectors;
   95: *>          = 'V':  compute the right Schur vectors.
   96: *> \endverbatim
   97: *>
   98: *> \param[in] SORT
   99: *> \verbatim
  100: *>          SORT is CHARACTER*1
  101: *>          Specifies whether or not to order the eigenvalues on the
  102: *>          diagonal of the generalized Schur form.
  103: *>          = 'N':  Eigenvalues are not ordered;
  104: *>          = 'S':  Eigenvalues are ordered (see SELCTG);
  105: *> \endverbatim
  106: *>
  107: *> \param[in] SELCTG
  108: *> \verbatim
  109: *>          SELCTG is a LOGICAL FUNCTION of three DOUBLE PRECISION arguments
  110: *>          SELCTG must be declared EXTERNAL in the calling subroutine.
  111: *>          If SORT = 'N', SELCTG is not referenced.
  112: *>          If SORT = 'S', SELCTG is used to select eigenvalues to sort
  113: *>          to the top left of the Schur form.
  114: *>          An eigenvalue (ALPHAR(j)+ALPHAI(j))/BETA(j) is selected if
  115: *>          SELCTG(ALPHAR(j),ALPHAI(j),BETA(j)) is true; i.e. if either
  116: *>          one of a complex conjugate pair of eigenvalues is selected,
  117: *>          then both complex eigenvalues are selected.
  118: *>
  119: *>          Note that in the ill-conditioned case, a selected complex
  120: *>          eigenvalue may no longer satisfy SELCTG(ALPHAR(j),ALPHAI(j),
  121: *>          BETA(j)) = .TRUE. after ordering. INFO is to be set to N+2
  122: *>          in this case.
  123: *> \endverbatim
  124: *>
  125: *> \param[in] N
  126: *> \verbatim
  127: *>          N is INTEGER
  128: *>          The order of the matrices A, B, VSL, and VSR.  N >= 0.
  129: *> \endverbatim
  130: *>
  131: *> \param[in,out] A
  132: *> \verbatim
  133: *>          A is DOUBLE PRECISION array, dimension (LDA, N)
  134: *>          On entry, the first of the pair of matrices.
  135: *>          On exit, A has been overwritten by its generalized Schur
  136: *>          form S.
  137: *> \endverbatim
  138: *>
  139: *> \param[in] LDA
  140: *> \verbatim
  141: *>          LDA is INTEGER
  142: *>          The leading dimension of A.  LDA >= max(1,N).
  143: *> \endverbatim
  144: *>
  145: *> \param[in,out] B
  146: *> \verbatim
  147: *>          B is DOUBLE PRECISION array, dimension (LDB, N)
  148: *>          On entry, the second of the pair of matrices.
  149: *>          On exit, B has been overwritten by its generalized Schur
  150: *>          form T.
  151: *> \endverbatim
  152: *>
  153: *> \param[in] LDB
  154: *> \verbatim
  155: *>          LDB is INTEGER
  156: *>          The leading dimension of B.  LDB >= max(1,N).
  157: *> \endverbatim
  158: *>
  159: *> \param[out] SDIM
  160: *> \verbatim
  161: *>          SDIM is INTEGER
  162: *>          If SORT = 'N', SDIM = 0.
  163: *>          If SORT = 'S', SDIM = number of eigenvalues (after sorting)
  164: *>          for which SELCTG is true.  (Complex conjugate pairs for which
  165: *>          SELCTG is true for either eigenvalue count as 2.)
  166: *> \endverbatim
  167: *>
  168: *> \param[out] ALPHAR
  169: *> \verbatim
  170: *>          ALPHAR is DOUBLE PRECISION array, dimension (N)
  171: *> \endverbatim
  172: *>
  173: *> \param[out] ALPHAI
  174: *> \verbatim
  175: *>          ALPHAI is DOUBLE PRECISION array, dimension (N)
  176: *> \endverbatim
  177: *>
  178: *> \param[out] BETA
  179: *> \verbatim
  180: *>          BETA is DOUBLE PRECISION array, dimension (N)
  181: *>          On exit, (ALPHAR(j) + ALPHAI(j)*i)/BETA(j), j=1,...,N, will
  182: *>          be the generalized eigenvalues.  ALPHAR(j) + ALPHAI(j)*i,
  183: *>          and  BETA(j),j=1,...,N are the diagonals of the complex Schur
  184: *>          form (S,T) that would result if the 2-by-2 diagonal blocks of
  185: *>          the real Schur form of (A,B) were further reduced to
  186: *>          triangular form using 2-by-2 complex unitary transformations.
  187: *>          If ALPHAI(j) is zero, then the j-th eigenvalue is real; if
  188: *>          positive, then the j-th and (j+1)-st eigenvalues are a
  189: *>          complex conjugate pair, with ALPHAI(j+1) negative.
  190: *>
  191: *>          Note: the quotients ALPHAR(j)/BETA(j) and ALPHAI(j)/BETA(j)
  192: *>          may easily over- or underflow, and BETA(j) may even be zero.
  193: *>          Thus, the user should avoid naively computing the ratio.
  194: *>          However, ALPHAR and ALPHAI will be always less than and
  195: *>          usually comparable with norm(A) in magnitude, and BETA always
  196: *>          less than and usually comparable with norm(B).
  197: *> \endverbatim
  198: *>
  199: *> \param[out] VSL
  200: *> \verbatim
  201: *>          VSL is DOUBLE PRECISION array, dimension (LDVSL,N)
  202: *>          If JOBVSL = 'V', VSL will contain the left Schur vectors.
  203: *>          Not referenced if JOBVSL = 'N'.
  204: *> \endverbatim
  205: *>
  206: *> \param[in] LDVSL
  207: *> \verbatim
  208: *>          LDVSL is INTEGER
  209: *>          The leading dimension of the matrix VSL. LDVSL >=1, and
  210: *>          if JOBVSL = 'V', LDVSL >= N.
  211: *> \endverbatim
  212: *>
  213: *> \param[out] VSR
  214: *> \verbatim
  215: *>          VSR is DOUBLE PRECISION array, dimension (LDVSR,N)
  216: *>          If JOBVSR = 'V', VSR will contain the right Schur vectors.
  217: *>          Not referenced if JOBVSR = 'N'.
  218: *> \endverbatim
  219: *>
  220: *> \param[in] LDVSR
  221: *> \verbatim
  222: *>          LDVSR is INTEGER
  223: *>          The leading dimension of the matrix VSR. LDVSR >= 1, and
  224: *>          if JOBVSR = 'V', LDVSR >= N.
  225: *> \endverbatim
  226: *>
  227: *> \param[out] WORK
  228: *> \verbatim
  229: *>          WORK is DOUBLE PRECISION array, dimension (MAX(1,LWORK))
  230: *>          On exit, if INFO = 0, WORK(1) returns the optimal LWORK.
  231: *> \endverbatim
  232: *>
  233: *> \param[in] LWORK
  234: *> \verbatim
  235: *>          LWORK is INTEGER
  236: *>          The dimension of the array WORK.
  237: *>
  238: *>          If LWORK = -1, then a workspace query is assumed; the routine
  239: *>          only calculates the optimal size of the WORK array, returns
  240: *>          this value as the first entry of the WORK array, and no error
  241: *>          message related to LWORK is issued by XERBLA.
  242: *> \endverbatim
  243: *>
  244: *> \param[out] BWORK
  245: *> \verbatim
  246: *>          BWORK is LOGICAL array, dimension (N)
  247: *>          Not referenced if SORT = 'N'.
  248: *> \endverbatim
  249: *>
  250: *> \param[out] INFO
  251: *> \verbatim
  252: *>          INFO is INTEGER
  253: *>          = 0:  successful exit
  254: *>          < 0:  if INFO = -i, the i-th argument had an illegal value.
  255: *>          = 1,...,N:
  256: *>                The QZ iteration failed.  (A,B) are not in Schur
  257: *>                form, but ALPHAR(j), ALPHAI(j), and BETA(j) should
  258: *>                be correct for j=INFO+1,...,N.
  259: *>          > N:  =N+1: other than QZ iteration failed in DLAQZ0.
  260: *>                =N+2: after reordering, roundoff changed values of
  261: *>                      some complex eigenvalues so that leading
  262: *>                      eigenvalues in the Generalized Schur form no
  263: *>                      longer satisfy SELCTG=.TRUE.  This could also
  264: *>                      be caused due to scaling.
  265: *>                =N+3: reordering failed in DTGSEN.
  266: *> \endverbatim
  267: *
  268: *  Authors:
  269: *  ========
  270: *
  271: *> \author Univ. of Tennessee
  272: *> \author Univ. of California Berkeley
  273: *> \author Univ. of Colorado Denver
  274: *> \author NAG Ltd.
  275: *
  276: *> \ingroup doubleGEeigen
  277: *
  278: *  =====================================================================
  279:       SUBROUTINE DGGES3( JOBVSL, JOBVSR, SORT, SELCTG, N, A, LDA, B,
  280:      $                   LDB, SDIM, ALPHAR, ALPHAI, BETA, VSL, LDVSL,
  281:      $                   VSR, LDVSR, WORK, LWORK, BWORK, INFO )
  282: *
  283: *  -- LAPACK driver routine --
  284: *  -- LAPACK is a software package provided by Univ. of Tennessee,    --
  285: *  -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..--
  286: *
  287: *     .. Scalar Arguments ..
  288:       CHARACTER          JOBVSL, JOBVSR, SORT
  289:       INTEGER            INFO, LDA, LDB, LDVSL, LDVSR, LWORK, N, SDIM
  290: *     ..
  291: *     .. Array Arguments ..
  292:       LOGICAL            BWORK( * )
  293:       DOUBLE PRECISION   A( LDA, * ), ALPHAI( * ), ALPHAR( * ),
  294:      $                   B( LDB, * ), BETA( * ), VSL( LDVSL, * ),
  295:      $                   VSR( LDVSR, * ), WORK( * )
  296: *     ..
  297: *     .. Function Arguments ..
  298:       LOGICAL            SELCTG
  299:       EXTERNAL           SELCTG
  300: *     ..
  301: *
  302: *  =====================================================================
  303: *
  304: *     .. Parameters ..
  305:       DOUBLE PRECISION   ZERO, ONE
  306:       PARAMETER          ( ZERO = 0.0D+0, ONE = 1.0D+0 )
  307: *     ..
  308: *     .. Local Scalars ..
  309:       LOGICAL            CURSL, ILASCL, ILBSCL, ILVSL, ILVSR, LASTSL,
  310:      $                   LQUERY, LST2SL, WANTST
  311:       INTEGER            I, ICOLS, IERR, IHI, IJOBVL, IJOBVR, ILEFT,
  312:      $                   ILO, IP, IRIGHT, IROWS, ITAU, IWRK, LWKOPT
  313:       DOUBLE PRECISION   ANRM, ANRMTO, BIGNUM, BNRM, BNRMTO, EPS, PVSL,
  314:      $                   PVSR, SAFMAX, SAFMIN, SMLNUM
  315: *     ..
  316: *     .. Local Arrays ..
  317:       INTEGER            IDUM( 1 )
  318:       DOUBLE PRECISION   DIF( 2 )
  319: *     ..
  320: *     .. External Subroutines ..
  321:       EXTERNAL           DGEQRF, DGGBAK, DGGBAL, DGGHD3, DLAQZ0, DLABAD,
  322:      $                   DLACPY, DLASCL, DLASET, DORGQR, DORMQR, DTGSEN,
  323:      $                   XERBLA
  324: *     ..
  325: *     .. External Functions ..
  326:       LOGICAL            LSAME
  327:       DOUBLE PRECISION   DLAMCH, DLANGE
  328:       EXTERNAL           LSAME, DLAMCH, DLANGE
  329: *     ..
  330: *     .. Intrinsic Functions ..
  331:       INTRINSIC          ABS, MAX, SQRT
  332: *     ..
  333: *     .. Executable Statements ..
  334: *
  335: *     Decode the input arguments
  336: *
  337:       IF( LSAME( JOBVSL, 'N' ) ) THEN
  338:          IJOBVL = 1
  339:          ILVSL = .FALSE.
  340:       ELSE IF( LSAME( JOBVSL, 'V' ) ) THEN
  341:          IJOBVL = 2
  342:          ILVSL = .TRUE.
  343:       ELSE
  344:          IJOBVL = -1
  345:          ILVSL = .FALSE.
  346:       END IF
  347: *
  348:       IF( LSAME( JOBVSR, 'N' ) ) THEN
  349:          IJOBVR = 1
  350:          ILVSR = .FALSE.
  351:       ELSE IF( LSAME( JOBVSR, 'V' ) ) THEN
  352:          IJOBVR = 2
  353:          ILVSR = .TRUE.
  354:       ELSE
  355:          IJOBVR = -1
  356:          ILVSR = .FALSE.
  357:       END IF
  358: *
  359:       WANTST = LSAME( SORT, 'S' )
  360: *
  361: *     Test the input arguments
  362: *
  363:       INFO = 0
  364:       LQUERY = ( LWORK.EQ.-1 )
  365:       IF( IJOBVL.LE.0 ) THEN
  366:          INFO = -1
  367:       ELSE IF( IJOBVR.LE.0 ) THEN
  368:          INFO = -2
  369:       ELSE IF( ( .NOT.WANTST ) .AND. ( .NOT.LSAME( SORT, 'N' ) ) ) THEN
  370:          INFO = -3
  371:       ELSE IF( N.LT.0 ) THEN
  372:          INFO = -5
  373:       ELSE IF( LDA.LT.MAX( 1, N ) ) THEN
  374:          INFO = -7
  375:       ELSE IF( LDB.LT.MAX( 1, N ) ) THEN
  376:          INFO = -9
  377:       ELSE IF( LDVSL.LT.1 .OR. ( ILVSL .AND. LDVSL.LT.N ) ) THEN
  378:          INFO = -15
  379:       ELSE IF( LDVSR.LT.1 .OR. ( ILVSR .AND. LDVSR.LT.N ) ) THEN
  380:          INFO = -17
  381:       ELSE IF( LWORK.LT.6*N+16 .AND. .NOT.LQUERY ) THEN
  382:          INFO = -19
  383:       END IF
  384: *
  385: *     Compute workspace
  386: *
  387:       IF( INFO.EQ.0 ) THEN
  388:          CALL DGEQRF( N, N, B, LDB, WORK, WORK, -1, IERR )
  389:          LWKOPT = MAX( 6*N+16, 3*N+INT( WORK ( 1 ) ) )
  390:          CALL DORMQR( 'L', 'T', N, N, N, B, LDB, WORK, A, LDA, WORK,
  391:      $                -1, IERR )
  392:          LWKOPT = MAX( LWKOPT, 3*N+INT( WORK ( 1 ) ) )
  393:          IF( ILVSL ) THEN
  394:             CALL DORGQR( N, N, N, VSL, LDVSL, WORK, WORK, -1, IERR )
  395:             LWKOPT = MAX( LWKOPT, 3*N+INT( WORK ( 1 ) ) )
  396:          END IF
  397:          CALL DGGHD3( JOBVSL, JOBVSR, N, 1, N, A, LDA, B, LDB, VSL,
  398:      $                LDVSL, VSR, LDVSR, WORK, -1, IERR )
  399:          LWKOPT = MAX( LWKOPT, 3*N+INT( WORK ( 1 ) ) )
  400:          CALL DLAQZ0( 'S', JOBVSL, JOBVSR, N, 1, N, A, LDA, B, LDB,
  401:      $                ALPHAR, ALPHAI, BETA, VSL, LDVSL, VSR, LDVSR,
  402:      $                WORK, -1, 0, IERR )
  403:          LWKOPT = MAX( LWKOPT, 2*N+INT( WORK ( 1 ) ) )
  404:          IF( WANTST ) THEN
  405:             CALL DTGSEN( 0, ILVSL, ILVSR, BWORK, N, A, LDA, B, LDB,
  406:      $                   ALPHAR, ALPHAI, BETA, VSL, LDVSL, VSR, LDVSR,
  407:      $                   SDIM, PVSL, PVSR, DIF, WORK, -1, IDUM, 1,
  408:      $                   IERR )
  409:             LWKOPT = MAX( LWKOPT, 2*N+INT( WORK ( 1 ) ) )
  410:          END IF
  411:          WORK( 1 ) = LWKOPT
  412:       END IF
  413: *
  414:       IF( INFO.NE.0 ) THEN
  415:          CALL XERBLA( 'DGGES3 ', -INFO )
  416:          RETURN
  417:       ELSE IF( LQUERY ) THEN
  418:          RETURN
  419:       END IF
  420: *
  421: *     Quick return if possible
  422: *
  423:       IF( N.EQ.0 ) THEN
  424:          SDIM = 0
  425:          RETURN
  426:       END IF
  427: *
  428: *     Get machine constants
  429: *
  430:       EPS = DLAMCH( 'P' )
  431:       SAFMIN = DLAMCH( 'S' )
  432:       SAFMAX = ONE / SAFMIN
  433:       CALL DLABAD( SAFMIN, SAFMAX )
  434:       SMLNUM = SQRT( SAFMIN ) / EPS
  435:       BIGNUM = ONE / SMLNUM
  436: *
  437: *     Scale A if max element outside range [SMLNUM,BIGNUM]
  438: *
  439:       ANRM = DLANGE( 'M', N, N, A, LDA, WORK )
  440:       ILASCL = .FALSE.
  441:       IF( ANRM.GT.ZERO .AND. ANRM.LT.SMLNUM ) THEN
  442:          ANRMTO = SMLNUM
  443:          ILASCL = .TRUE.
  444:       ELSE IF( ANRM.GT.BIGNUM ) THEN
  445:          ANRMTO = BIGNUM
  446:          ILASCL = .TRUE.
  447:       END IF
  448:       IF( ILASCL )
  449:      $   CALL DLASCL( 'G', 0, 0, ANRM, ANRMTO, N, N, A, LDA, IERR )
  450: *
  451: *     Scale B if max element outside range [SMLNUM,BIGNUM]
  452: *
  453:       BNRM = DLANGE( 'M', N, N, B, LDB, WORK )
  454:       ILBSCL = .FALSE.
  455:       IF( BNRM.GT.ZERO .AND. BNRM.LT.SMLNUM ) THEN
  456:          BNRMTO = SMLNUM
  457:          ILBSCL = .TRUE.
  458:       ELSE IF( BNRM.GT.BIGNUM ) THEN
  459:          BNRMTO = BIGNUM
  460:          ILBSCL = .TRUE.
  461:       END IF
  462:       IF( ILBSCL )
  463:      $   CALL DLASCL( 'G', 0, 0, BNRM, BNRMTO, N, N, B, LDB, IERR )
  464: *
  465: *     Permute the matrix to make it more nearly triangular
  466: *
  467:       ILEFT = 1
  468:       IRIGHT = N + 1
  469:       IWRK = IRIGHT + N
  470:       CALL DGGBAL( 'P', N, A, LDA, B, LDB, ILO, IHI, WORK( ILEFT ),
  471:      $             WORK( IRIGHT ), WORK( IWRK ), IERR )
  472: *
  473: *     Reduce B to triangular form (QR decomposition of B)
  474: *
  475:       IROWS = IHI + 1 - ILO
  476:       ICOLS = N + 1 - ILO
  477:       ITAU = IWRK
  478:       IWRK = ITAU + IROWS
  479:       CALL DGEQRF( IROWS, ICOLS, B( ILO, ILO ), LDB, WORK( ITAU ),
  480:      $             WORK( IWRK ), LWORK+1-IWRK, IERR )
  481: *
  482: *     Apply the orthogonal transformation to matrix A
  483: *
  484:       CALL DORMQR( 'L', 'T', IROWS, ICOLS, IROWS, B( ILO, ILO ), LDB,
  485:      $             WORK( ITAU ), A( ILO, ILO ), LDA, WORK( IWRK ),
  486:      $             LWORK+1-IWRK, IERR )
  487: *
  488: *     Initialize VSL
  489: *
  490:       IF( ILVSL ) THEN
  491:          CALL DLASET( 'Full', N, N, ZERO, ONE, VSL, LDVSL )
  492:          IF( IROWS.GT.1 ) THEN
  493:             CALL DLACPY( 'L', IROWS-1, IROWS-1, B( ILO+1, ILO ), LDB,
  494:      $                   VSL( ILO+1, ILO ), LDVSL )
  495:          END IF
  496:          CALL DORGQR( IROWS, IROWS, IROWS, VSL( ILO, ILO ), LDVSL,
  497:      $                WORK( ITAU ), WORK( IWRK ), LWORK+1-IWRK, IERR )
  498:       END IF
  499: *
  500: *     Initialize VSR
  501: *
  502:       IF( ILVSR )
  503:      $   CALL DLASET( 'Full', N, N, ZERO, ONE, VSR, LDVSR )
  504: *
  505: *     Reduce to generalized Hessenberg form
  506: *
  507:       CALL DGGHD3( JOBVSL, JOBVSR, N, ILO, IHI, A, LDA, B, LDB, VSL,
  508:      $             LDVSL, VSR, LDVSR, WORK( IWRK ), LWORK+1-IWRK,
  509:      $             IERR )
  510: *
  511: *     Perform QZ algorithm, computing Schur vectors if desired
  512: *
  513:       IWRK = ITAU
  514:       CALL DLAQZ0( 'S', JOBVSL, JOBVSR, N, ILO, IHI, A, LDA, B, LDB,
  515:      $             ALPHAR, ALPHAI, BETA, VSL, LDVSL, VSR, LDVSR,
  516:      $             WORK( IWRK ), LWORK+1-IWRK, 0, IERR )
  517:       IF( IERR.NE.0 ) THEN
  518:          IF( IERR.GT.0 .AND. IERR.LE.N ) THEN
  519:             INFO = IERR
  520:          ELSE IF( IERR.GT.N .AND. IERR.LE.2*N ) THEN
  521:             INFO = IERR - N
  522:          ELSE
  523:             INFO = N + 1
  524:          END IF
  525:          GO TO 50
  526:       END IF
  527: *
  528: *     Sort eigenvalues ALPHA/BETA if desired
  529: *
  530:       SDIM = 0
  531:       IF( WANTST ) THEN
  532: *
  533: *        Undo scaling on eigenvalues before SELCTGing
  534: *
  535:          IF( ILASCL ) THEN
  536:             CALL DLASCL( 'G', 0, 0, ANRMTO, ANRM, N, 1, ALPHAR, N,
  537:      $                   IERR )
  538:             CALL DLASCL( 'G', 0, 0, ANRMTO, ANRM, N, 1, ALPHAI, N,
  539:      $                   IERR )
  540:          END IF
  541:          IF( ILBSCL )
  542:      $      CALL DLASCL( 'G', 0, 0, BNRMTO, BNRM, N, 1, BETA, N, IERR )
  543: *
  544: *        Select eigenvalues
  545: *
  546:          DO 10 I = 1, N
  547:             BWORK( I ) = SELCTG( ALPHAR( I ), ALPHAI( I ), BETA( I ) )
  548:    10    CONTINUE
  549: *
  550:          CALL DTGSEN( 0, ILVSL, ILVSR, BWORK, N, A, LDA, B, LDB, ALPHAR,
  551:      $                ALPHAI, BETA, VSL, LDVSL, VSR, LDVSR, SDIM, PVSL,
  552:      $                PVSR, DIF, WORK( IWRK ), LWORK-IWRK+1, IDUM, 1,
  553:      $                IERR )
  554:          IF( IERR.EQ.1 )
  555:      $      INFO = N + 3
  556: *
  557:       END IF
  558: *
  559: *     Apply back-permutation to VSL and VSR
  560: *
  561:       IF( ILVSL )
  562:      $   CALL DGGBAK( 'P', 'L', N, ILO, IHI, WORK( ILEFT ),
  563:      $                WORK( IRIGHT ), N, VSL, LDVSL, IERR )
  564: *
  565:       IF( ILVSR )
  566:      $   CALL DGGBAK( 'P', 'R', N, ILO, IHI, WORK( ILEFT ),
  567:      $                WORK( IRIGHT ), N, VSR, LDVSR, IERR )
  568: *
  569: *     Check if unscaling would cause over/underflow, if so, rescale
  570: *     (ALPHAR(I),ALPHAI(I),BETA(I)) so BETA(I) is on the order of
  571: *     B(I,I) and ALPHAR(I) and ALPHAI(I) are on the order of A(I,I)
  572: *
  573:       IF( ILASCL ) THEN
  574:          DO 20 I = 1, N
  575:             IF( ALPHAI( I ).NE.ZERO ) THEN
  576:                IF( ( ALPHAR( I ) / SAFMAX ).GT.( ANRMTO / ANRM ) .OR.
  577:      $             ( SAFMIN / ALPHAR( I ) ).GT.( ANRM / ANRMTO ) ) THEN
  578:                   WORK( 1 ) = ABS( A( I, I ) / ALPHAR( I ) )
  579:                   BETA( I ) = BETA( I )*WORK( 1 )
  580:                   ALPHAR( I ) = ALPHAR( I )*WORK( 1 )
  581:                   ALPHAI( I ) = ALPHAI( I )*WORK( 1 )
  582:                ELSE IF( ( ALPHAI( I ) / SAFMAX ).GT.
  583:      $                  ( ANRMTO / ANRM ) .OR.
  584:      $                  ( SAFMIN / ALPHAI( I ) ).GT.( ANRM / ANRMTO ) )
  585:      $                   THEN
  586:                   WORK( 1 ) = ABS( A( I, I+1 ) / ALPHAI( I ) )
  587:                   BETA( I ) = BETA( I )*WORK( 1 )
  588:                   ALPHAR( I ) = ALPHAR( I )*WORK( 1 )
  589:                   ALPHAI( I ) = ALPHAI( I )*WORK( 1 )
  590:                END IF
  591:             END IF
  592:    20    CONTINUE
  593:       END IF
  594: *
  595:       IF( ILBSCL ) THEN
  596:          DO 30 I = 1, N
  597:             IF( ALPHAI( I ).NE.ZERO ) THEN
  598:                IF( ( BETA( I ) / SAFMAX ).GT.( BNRMTO / BNRM ) .OR.
  599:      $             ( SAFMIN / BETA( I ) ).GT.( BNRM / BNRMTO ) ) THEN
  600:                   WORK( 1 ) = ABS( B( I, I ) / BETA( I ) )
  601:                   BETA( I ) = BETA( I )*WORK( 1 )
  602:                   ALPHAR( I ) = ALPHAR( I )*WORK( 1 )
  603:                   ALPHAI( I ) = ALPHAI( I )*WORK( 1 )
  604:                END IF
  605:             END IF
  606:    30    CONTINUE
  607:       END IF
  608: *
  609: *     Undo scaling
  610: *
  611:       IF( ILASCL ) THEN
  612:          CALL DLASCL( 'H', 0, 0, ANRMTO, ANRM, N, N, A, LDA, IERR )
  613:          CALL DLASCL( 'G', 0, 0, ANRMTO, ANRM, N, 1, ALPHAR, N, IERR )
  614:          CALL DLASCL( 'G', 0, 0, ANRMTO, ANRM, N, 1, ALPHAI, N, IERR )
  615:       END IF
  616: *
  617:       IF( ILBSCL ) THEN
  618:          CALL DLASCL( 'U', 0, 0, BNRMTO, BNRM, N, N, B, LDB, IERR )
  619:          CALL DLASCL( 'G', 0, 0, BNRMTO, BNRM, N, 1, BETA, N, IERR )
  620:       END IF
  621: *
  622:       IF( WANTST ) THEN
  623: *
  624: *        Check if reordering is correct
  625: *
  626:          LASTSL = .TRUE.
  627:          LST2SL = .TRUE.
  628:          SDIM = 0
  629:          IP = 0
  630:          DO 40 I = 1, N
  631:             CURSL = SELCTG( ALPHAR( I ), ALPHAI( I ), BETA( I ) )
  632:             IF( ALPHAI( I ).EQ.ZERO ) THEN
  633:                IF( CURSL )
  634:      $            SDIM = SDIM + 1
  635:                IP = 0
  636:                IF( CURSL .AND. .NOT.LASTSL )
  637:      $            INFO = N + 2
  638:             ELSE
  639:                IF( IP.EQ.1 ) THEN
  640: *
  641: *                 Last eigenvalue of conjugate pair
  642: *
  643:                   CURSL = CURSL .OR. LASTSL
  644:                   LASTSL = CURSL
  645:                   IF( CURSL )
  646:      $               SDIM = SDIM + 2
  647:                   IP = -1
  648:                   IF( CURSL .AND. .NOT.LST2SL )
  649:      $               INFO = N + 2
  650:                ELSE
  651: *
  652: *                 First eigenvalue of conjugate pair
  653: *
  654:                   IP = 1
  655:                END IF
  656:             END IF
  657:             LST2SL = LASTSL
  658:             LASTSL = CURSL
  659:    40    CONTINUE
  660: *
  661:       END IF
  662: *
  663:    50 CONTINUE
  664: *
  665:       WORK( 1 ) = LWKOPT
  666: *
  667:       RETURN
  668: *
  669: *     End of DGGES3
  670: *
  671:       END

CVSweb interface <joel.bertrand@systella.fr>