File:  [local] / rpl / lapack / lapack / zlaqr0.f
Revision 1.19: download - view: text, annotated - select for diffs - revision graph
Mon Aug 7 08:39:30 2023 UTC (8 months, 3 weeks 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 ZLAQR0 computes the eigenvalues of a Hessenberg matrix, and optionally the matrices from the Schur decomposition.
    2: *
    3: *  =========== DOCUMENTATION ===========
    4: *
    5: * Online html documentation available at
    6: *            http://www.netlib.org/lapack/explore-html/
    7: *
    8: *> \htmlonly
    9: *> Download ZLAQR0 + dependencies
   10: *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.tgz?format=tgz&filename=/lapack/lapack_routine/zlaqr0.f">
   11: *> [TGZ]</a>
   12: *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.zip?format=zip&filename=/lapack/lapack_routine/zlaqr0.f">
   13: *> [ZIP]</a>
   14: *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.txt?format=txt&filename=/lapack/lapack_routine/zlaqr0.f">
   15: *> [TXT]</a>
   16: *> \endhtmlonly
   17: *
   18: *  Definition:
   19: *  ===========
   20: *
   21: *       SUBROUTINE ZLAQR0( WANTT, WANTZ, N, ILO, IHI, H, LDH, W, ILOZ,
   22: *                          IHIZ, Z, LDZ, WORK, LWORK, INFO )
   23: *
   24: *       .. Scalar Arguments ..
   25: *       INTEGER            IHI, IHIZ, ILO, ILOZ, INFO, LDH, LDZ, LWORK, N
   26: *       LOGICAL            WANTT, WANTZ
   27: *       ..
   28: *       .. Array Arguments ..
   29: *       COMPLEX*16         H( LDH, * ), W( * ), WORK( * ), Z( LDZ, * )
   30: *       ..
   31: *
   32: *
   33: *> \par Purpose:
   34: *  =============
   35: *>
   36: *> \verbatim
   37: *>
   38: *>    ZLAQR0 computes the eigenvalues of a Hessenberg matrix H
   39: *>    and, optionally, the matrices T and Z from the Schur decomposition
   40: *>    H = Z T Z**H, where T is an upper triangular matrix (the
   41: *>    Schur form), and Z is the unitary matrix of Schur vectors.
   42: *>
   43: *>    Optionally Z may be postmultiplied into an input unitary
   44: *>    matrix Q so that this routine can give the Schur factorization
   45: *>    of a matrix A which has been reduced to the Hessenberg form H
   46: *>    by the unitary matrix Q:  A = Q*H*Q**H = (QZ)*H*(QZ)**H.
   47: *> \endverbatim
   48: *
   49: *  Arguments:
   50: *  ==========
   51: *
   52: *> \param[in] WANTT
   53: *> \verbatim
   54: *>          WANTT is LOGICAL
   55: *>          = .TRUE. : the full Schur form T is required;
   56: *>          = .FALSE.: only eigenvalues are required.
   57: *> \endverbatim
   58: *>
   59: *> \param[in] WANTZ
   60: *> \verbatim
   61: *>          WANTZ is LOGICAL
   62: *>          = .TRUE. : the matrix of Schur vectors Z is required;
   63: *>          = .FALSE.: Schur vectors are not required.
   64: *> \endverbatim
   65: *>
   66: *> \param[in] N
   67: *> \verbatim
   68: *>          N is INTEGER
   69: *>           The order of the matrix H.  N >= 0.
   70: *> \endverbatim
   71: *>
   72: *> \param[in] ILO
   73: *> \verbatim
   74: *>          ILO is INTEGER
   75: *> \endverbatim
   76: *>
   77: *> \param[in] IHI
   78: *> \verbatim
   79: *>          IHI is INTEGER
   80: *>
   81: *>           It is assumed that H is already upper triangular in rows
   82: *>           and columns 1:ILO-1 and IHI+1:N and, if ILO > 1,
   83: *>           H(ILO,ILO-1) is zero. ILO and IHI are normally set by a
   84: *>           previous call to ZGEBAL, and then passed to ZGEHRD when the
   85: *>           matrix output by ZGEBAL is reduced to Hessenberg form.
   86: *>           Otherwise, ILO and IHI should be set to 1 and N,
   87: *>           respectively.  If N > 0, then 1 <= ILO <= IHI <= N.
   88: *>           If N = 0, then ILO = 1 and IHI = 0.
   89: *> \endverbatim
   90: *>
   91: *> \param[in,out] H
   92: *> \verbatim
   93: *>          H is COMPLEX*16 array, dimension (LDH,N)
   94: *>           On entry, the upper Hessenberg matrix H.
   95: *>           On exit, if INFO = 0 and WANTT is .TRUE., then H
   96: *>           contains the upper triangular matrix T from the Schur
   97: *>           decomposition (the Schur form). If INFO = 0 and WANT is
   98: *>           .FALSE., then the contents of H are unspecified on exit.
   99: *>           (The output value of H when INFO > 0 is given under the
  100: *>           description of INFO below.)
  101: *>
  102: *>           This subroutine may explicitly set H(i,j) = 0 for i > j and
  103: *>           j = 1, 2, ... ILO-1 or j = IHI+1, IHI+2, ... N.
  104: *> \endverbatim
  105: *>
  106: *> \param[in] LDH
  107: *> \verbatim
  108: *>          LDH is INTEGER
  109: *>           The leading dimension of the array H. LDH >= max(1,N).
  110: *> \endverbatim
  111: *>
  112: *> \param[out] W
  113: *> \verbatim
  114: *>          W is COMPLEX*16 array, dimension (N)
  115: *>           The computed eigenvalues of H(ILO:IHI,ILO:IHI) are stored
  116: *>           in W(ILO:IHI). If WANTT is .TRUE., then the eigenvalues are
  117: *>           stored in the same order as on the diagonal of the Schur
  118: *>           form returned in H, with W(i) = H(i,i).
  119: *> \endverbatim
  120: *>
  121: *> \param[in] ILOZ
  122: *> \verbatim
  123: *>          ILOZ is INTEGER
  124: *> \endverbatim
  125: *>
  126: *> \param[in] IHIZ
  127: *> \verbatim
  128: *>          IHIZ is INTEGER
  129: *>           Specify the rows of Z to which transformations must be
  130: *>           applied if WANTZ is .TRUE..
  131: *>           1 <= ILOZ <= ILO; IHI <= IHIZ <= N.
  132: *> \endverbatim
  133: *>
  134: *> \param[in,out] Z
  135: *> \verbatim
  136: *>          Z is COMPLEX*16 array, dimension (LDZ,IHI)
  137: *>           If WANTZ is .FALSE., then Z is not referenced.
  138: *>           If WANTZ is .TRUE., then Z(ILO:IHI,ILOZ:IHIZ) is
  139: *>           replaced by Z(ILO:IHI,ILOZ:IHIZ)*U where U is the
  140: *>           orthogonal Schur factor of H(ILO:IHI,ILO:IHI).
  141: *>           (The output value of Z when INFO > 0 is given under
  142: *>           the description of INFO below.)
  143: *> \endverbatim
  144: *>
  145: *> \param[in] LDZ
  146: *> \verbatim
  147: *>          LDZ is INTEGER
  148: *>           The leading dimension of the array Z.  if WANTZ is .TRUE.
  149: *>           then LDZ >= MAX(1,IHIZ).  Otherwise, LDZ >= 1.
  150: *> \endverbatim
  151: *>
  152: *> \param[out] WORK
  153: *> \verbatim
  154: *>          WORK is COMPLEX*16 array, dimension LWORK
  155: *>           On exit, if LWORK = -1, WORK(1) returns an estimate of
  156: *>           the optimal value for LWORK.
  157: *> \endverbatim
  158: *>
  159: *> \param[in] LWORK
  160: *> \verbatim
  161: *>          LWORK is INTEGER
  162: *>           The dimension of the array WORK.  LWORK >= max(1,N)
  163: *>           is sufficient, but LWORK typically as large as 6*N may
  164: *>           be required for optimal performance.  A workspace query
  165: *>           to determine the optimal workspace size is recommended.
  166: *>
  167: *>           If LWORK = -1, then ZLAQR0 does a workspace query.
  168: *>           In this case, ZLAQR0 checks the input parameters and
  169: *>           estimates the optimal workspace size for the given
  170: *>           values of N, ILO and IHI.  The estimate is returned
  171: *>           in WORK(1).  No error message related to LWORK is
  172: *>           issued by XERBLA.  Neither H nor Z are accessed.
  173: *> \endverbatim
  174: *>
  175: *> \param[out] INFO
  176: *> \verbatim
  177: *>          INFO is INTEGER
  178: *>             = 0:  successful exit
  179: *>             > 0:  if INFO = i, ZLAQR0 failed to compute all of
  180: *>                the eigenvalues.  Elements 1:ilo-1 and i+1:n of WR
  181: *>                and WI contain those eigenvalues which have been
  182: *>                successfully computed.  (Failures are rare.)
  183: *>
  184: *>                If INFO > 0 and WANT is .FALSE., then on exit,
  185: *>                the remaining unconverged eigenvalues are the eigen-
  186: *>                values of the upper Hessenberg matrix rows and
  187: *>                columns ILO through INFO of the final, output
  188: *>                value of H.
  189: *>
  190: *>                If INFO > 0 and WANTT is .TRUE., then on exit
  191: *>
  192: *>           (*)  (initial value of H)*U  = U*(final value of H)
  193: *>
  194: *>                where U is a unitary matrix.  The final
  195: *>                value of  H is upper Hessenberg and triangular in
  196: *>                rows and columns INFO+1 through IHI.
  197: *>
  198: *>                If INFO > 0 and WANTZ is .TRUE., then on exit
  199: *>
  200: *>                  (final value of Z(ILO:IHI,ILOZ:IHIZ)
  201: *>                   =  (initial value of Z(ILO:IHI,ILOZ:IHIZ)*U
  202: *>
  203: *>                where U is the unitary matrix in (*) (regard-
  204: *>                less of the value of WANTT.)
  205: *>
  206: *>                If INFO > 0 and WANTZ is .FALSE., then Z is not
  207: *>                accessed.
  208: *> \endverbatim
  209: *
  210: *  Authors:
  211: *  ========
  212: *
  213: *> \author Univ. of Tennessee
  214: *> \author Univ. of California Berkeley
  215: *> \author Univ. of Colorado Denver
  216: *> \author NAG Ltd.
  217: *
  218: *> \ingroup complex16OTHERauxiliary
  219: *
  220: *> \par Contributors:
  221: *  ==================
  222: *>
  223: *>       Karen Braman and Ralph Byers, Department of Mathematics,
  224: *>       University of Kansas, USA
  225: *
  226: *> \par References:
  227: *  ================
  228: *>
  229: *>       K. Braman, R. Byers and R. Mathias, The Multi-Shift QR
  230: *>       Algorithm Part I: Maintaining Well Focused Shifts, and Level 3
  231: *>       Performance, SIAM Journal of Matrix Analysis, volume 23, pages
  232: *>       929--947, 2002.
  233: *> \n
  234: *>       K. Braman, R. Byers and R. Mathias, The Multi-Shift QR
  235: *>       Algorithm Part II: Aggressive Early Deflation, SIAM Journal
  236: *>       of Matrix Analysis, volume 23, pages 948--973, 2002.
  237: *>
  238: *  =====================================================================
  239:       SUBROUTINE ZLAQR0( WANTT, WANTZ, N, ILO, IHI, H, LDH, W, ILOZ,
  240:      $                   IHIZ, Z, LDZ, WORK, LWORK, INFO )
  241: *
  242: *  -- LAPACK auxiliary routine --
  243: *  -- LAPACK is a software package provided by Univ. of Tennessee,    --
  244: *  -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..--
  245: *
  246: *     .. Scalar Arguments ..
  247:       INTEGER            IHI, IHIZ, ILO, ILOZ, INFO, LDH, LDZ, LWORK, N
  248:       LOGICAL            WANTT, WANTZ
  249: *     ..
  250: *     .. Array Arguments ..
  251:       COMPLEX*16         H( LDH, * ), W( * ), WORK( * ), Z( LDZ, * )
  252: *     ..
  253: *
  254: *  ================================================================
  255: *
  256: *     .. Parameters ..
  257: *
  258: *     ==== Matrices of order NTINY or smaller must be processed by
  259: *     .    ZLAHQR because of insufficient subdiagonal scratch space.
  260: *     .    (This is a hard limit.) ====
  261:       INTEGER            NTINY
  262:       PARAMETER          ( NTINY = 15 )
  263: *
  264: *     ==== Exceptional deflation windows:  try to cure rare
  265: *     .    slow convergence by varying the size of the
  266: *     .    deflation window after KEXNW iterations. ====
  267:       INTEGER            KEXNW
  268:       PARAMETER          ( KEXNW = 5 )
  269: *
  270: *     ==== Exceptional shifts: try to cure rare slow convergence
  271: *     .    with ad-hoc exceptional shifts every KEXSH iterations.
  272: *     .    ====
  273:       INTEGER            KEXSH
  274:       PARAMETER          ( KEXSH = 6 )
  275: *
  276: *     ==== The constant WILK1 is used to form the exceptional
  277: *     .    shifts. ====
  278:       DOUBLE PRECISION   WILK1
  279:       PARAMETER          ( WILK1 = 0.75d0 )
  280:       COMPLEX*16         ZERO, ONE
  281:       PARAMETER          ( ZERO = ( 0.0d0, 0.0d0 ),
  282:      $                   ONE = ( 1.0d0, 0.0d0 ) )
  283:       DOUBLE PRECISION   TWO
  284:       PARAMETER          ( TWO = 2.0d0 )
  285: *     ..
  286: *     .. Local Scalars ..
  287:       COMPLEX*16         AA, BB, CC, CDUM, DD, DET, RTDISC, SWAP, TR2
  288:       DOUBLE PRECISION   S
  289:       INTEGER            I, INF, IT, ITMAX, K, KACC22, KBOT, KDU, KS,
  290:      $                   KT, KTOP, KU, KV, KWH, KWTOP, KWV, LD, LS,
  291:      $                   LWKOPT, NDEC, NDFL, NH, NHO, NIBBLE, NMIN, NS,
  292:      $                   NSMAX, NSR, NVE, NW, NWMAX, NWR, NWUPBD
  293:       LOGICAL            SORTED
  294:       CHARACTER          JBCMPZ*2
  295: *     ..
  296: *     .. External Functions ..
  297:       INTEGER            ILAENV
  298:       EXTERNAL           ILAENV
  299: *     ..
  300: *     .. Local Arrays ..
  301:       COMPLEX*16         ZDUM( 1, 1 )
  302: *     ..
  303: *     .. External Subroutines ..
  304:       EXTERNAL           ZLACPY, ZLAHQR, ZLAQR3, ZLAQR4, ZLAQR5
  305: *     ..
  306: *     .. Intrinsic Functions ..
  307:       INTRINSIC          ABS, DBLE, DCMPLX, DIMAG, INT, MAX, MIN, MOD,
  308:      $                   SQRT
  309: *     ..
  310: *     .. Statement Functions ..
  311:       DOUBLE PRECISION   CABS1
  312: *     ..
  313: *     .. Statement Function definitions ..
  314:       CABS1( CDUM ) = ABS( DBLE( CDUM ) ) + ABS( DIMAG( CDUM ) )
  315: *     ..
  316: *     .. Executable Statements ..
  317:       INFO = 0
  318: *
  319: *     ==== Quick return for N = 0: nothing to do. ====
  320: *
  321:       IF( N.EQ.0 ) THEN
  322:          WORK( 1 ) = ONE
  323:          RETURN
  324:       END IF
  325: *
  326:       IF( N.LE.NTINY ) THEN
  327: *
  328: *        ==== Tiny matrices must use ZLAHQR. ====
  329: *
  330:          LWKOPT = 1
  331:          IF( LWORK.NE.-1 )
  332:      $      CALL ZLAHQR( WANTT, WANTZ, N, ILO, IHI, H, LDH, W, ILOZ,
  333:      $                   IHIZ, Z, LDZ, INFO )
  334:       ELSE
  335: *
  336: *        ==== Use small bulge multi-shift QR with aggressive early
  337: *        .    deflation on larger-than-tiny matrices. ====
  338: *
  339: *        ==== Hope for the best. ====
  340: *
  341:          INFO = 0
  342: *
  343: *        ==== Set up job flags for ILAENV. ====
  344: *
  345:          IF( WANTT ) THEN
  346:             JBCMPZ( 1: 1 ) = 'S'
  347:          ELSE
  348:             JBCMPZ( 1: 1 ) = 'E'
  349:          END IF
  350:          IF( WANTZ ) THEN
  351:             JBCMPZ( 2: 2 ) = 'V'
  352:          ELSE
  353:             JBCMPZ( 2: 2 ) = 'N'
  354:          END IF
  355: *
  356: *        ==== NWR = recommended deflation window size.  At this
  357: *        .    point,  N .GT. NTINY = 15, so there is enough
  358: *        .    subdiagonal workspace for NWR.GE.2 as required.
  359: *        .    (In fact, there is enough subdiagonal space for
  360: *        .    NWR.GE.4.) ====
  361: *
  362:          NWR = ILAENV( 13, 'ZLAQR0', JBCMPZ, N, ILO, IHI, LWORK )
  363:          NWR = MAX( 2, NWR )
  364:          NWR = MIN( IHI-ILO+1, ( N-1 ) / 3, NWR )
  365: *
  366: *        ==== NSR = recommended number of simultaneous shifts.
  367: *        .    At this point N .GT. NTINY = 15, so there is at
  368: *        .    enough subdiagonal workspace for NSR to be even
  369: *        .    and greater than or equal to two as required. ====
  370: *
  371:          NSR = ILAENV( 15, 'ZLAQR0', JBCMPZ, N, ILO, IHI, LWORK )
  372:          NSR = MIN( NSR, ( N-3 ) / 6, IHI-ILO )
  373:          NSR = MAX( 2, NSR-MOD( NSR, 2 ) )
  374: *
  375: *        ==== Estimate optimal workspace ====
  376: *
  377: *        ==== Workspace query call to ZLAQR3 ====
  378: *
  379:          CALL ZLAQR3( WANTT, WANTZ, N, ILO, IHI, NWR+1, H, LDH, ILOZ,
  380:      $                IHIZ, Z, LDZ, LS, LD, W, H, LDH, N, H, LDH, N, H,
  381:      $                LDH, WORK, -1 )
  382: *
  383: *        ==== Optimal workspace = MAX(ZLAQR5, ZLAQR3) ====
  384: *
  385:          LWKOPT = MAX( 3*NSR / 2, INT( WORK( 1 ) ) )
  386: *
  387: *        ==== Quick return in case of workspace query. ====
  388: *
  389:          IF( LWORK.EQ.-1 ) THEN
  390:             WORK( 1 ) = DCMPLX( LWKOPT, 0 )
  391:             RETURN
  392:          END IF
  393: *
  394: *        ==== ZLAHQR/ZLAQR0 crossover point ====
  395: *
  396:          NMIN = ILAENV( 12, 'ZLAQR0', JBCMPZ, N, ILO, IHI, LWORK )
  397:          NMIN = MAX( NTINY, NMIN )
  398: *
  399: *        ==== Nibble crossover point ====
  400: *
  401:          NIBBLE = ILAENV( 14, 'ZLAQR0', JBCMPZ, N, ILO, IHI, LWORK )
  402:          NIBBLE = MAX( 0, NIBBLE )
  403: *
  404: *        ==== Accumulate reflections during ttswp?  Use block
  405: *        .    2-by-2 structure during matrix-matrix multiply? ====
  406: *
  407:          KACC22 = ILAENV( 16, 'ZLAQR0', JBCMPZ, N, ILO, IHI, LWORK )
  408:          KACC22 = MAX( 0, KACC22 )
  409:          KACC22 = MIN( 2, KACC22 )
  410: *
  411: *        ==== NWMAX = the largest possible deflation window for
  412: *        .    which there is sufficient workspace. ====
  413: *
  414:          NWMAX = MIN( ( N-1 ) / 3, LWORK / 2 )
  415:          NW = NWMAX
  416: *
  417: *        ==== NSMAX = the Largest number of simultaneous shifts
  418: *        .    for which there is sufficient workspace. ====
  419: *
  420:          NSMAX = MIN( ( N-3 ) / 6, 2*LWORK / 3 )
  421:          NSMAX = NSMAX - MOD( NSMAX, 2 )
  422: *
  423: *        ==== NDFL: an iteration count restarted at deflation. ====
  424: *
  425:          NDFL = 1
  426: *
  427: *        ==== ITMAX = iteration limit ====
  428: *
  429:          ITMAX = MAX( 30, 2*KEXSH )*MAX( 10, ( IHI-ILO+1 ) )
  430: *
  431: *        ==== Last row and column in the active block ====
  432: *
  433:          KBOT = IHI
  434: *
  435: *        ==== Main Loop ====
  436: *
  437:          DO 70 IT = 1, ITMAX
  438: *
  439: *           ==== Done when KBOT falls below ILO ====
  440: *
  441:             IF( KBOT.LT.ILO )
  442:      $         GO TO 80
  443: *
  444: *           ==== Locate active block ====
  445: *
  446:             DO 10 K = KBOT, ILO + 1, -1
  447:                IF( H( K, K-1 ).EQ.ZERO )
  448:      $            GO TO 20
  449:    10       CONTINUE
  450:             K = ILO
  451:    20       CONTINUE
  452:             KTOP = K
  453: *
  454: *           ==== Select deflation window size:
  455: *           .    Typical Case:
  456: *           .      If possible and advisable, nibble the entire
  457: *           .      active block.  If not, use size MIN(NWR,NWMAX)
  458: *           .      or MIN(NWR+1,NWMAX) depending upon which has
  459: *           .      the smaller corresponding subdiagonal entry
  460: *           .      (a heuristic).
  461: *           .
  462: *           .    Exceptional Case:
  463: *           .      If there have been no deflations in KEXNW or
  464: *           .      more iterations, then vary the deflation window
  465: *           .      size.   At first, because, larger windows are,
  466: *           .      in general, more powerful than smaller ones,
  467: *           .      rapidly increase the window to the maximum possible.
  468: *           .      Then, gradually reduce the window size. ====
  469: *
  470:             NH = KBOT - KTOP + 1
  471:             NWUPBD = MIN( NH, NWMAX )
  472:             IF( NDFL.LT.KEXNW ) THEN
  473:                NW = MIN( NWUPBD, NWR )
  474:             ELSE
  475:                NW = MIN( NWUPBD, 2*NW )
  476:             END IF
  477:             IF( NW.LT.NWMAX ) THEN
  478:                IF( NW.GE.NH-1 ) THEN
  479:                   NW = NH
  480:                ELSE
  481:                   KWTOP = KBOT - NW + 1
  482:                   IF( CABS1( H( KWTOP, KWTOP-1 ) ).GT.
  483:      $                CABS1( H( KWTOP-1, KWTOP-2 ) ) )NW = NW + 1
  484:                END IF
  485:             END IF
  486:             IF( NDFL.LT.KEXNW ) THEN
  487:                NDEC = -1
  488:             ELSE IF( NDEC.GE.0 .OR. NW.GE.NWUPBD ) THEN
  489:                NDEC = NDEC + 1
  490:                IF( NW-NDEC.LT.2 )
  491:      $            NDEC = 0
  492:                NW = NW - NDEC
  493:             END IF
  494: *
  495: *           ==== Aggressive early deflation:
  496: *           .    split workspace under the subdiagonal into
  497: *           .      - an nw-by-nw work array V in the lower
  498: *           .        left-hand-corner,
  499: *           .      - an NW-by-at-least-NW-but-more-is-better
  500: *           .        (NW-by-NHO) horizontal work array along
  501: *           .        the bottom edge,
  502: *           .      - an at-least-NW-but-more-is-better (NHV-by-NW)
  503: *           .        vertical work array along the left-hand-edge.
  504: *           .        ====
  505: *
  506:             KV = N - NW + 1
  507:             KT = NW + 1
  508:             NHO = ( N-NW-1 ) - KT + 1
  509:             KWV = NW + 2
  510:             NVE = ( N-NW ) - KWV + 1
  511: *
  512: *           ==== Aggressive early deflation ====
  513: *
  514:             CALL ZLAQR3( WANTT, WANTZ, N, KTOP, KBOT, NW, H, LDH, ILOZ,
  515:      $                   IHIZ, Z, LDZ, LS, LD, W, H( KV, 1 ), LDH, NHO,
  516:      $                   H( KV, KT ), LDH, NVE, H( KWV, 1 ), LDH, WORK,
  517:      $                   LWORK )
  518: *
  519: *           ==== Adjust KBOT accounting for new deflations. ====
  520: *
  521:             KBOT = KBOT - LD
  522: *
  523: *           ==== KS points to the shifts. ====
  524: *
  525:             KS = KBOT - LS + 1
  526: *
  527: *           ==== Skip an expensive QR sweep if there is a (partly
  528: *           .    heuristic) reason to expect that many eigenvalues
  529: *           .    will deflate without it.  Here, the QR sweep is
  530: *           .    skipped if many eigenvalues have just been deflated
  531: *           .    or if the remaining active block is small.
  532: *
  533:             IF( ( LD.EQ.0 ) .OR. ( ( 100*LD.LE.NW*NIBBLE ) .AND. ( KBOT-
  534:      $          KTOP+1.GT.MIN( NMIN, NWMAX ) ) ) ) THEN
  535: *
  536: *              ==== NS = nominal number of simultaneous shifts.
  537: *              .    This may be lowered (slightly) if ZLAQR3
  538: *              .    did not provide that many shifts. ====
  539: *
  540:                NS = MIN( NSMAX, NSR, MAX( 2, KBOT-KTOP ) )
  541:                NS = NS - MOD( NS, 2 )
  542: *
  543: *              ==== If there have been no deflations
  544: *              .    in a multiple of KEXSH iterations,
  545: *              .    then try exceptional shifts.
  546: *              .    Otherwise use shifts provided by
  547: *              .    ZLAQR3 above or from the eigenvalues
  548: *              .    of a trailing principal submatrix. ====
  549: *
  550:                IF( MOD( NDFL, KEXSH ).EQ.0 ) THEN
  551:                   KS = KBOT - NS + 1
  552:                   DO 30 I = KBOT, KS + 1, -2
  553:                      W( I ) = H( I, I ) + WILK1*CABS1( H( I, I-1 ) )
  554:                      W( I-1 ) = W( I )
  555:    30             CONTINUE
  556:                ELSE
  557: *
  558: *                 ==== Got NS/2 or fewer shifts? Use ZLAQR4 or
  559: *                 .    ZLAHQR on a trailing principal submatrix to
  560: *                 .    get more. (Since NS.LE.NSMAX.LE.(N-3)/6,
  561: *                 .    there is enough space below the subdiagonal
  562: *                 .    to fit an NS-by-NS scratch array.) ====
  563: *
  564:                   IF( KBOT-KS+1.LE.NS / 2 ) THEN
  565:                      KS = KBOT - NS + 1
  566:                      KT = N - NS + 1
  567:                      CALL ZLACPY( 'A', NS, NS, H( KS, KS ), LDH,
  568:      $                            H( KT, 1 ), LDH )
  569:                      IF( NS.GT.NMIN ) THEN
  570:                         CALL ZLAQR4( .false., .false., NS, 1, NS,
  571:      $                               H( KT, 1 ), LDH, W( KS ), 1, 1,
  572:      $                               ZDUM, 1, WORK, LWORK, INF )
  573:                      ELSE
  574:                         CALL ZLAHQR( .false., .false., NS, 1, NS,
  575:      $                               H( KT, 1 ), LDH, W( KS ), 1, 1,
  576:      $                               ZDUM, 1, INF )
  577:                      END IF
  578:                      KS = KS + INF
  579: *
  580: *                    ==== In case of a rare QR failure use
  581: *                    .    eigenvalues of the trailing 2-by-2
  582: *                    .    principal submatrix.  Scale to avoid
  583: *                    .    overflows, underflows and subnormals.
  584: *                    .    (The scale factor S can not be zero,
  585: *                    .    because H(KBOT,KBOT-1) is nonzero.) ====
  586: *
  587:                      IF( KS.GE.KBOT ) THEN
  588:                         S = CABS1( H( KBOT-1, KBOT-1 ) ) +
  589:      $                      CABS1( H( KBOT, KBOT-1 ) ) +
  590:      $                      CABS1( H( KBOT-1, KBOT ) ) +
  591:      $                      CABS1( H( KBOT, KBOT ) )
  592:                         AA = H( KBOT-1, KBOT-1 ) / S
  593:                         CC = H( KBOT, KBOT-1 ) / S
  594:                         BB = H( KBOT-1, KBOT ) / S
  595:                         DD = H( KBOT, KBOT ) / S
  596:                         TR2 = ( AA+DD ) / TWO
  597:                         DET = ( AA-TR2 )*( DD-TR2 ) - BB*CC
  598:                         RTDISC = SQRT( -DET )
  599:                         W( KBOT-1 ) = ( TR2+RTDISC )*S
  600:                         W( KBOT ) = ( TR2-RTDISC )*S
  601: *
  602:                         KS = KBOT - 1
  603:                      END IF
  604:                   END IF
  605: *
  606:                   IF( KBOT-KS+1.GT.NS ) THEN
  607: *
  608: *                    ==== Sort the shifts (Helps a little) ====
  609: *
  610:                      SORTED = .false.
  611:                      DO 50 K = KBOT, KS + 1, -1
  612:                         IF( SORTED )
  613:      $                     GO TO 60
  614:                         SORTED = .true.
  615:                         DO 40 I = KS, K - 1
  616:                            IF( CABS1( W( I ) ).LT.CABS1( W( I+1 ) ) )
  617:      $                          THEN
  618:                               SORTED = .false.
  619:                               SWAP = W( I )
  620:                               W( I ) = W( I+1 )
  621:                               W( I+1 ) = SWAP
  622:                            END IF
  623:    40                   CONTINUE
  624:    50                CONTINUE
  625:    60                CONTINUE
  626:                   END IF
  627:                END IF
  628: *
  629: *              ==== If there are only two shifts, then use
  630: *              .    only one.  ====
  631: *
  632:                IF( KBOT-KS+1.EQ.2 ) THEN
  633:                   IF( CABS1( W( KBOT )-H( KBOT, KBOT ) ).LT.
  634:      $                CABS1( W( KBOT-1 )-H( KBOT, KBOT ) ) ) THEN
  635:                      W( KBOT-1 ) = W( KBOT )
  636:                   ELSE
  637:                      W( KBOT ) = W( KBOT-1 )
  638:                   END IF
  639:                END IF
  640: *
  641: *              ==== Use up to NS of the the smallest magnitude
  642: *              .    shifts.  If there aren't NS shifts available,
  643: *              .    then use them all, possibly dropping one to
  644: *              .    make the number of shifts even. ====
  645: *
  646:                NS = MIN( NS, KBOT-KS+1 )
  647:                NS = NS - MOD( NS, 2 )
  648:                KS = KBOT - NS + 1
  649: *
  650: *              ==== Small-bulge multi-shift QR sweep:
  651: *              .    split workspace under the subdiagonal into
  652: *              .    - a KDU-by-KDU work array U in the lower
  653: *              .      left-hand-corner,
  654: *              .    - a KDU-by-at-least-KDU-but-more-is-better
  655: *              .      (KDU-by-NHo) horizontal work array WH along
  656: *              .      the bottom edge,
  657: *              .    - and an at-least-KDU-but-more-is-better-by-KDU
  658: *              .      (NVE-by-KDU) vertical work WV arrow along
  659: *              .      the left-hand-edge. ====
  660: *
  661:                KDU = 2*NS
  662:                KU = N - KDU + 1
  663:                KWH = KDU + 1
  664:                NHO = ( N-KDU+1-4 ) - ( KDU+1 ) + 1
  665:                KWV = KDU + 4
  666:                NVE = N - KDU - KWV + 1
  667: *
  668: *              ==== Small-bulge multi-shift QR sweep ====
  669: *
  670:                CALL ZLAQR5( WANTT, WANTZ, KACC22, N, KTOP, KBOT, NS,
  671:      $                      W( KS ), H, LDH, ILOZ, IHIZ, Z, LDZ, WORK,
  672:      $                      3, H( KU, 1 ), LDH, NVE, H( KWV, 1 ), LDH,
  673:      $                      NHO, H( KU, KWH ), LDH )
  674:             END IF
  675: *
  676: *           ==== Note progress (or the lack of it). ====
  677: *
  678:             IF( LD.GT.0 ) THEN
  679:                NDFL = 1
  680:             ELSE
  681:                NDFL = NDFL + 1
  682:             END IF
  683: *
  684: *           ==== End of main loop ====
  685:    70    CONTINUE
  686: *
  687: *        ==== Iteration limit exceeded.  Set INFO to show where
  688: *        .    the problem occurred and exit. ====
  689: *
  690:          INFO = KBOT
  691:    80    CONTINUE
  692:       END IF
  693: *
  694: *     ==== Return the optimal value of LWORK. ====
  695: *
  696:       WORK( 1 ) = DCMPLX( LWKOPT, 0 )
  697: *
  698: *     ==== End of ZLAQR0 ====
  699: *
  700:       END

CVSweb interface <joel.bertrand@systella.fr>