Annotation of rpl/lapack/lapack/dbdsqr.f, revision 1.1

1.1     ! bertrand    1:       SUBROUTINE DBDSQR( UPLO, N, NCVT, NRU, NCC, D, E, VT, LDVT, U,
        !             2:      $                   LDU, C, LDC, WORK, INFO )
        !             3: *
        !             4: *  -- LAPACK routine (version 3.2) --
        !             5: *  -- LAPACK is a software package provided by Univ. of Tennessee,    --
        !             6: *  -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..--
        !             7: *     January 2007
        !             8: *
        !             9: *     .. Scalar Arguments ..
        !            10:       CHARACTER          UPLO
        !            11:       INTEGER            INFO, LDC, LDU, LDVT, N, NCC, NCVT, NRU
        !            12: *     ..
        !            13: *     .. Array Arguments ..
        !            14:       DOUBLE PRECISION   C( LDC, * ), D( * ), E( * ), U( LDU, * ),
        !            15:      $                   VT( LDVT, * ), WORK( * )
        !            16: *     ..
        !            17: *
        !            18: *  Purpose
        !            19: *  =======
        !            20: *
        !            21: *  DBDSQR computes the singular values and, optionally, the right and/or
        !            22: *  left singular vectors from the singular value decomposition (SVD) of
        !            23: *  a real N-by-N (upper or lower) bidiagonal matrix B using the implicit
        !            24: *  zero-shift QR algorithm.  The SVD of B has the form
        !            25: * 
        !            26: *     B = Q * S * P**T
        !            27: * 
        !            28: *  where S is the diagonal matrix of singular values, Q is an orthogonal
        !            29: *  matrix of left singular vectors, and P is an orthogonal matrix of
        !            30: *  right singular vectors.  If left singular vectors are requested, this
        !            31: *  subroutine actually returns U*Q instead of Q, and, if right singular
        !            32: *  vectors are requested, this subroutine returns P**T*VT instead of
        !            33: *  P**T, for given real input matrices U and VT.  When U and VT are the
        !            34: *  orthogonal matrices that reduce a general matrix A to bidiagonal
        !            35: *  form:  A = U*B*VT, as computed by DGEBRD, then
        !            36: *
        !            37: *     A = (U*Q) * S * (P**T*VT)
        !            38: *
        !            39: *  is the SVD of A.  Optionally, the subroutine may also compute Q**T*C
        !            40: *  for a given real input matrix C.
        !            41: *
        !            42: *  See "Computing  Small Singular Values of Bidiagonal Matrices With
        !            43: *  Guaranteed High Relative Accuracy," by J. Demmel and W. Kahan,
        !            44: *  LAPACK Working Note #3 (or SIAM J. Sci. Statist. Comput. vol. 11,
        !            45: *  no. 5, pp. 873-912, Sept 1990) and
        !            46: *  "Accurate singular values and differential qd algorithms," by
        !            47: *  B. Parlett and V. Fernando, Technical Report CPAM-554, Mathematics
        !            48: *  Department, University of California at Berkeley, July 1992
        !            49: *  for a detailed description of the algorithm.
        !            50: *
        !            51: *  Arguments
        !            52: *  =========
        !            53: *
        !            54: *  UPLO    (input) CHARACTER*1
        !            55: *          = 'U':  B is upper bidiagonal;
        !            56: *          = 'L':  B is lower bidiagonal.
        !            57: *
        !            58: *  N       (input) INTEGER
        !            59: *          The order of the matrix B.  N >= 0.
        !            60: *
        !            61: *  NCVT    (input) INTEGER
        !            62: *          The number of columns of the matrix VT. NCVT >= 0.
        !            63: *
        !            64: *  NRU     (input) INTEGER
        !            65: *          The number of rows of the matrix U. NRU >= 0.
        !            66: *
        !            67: *  NCC     (input) INTEGER
        !            68: *          The number of columns of the matrix C. NCC >= 0.
        !            69: *
        !            70: *  D       (input/output) DOUBLE PRECISION array, dimension (N)
        !            71: *          On entry, the n diagonal elements of the bidiagonal matrix B.
        !            72: *          On exit, if INFO=0, the singular values of B in decreasing
        !            73: *          order.
        !            74: *
        !            75: *  E       (input/output) DOUBLE PRECISION array, dimension (N-1)
        !            76: *          On entry, the N-1 offdiagonal elements of the bidiagonal
        !            77: *          matrix B. 
        !            78: *          On exit, if INFO = 0, E is destroyed; if INFO > 0, D and E
        !            79: *          will contain the diagonal and superdiagonal elements of a
        !            80: *          bidiagonal matrix orthogonally equivalent to the one given
        !            81: *          as input.
        !            82: *
        !            83: *  VT      (input/output) DOUBLE PRECISION array, dimension (LDVT, NCVT)
        !            84: *          On entry, an N-by-NCVT matrix VT.
        !            85: *          On exit, VT is overwritten by P**T * VT.
        !            86: *          Not referenced if NCVT = 0.
        !            87: *
        !            88: *  LDVT    (input) INTEGER
        !            89: *          The leading dimension of the array VT.
        !            90: *          LDVT >= max(1,N) if NCVT > 0; LDVT >= 1 if NCVT = 0.
        !            91: *
        !            92: *  U       (input/output) DOUBLE PRECISION array, dimension (LDU, N)
        !            93: *          On entry, an NRU-by-N matrix U.
        !            94: *          On exit, U is overwritten by U * Q.
        !            95: *          Not referenced if NRU = 0.
        !            96: *
        !            97: *  LDU     (input) INTEGER
        !            98: *          The leading dimension of the array U.  LDU >= max(1,NRU).
        !            99: *
        !           100: *  C       (input/output) DOUBLE PRECISION array, dimension (LDC, NCC)
        !           101: *          On entry, an N-by-NCC matrix C.
        !           102: *          On exit, C is overwritten by Q**T * C.
        !           103: *          Not referenced if NCC = 0.
        !           104: *
        !           105: *  LDC     (input) INTEGER
        !           106: *          The leading dimension of the array C.
        !           107: *          LDC >= max(1,N) if NCC > 0; LDC >=1 if NCC = 0.
        !           108: *
        !           109: *  WORK    (workspace) DOUBLE PRECISION array, dimension (4*N)
        !           110: *
        !           111: *  INFO    (output) INTEGER
        !           112: *          = 0:  successful exit
        !           113: *          < 0:  If INFO = -i, the i-th argument had an illegal value
        !           114: *          > 0:
        !           115: *             if NCVT = NRU = NCC = 0,
        !           116: *                = 1, a split was marked by a positive value in E
        !           117: *                = 2, current block of Z not diagonalized after 30*N
        !           118: *                     iterations (in inner while loop)
        !           119: *                = 3, termination criterion of outer while loop not met 
        !           120: *                     (program created more than N unreduced blocks)
        !           121: *             else NCVT = NRU = NCC = 0,
        !           122: *                   the algorithm did not converge; D and E contain the
        !           123: *                   elements of a bidiagonal matrix which is orthogonally
        !           124: *                   similar to the input matrix B;  if INFO = i, i
        !           125: *                   elements of E have not converged to zero.
        !           126: *
        !           127: *  Internal Parameters
        !           128: *  ===================
        !           129: *
        !           130: *  TOLMUL  DOUBLE PRECISION, default = max(10,min(100,EPS**(-1/8)))
        !           131: *          TOLMUL controls the convergence criterion of the QR loop.
        !           132: *          If it is positive, TOLMUL*EPS is the desired relative
        !           133: *             precision in the computed singular values.
        !           134: *          If it is negative, abs(TOLMUL*EPS*sigma_max) is the
        !           135: *             desired absolute accuracy in the computed singular
        !           136: *             values (corresponds to relative accuracy
        !           137: *             abs(TOLMUL*EPS) in the largest singular value.
        !           138: *          abs(TOLMUL) should be between 1 and 1/EPS, and preferably
        !           139: *             between 10 (for fast convergence) and .1/EPS
        !           140: *             (for there to be some accuracy in the results).
        !           141: *          Default is to lose at either one eighth or 2 of the
        !           142: *             available decimal digits in each computed singular value
        !           143: *             (whichever is smaller).
        !           144: *
        !           145: *  MAXITR  INTEGER, default = 6
        !           146: *          MAXITR controls the maximum number of passes of the
        !           147: *          algorithm through its inner loop. The algorithms stops
        !           148: *          (and so fails to converge) if the number of passes
        !           149: *          through the inner loop exceeds MAXITR*N**2.
        !           150: *
        !           151: *  =====================================================================
        !           152: *
        !           153: *     .. Parameters ..
        !           154:       DOUBLE PRECISION   ZERO
        !           155:       PARAMETER          ( ZERO = 0.0D0 )
        !           156:       DOUBLE PRECISION   ONE
        !           157:       PARAMETER          ( ONE = 1.0D0 )
        !           158:       DOUBLE PRECISION   NEGONE
        !           159:       PARAMETER          ( NEGONE = -1.0D0 )
        !           160:       DOUBLE PRECISION   HNDRTH
        !           161:       PARAMETER          ( HNDRTH = 0.01D0 )
        !           162:       DOUBLE PRECISION   TEN
        !           163:       PARAMETER          ( TEN = 10.0D0 )
        !           164:       DOUBLE PRECISION   HNDRD
        !           165:       PARAMETER          ( HNDRD = 100.0D0 )
        !           166:       DOUBLE PRECISION   MEIGTH
        !           167:       PARAMETER          ( MEIGTH = -0.125D0 )
        !           168:       INTEGER            MAXITR
        !           169:       PARAMETER          ( MAXITR = 6 )
        !           170: *     ..
        !           171: *     .. Local Scalars ..
        !           172:       LOGICAL            LOWER, ROTATE
        !           173:       INTEGER            I, IDIR, ISUB, ITER, J, LL, LLL, M, MAXIT, NM1,
        !           174:      $                   NM12, NM13, OLDLL, OLDM
        !           175:       DOUBLE PRECISION   ABSE, ABSS, COSL, COSR, CS, EPS, F, G, H, MU,
        !           176:      $                   OLDCS, OLDSN, R, SHIFT, SIGMN, SIGMX, SINL,
        !           177:      $                   SINR, SLL, SMAX, SMIN, SMINL, SMINOA,
        !           178:      $                   SN, THRESH, TOL, TOLMUL, UNFL
        !           179: *     ..
        !           180: *     .. External Functions ..
        !           181:       LOGICAL            LSAME
        !           182:       DOUBLE PRECISION   DLAMCH
        !           183:       EXTERNAL           LSAME, DLAMCH
        !           184: *     ..
        !           185: *     .. External Subroutines ..
        !           186:       EXTERNAL           DLARTG, DLAS2, DLASQ1, DLASR, DLASV2, DROT,
        !           187:      $                   DSCAL, DSWAP, XERBLA
        !           188: *     ..
        !           189: *     .. Intrinsic Functions ..
        !           190:       INTRINSIC          ABS, DBLE, MAX, MIN, SIGN, SQRT
        !           191: *     ..
        !           192: *     .. Executable Statements ..
        !           193: *
        !           194: *     Test the input parameters.
        !           195: *
        !           196:       INFO = 0
        !           197:       LOWER = LSAME( UPLO, 'L' )
        !           198:       IF( .NOT.LSAME( UPLO, 'U' ) .AND. .NOT.LOWER ) THEN
        !           199:          INFO = -1
        !           200:       ELSE IF( N.LT.0 ) THEN
        !           201:          INFO = -2
        !           202:       ELSE IF( NCVT.LT.0 ) THEN
        !           203:          INFO = -3
        !           204:       ELSE IF( NRU.LT.0 ) THEN
        !           205:          INFO = -4
        !           206:       ELSE IF( NCC.LT.0 ) THEN
        !           207:          INFO = -5
        !           208:       ELSE IF( ( NCVT.EQ.0 .AND. LDVT.LT.1 ) .OR.
        !           209:      $         ( NCVT.GT.0 .AND. LDVT.LT.MAX( 1, N ) ) ) THEN
        !           210:          INFO = -9
        !           211:       ELSE IF( LDU.LT.MAX( 1, NRU ) ) THEN
        !           212:          INFO = -11
        !           213:       ELSE IF( ( NCC.EQ.0 .AND. LDC.LT.1 ) .OR.
        !           214:      $         ( NCC.GT.0 .AND. LDC.LT.MAX( 1, N ) ) ) THEN
        !           215:          INFO = -13
        !           216:       END IF
        !           217:       IF( INFO.NE.0 ) THEN
        !           218:          CALL XERBLA( 'DBDSQR', -INFO )
        !           219:          RETURN
        !           220:       END IF
        !           221:       IF( N.EQ.0 )
        !           222:      $   RETURN
        !           223:       IF( N.EQ.1 )
        !           224:      $   GO TO 160
        !           225: *
        !           226: *     ROTATE is true if any singular vectors desired, false otherwise
        !           227: *
        !           228:       ROTATE = ( NCVT.GT.0 ) .OR. ( NRU.GT.0 ) .OR. ( NCC.GT.0 )
        !           229: *
        !           230: *     If no singular vectors desired, use qd algorithm
        !           231: *
        !           232:       IF( .NOT.ROTATE ) THEN
        !           233:          CALL DLASQ1( N, D, E, WORK, INFO )
        !           234:          RETURN
        !           235:       END IF
        !           236: *
        !           237:       NM1 = N - 1
        !           238:       NM12 = NM1 + NM1
        !           239:       NM13 = NM12 + NM1
        !           240:       IDIR = 0
        !           241: *
        !           242: *     Get machine constants
        !           243: *
        !           244:       EPS = DLAMCH( 'Epsilon' )
        !           245:       UNFL = DLAMCH( 'Safe minimum' )
        !           246: *
        !           247: *     If matrix lower bidiagonal, rotate to be upper bidiagonal
        !           248: *     by applying Givens rotations on the left
        !           249: *
        !           250:       IF( LOWER ) THEN
        !           251:          DO 10 I = 1, N - 1
        !           252:             CALL DLARTG( D( I ), E( I ), CS, SN, R )
        !           253:             D( I ) = R
        !           254:             E( I ) = SN*D( I+1 )
        !           255:             D( I+1 ) = CS*D( I+1 )
        !           256:             WORK( I ) = CS
        !           257:             WORK( NM1+I ) = SN
        !           258:    10    CONTINUE
        !           259: *
        !           260: *        Update singular vectors if desired
        !           261: *
        !           262:          IF( NRU.GT.0 )
        !           263:      $      CALL DLASR( 'R', 'V', 'F', NRU, N, WORK( 1 ), WORK( N ), U,
        !           264:      $                  LDU )
        !           265:          IF( NCC.GT.0 )
        !           266:      $      CALL DLASR( 'L', 'V', 'F', N, NCC, WORK( 1 ), WORK( N ), C,
        !           267:      $                  LDC )
        !           268:       END IF
        !           269: *
        !           270: *     Compute singular values to relative accuracy TOL
        !           271: *     (By setting TOL to be negative, algorithm will compute
        !           272: *     singular values to absolute accuracy ABS(TOL)*norm(input matrix))
        !           273: *
        !           274:       TOLMUL = MAX( TEN, MIN( HNDRD, EPS**MEIGTH ) )
        !           275:       TOL = TOLMUL*EPS
        !           276: *
        !           277: *     Compute approximate maximum, minimum singular values
        !           278: *
        !           279:       SMAX = ZERO
        !           280:       DO 20 I = 1, N
        !           281:          SMAX = MAX( SMAX, ABS( D( I ) ) )
        !           282:    20 CONTINUE
        !           283:       DO 30 I = 1, N - 1
        !           284:          SMAX = MAX( SMAX, ABS( E( I ) ) )
        !           285:    30 CONTINUE
        !           286:       SMINL = ZERO
        !           287:       IF( TOL.GE.ZERO ) THEN
        !           288: *
        !           289: *        Relative accuracy desired
        !           290: *
        !           291:          SMINOA = ABS( D( 1 ) )
        !           292:          IF( SMINOA.EQ.ZERO )
        !           293:      $      GO TO 50
        !           294:          MU = SMINOA
        !           295:          DO 40 I = 2, N
        !           296:             MU = ABS( D( I ) )*( MU / ( MU+ABS( E( I-1 ) ) ) )
        !           297:             SMINOA = MIN( SMINOA, MU )
        !           298:             IF( SMINOA.EQ.ZERO )
        !           299:      $         GO TO 50
        !           300:    40    CONTINUE
        !           301:    50    CONTINUE
        !           302:          SMINOA = SMINOA / SQRT( DBLE( N ) )
        !           303:          THRESH = MAX( TOL*SMINOA, MAXITR*N*N*UNFL )
        !           304:       ELSE
        !           305: *
        !           306: *        Absolute accuracy desired
        !           307: *
        !           308:          THRESH = MAX( ABS( TOL )*SMAX, MAXITR*N*N*UNFL )
        !           309:       END IF
        !           310: *
        !           311: *     Prepare for main iteration loop for the singular values
        !           312: *     (MAXIT is the maximum number of passes through the inner
        !           313: *     loop permitted before nonconvergence signalled.)
        !           314: *
        !           315:       MAXIT = MAXITR*N*N
        !           316:       ITER = 0
        !           317:       OLDLL = -1
        !           318:       OLDM = -1
        !           319: *
        !           320: *     M points to last element of unconverged part of matrix
        !           321: *
        !           322:       M = N
        !           323: *
        !           324: *     Begin main iteration loop
        !           325: *
        !           326:    60 CONTINUE
        !           327: *
        !           328: *     Check for convergence or exceeding iteration count
        !           329: *
        !           330:       IF( M.LE.1 )
        !           331:      $   GO TO 160
        !           332:       IF( ITER.GT.MAXIT )
        !           333:      $   GO TO 200
        !           334: *
        !           335: *     Find diagonal block of matrix to work on
        !           336: *
        !           337:       IF( TOL.LT.ZERO .AND. ABS( D( M ) ).LE.THRESH )
        !           338:      $   D( M ) = ZERO
        !           339:       SMAX = ABS( D( M ) )
        !           340:       SMIN = SMAX
        !           341:       DO 70 LLL = 1, M - 1
        !           342:          LL = M - LLL
        !           343:          ABSS = ABS( D( LL ) )
        !           344:          ABSE = ABS( E( LL ) )
        !           345:          IF( TOL.LT.ZERO .AND. ABSS.LE.THRESH )
        !           346:      $      D( LL ) = ZERO
        !           347:          IF( ABSE.LE.THRESH )
        !           348:      $      GO TO 80
        !           349:          SMIN = MIN( SMIN, ABSS )
        !           350:          SMAX = MAX( SMAX, ABSS, ABSE )
        !           351:    70 CONTINUE
        !           352:       LL = 0
        !           353:       GO TO 90
        !           354:    80 CONTINUE
        !           355:       E( LL ) = ZERO
        !           356: *
        !           357: *     Matrix splits since E(LL) = 0
        !           358: *
        !           359:       IF( LL.EQ.M-1 ) THEN
        !           360: *
        !           361: *        Convergence of bottom singular value, return to top of loop
        !           362: *
        !           363:          M = M - 1
        !           364:          GO TO 60
        !           365:       END IF
        !           366:    90 CONTINUE
        !           367:       LL = LL + 1
        !           368: *
        !           369: *     E(LL) through E(M-1) are nonzero, E(LL-1) is zero
        !           370: *
        !           371:       IF( LL.EQ.M-1 ) THEN
        !           372: *
        !           373: *        2 by 2 block, handle separately
        !           374: *
        !           375:          CALL DLASV2( D( M-1 ), E( M-1 ), D( M ), SIGMN, SIGMX, SINR,
        !           376:      $                COSR, SINL, COSL )
        !           377:          D( M-1 ) = SIGMX
        !           378:          E( M-1 ) = ZERO
        !           379:          D( M ) = SIGMN
        !           380: *
        !           381: *        Compute singular vectors, if desired
        !           382: *
        !           383:          IF( NCVT.GT.0 )
        !           384:      $      CALL DROT( NCVT, VT( M-1, 1 ), LDVT, VT( M, 1 ), LDVT, COSR,
        !           385:      $                 SINR )
        !           386:          IF( NRU.GT.0 )
        !           387:      $      CALL DROT( NRU, U( 1, M-1 ), 1, U( 1, M ), 1, COSL, SINL )
        !           388:          IF( NCC.GT.0 )
        !           389:      $      CALL DROT( NCC, C( M-1, 1 ), LDC, C( M, 1 ), LDC, COSL,
        !           390:      $                 SINL )
        !           391:          M = M - 2
        !           392:          GO TO 60
        !           393:       END IF
        !           394: *
        !           395: *     If working on new submatrix, choose shift direction
        !           396: *     (from larger end diagonal element towards smaller)
        !           397: *
        !           398:       IF( LL.GT.OLDM .OR. M.LT.OLDLL ) THEN
        !           399:          IF( ABS( D( LL ) ).GE.ABS( D( M ) ) ) THEN
        !           400: *
        !           401: *           Chase bulge from top (big end) to bottom (small end)
        !           402: *
        !           403:             IDIR = 1
        !           404:          ELSE
        !           405: *
        !           406: *           Chase bulge from bottom (big end) to top (small end)
        !           407: *
        !           408:             IDIR = 2
        !           409:          END IF
        !           410:       END IF
        !           411: *
        !           412: *     Apply convergence tests
        !           413: *
        !           414:       IF( IDIR.EQ.1 ) THEN
        !           415: *
        !           416: *        Run convergence test in forward direction
        !           417: *        First apply standard test to bottom of matrix
        !           418: *
        !           419:          IF( ABS( E( M-1 ) ).LE.ABS( TOL )*ABS( D( M ) ) .OR.
        !           420:      $       ( TOL.LT.ZERO .AND. ABS( E( M-1 ) ).LE.THRESH ) ) THEN
        !           421:             E( M-1 ) = ZERO
        !           422:             GO TO 60
        !           423:          END IF
        !           424: *
        !           425:          IF( TOL.GE.ZERO ) THEN
        !           426: *
        !           427: *           If relative accuracy desired,
        !           428: *           apply convergence criterion forward
        !           429: *
        !           430:             MU = ABS( D( LL ) )
        !           431:             SMINL = MU
        !           432:             DO 100 LLL = LL, M - 1
        !           433:                IF( ABS( E( LLL ) ).LE.TOL*MU ) THEN
        !           434:                   E( LLL ) = ZERO
        !           435:                   GO TO 60
        !           436:                END IF
        !           437:                MU = ABS( D( LLL+1 ) )*( MU / ( MU+ABS( E( LLL ) ) ) )
        !           438:                SMINL = MIN( SMINL, MU )
        !           439:   100       CONTINUE
        !           440:          END IF
        !           441: *
        !           442:       ELSE
        !           443: *
        !           444: *        Run convergence test in backward direction
        !           445: *        First apply standard test to top of matrix
        !           446: *
        !           447:          IF( ABS( E( LL ) ).LE.ABS( TOL )*ABS( D( LL ) ) .OR.
        !           448:      $       ( TOL.LT.ZERO .AND. ABS( E( LL ) ).LE.THRESH ) ) THEN
        !           449:             E( LL ) = ZERO
        !           450:             GO TO 60
        !           451:          END IF
        !           452: *
        !           453:          IF( TOL.GE.ZERO ) THEN
        !           454: *
        !           455: *           If relative accuracy desired,
        !           456: *           apply convergence criterion backward
        !           457: *
        !           458:             MU = ABS( D( M ) )
        !           459:             SMINL = MU
        !           460:             DO 110 LLL = M - 1, LL, -1
        !           461:                IF( ABS( E( LLL ) ).LE.TOL*MU ) THEN
        !           462:                   E( LLL ) = ZERO
        !           463:                   GO TO 60
        !           464:                END IF
        !           465:                MU = ABS( D( LLL ) )*( MU / ( MU+ABS( E( LLL ) ) ) )
        !           466:                SMINL = MIN( SMINL, MU )
        !           467:   110       CONTINUE
        !           468:          END IF
        !           469:       END IF
        !           470:       OLDLL = LL
        !           471:       OLDM = M
        !           472: *
        !           473: *     Compute shift.  First, test if shifting would ruin relative
        !           474: *     accuracy, and if so set the shift to zero.
        !           475: *
        !           476:       IF( TOL.GE.ZERO .AND. N*TOL*( SMINL / SMAX ).LE.
        !           477:      $    MAX( EPS, HNDRTH*TOL ) ) THEN
        !           478: *
        !           479: *        Use a zero shift to avoid loss of relative accuracy
        !           480: *
        !           481:          SHIFT = ZERO
        !           482:       ELSE
        !           483: *
        !           484: *        Compute the shift from 2-by-2 block at end of matrix
        !           485: *
        !           486:          IF( IDIR.EQ.1 ) THEN
        !           487:             SLL = ABS( D( LL ) )
        !           488:             CALL DLAS2( D( M-1 ), E( M-1 ), D( M ), SHIFT, R )
        !           489:          ELSE
        !           490:             SLL = ABS( D( M ) )
        !           491:             CALL DLAS2( D( LL ), E( LL ), D( LL+1 ), SHIFT, R )
        !           492:          END IF
        !           493: *
        !           494: *        Test if shift negligible, and if so set to zero
        !           495: *
        !           496:          IF( SLL.GT.ZERO ) THEN
        !           497:             IF( ( SHIFT / SLL )**2.LT.EPS )
        !           498:      $         SHIFT = ZERO
        !           499:          END IF
        !           500:       END IF
        !           501: *
        !           502: *     Increment iteration count
        !           503: *
        !           504:       ITER = ITER + M - LL
        !           505: *
        !           506: *     If SHIFT = 0, do simplified QR iteration
        !           507: *
        !           508:       IF( SHIFT.EQ.ZERO ) THEN
        !           509:          IF( IDIR.EQ.1 ) THEN
        !           510: *
        !           511: *           Chase bulge from top to bottom
        !           512: *           Save cosines and sines for later singular vector updates
        !           513: *
        !           514:             CS = ONE
        !           515:             OLDCS = ONE
        !           516:             DO 120 I = LL, M - 1
        !           517:                CALL DLARTG( D( I )*CS, E( I ), CS, SN, R )
        !           518:                IF( I.GT.LL )
        !           519:      $            E( I-1 ) = OLDSN*R
        !           520:                CALL DLARTG( OLDCS*R, D( I+1 )*SN, OLDCS, OLDSN, D( I ) )
        !           521:                WORK( I-LL+1 ) = CS
        !           522:                WORK( I-LL+1+NM1 ) = SN
        !           523:                WORK( I-LL+1+NM12 ) = OLDCS
        !           524:                WORK( I-LL+1+NM13 ) = OLDSN
        !           525:   120       CONTINUE
        !           526:             H = D( M )*CS
        !           527:             D( M ) = H*OLDCS
        !           528:             E( M-1 ) = H*OLDSN
        !           529: *
        !           530: *           Update singular vectors
        !           531: *
        !           532:             IF( NCVT.GT.0 )
        !           533:      $         CALL DLASR( 'L', 'V', 'F', M-LL+1, NCVT, WORK( 1 ),
        !           534:      $                     WORK( N ), VT( LL, 1 ), LDVT )
        !           535:             IF( NRU.GT.0 )
        !           536:      $         CALL DLASR( 'R', 'V', 'F', NRU, M-LL+1, WORK( NM12+1 ),
        !           537:      $                     WORK( NM13+1 ), U( 1, LL ), LDU )
        !           538:             IF( NCC.GT.0 )
        !           539:      $         CALL DLASR( 'L', 'V', 'F', M-LL+1, NCC, WORK( NM12+1 ),
        !           540:      $                     WORK( NM13+1 ), C( LL, 1 ), LDC )
        !           541: *
        !           542: *           Test convergence
        !           543: *
        !           544:             IF( ABS( E( M-1 ) ).LE.THRESH )
        !           545:      $         E( M-1 ) = ZERO
        !           546: *
        !           547:          ELSE
        !           548: *
        !           549: *           Chase bulge from bottom to top
        !           550: *           Save cosines and sines for later singular vector updates
        !           551: *
        !           552:             CS = ONE
        !           553:             OLDCS = ONE
        !           554:             DO 130 I = M, LL + 1, -1
        !           555:                CALL DLARTG( D( I )*CS, E( I-1 ), CS, SN, R )
        !           556:                IF( I.LT.M )
        !           557:      $            E( I ) = OLDSN*R
        !           558:                CALL DLARTG( OLDCS*R, D( I-1 )*SN, OLDCS, OLDSN, D( I ) )
        !           559:                WORK( I-LL ) = CS
        !           560:                WORK( I-LL+NM1 ) = -SN
        !           561:                WORK( I-LL+NM12 ) = OLDCS
        !           562:                WORK( I-LL+NM13 ) = -OLDSN
        !           563:   130       CONTINUE
        !           564:             H = D( LL )*CS
        !           565:             D( LL ) = H*OLDCS
        !           566:             E( LL ) = H*OLDSN
        !           567: *
        !           568: *           Update singular vectors
        !           569: *
        !           570:             IF( NCVT.GT.0 )
        !           571:      $         CALL DLASR( 'L', 'V', 'B', M-LL+1, NCVT, WORK( NM12+1 ),
        !           572:      $                     WORK( NM13+1 ), VT( LL, 1 ), LDVT )
        !           573:             IF( NRU.GT.0 )
        !           574:      $         CALL DLASR( 'R', 'V', 'B', NRU, M-LL+1, WORK( 1 ),
        !           575:      $                     WORK( N ), U( 1, LL ), LDU )
        !           576:             IF( NCC.GT.0 )
        !           577:      $         CALL DLASR( 'L', 'V', 'B', M-LL+1, NCC, WORK( 1 ),
        !           578:      $                     WORK( N ), C( LL, 1 ), LDC )
        !           579: *
        !           580: *           Test convergence
        !           581: *
        !           582:             IF( ABS( E( LL ) ).LE.THRESH )
        !           583:      $         E( LL ) = ZERO
        !           584:          END IF
        !           585:       ELSE
        !           586: *
        !           587: *        Use nonzero shift
        !           588: *
        !           589:          IF( IDIR.EQ.1 ) THEN
        !           590: *
        !           591: *           Chase bulge from top to bottom
        !           592: *           Save cosines and sines for later singular vector updates
        !           593: *
        !           594:             F = ( ABS( D( LL ) )-SHIFT )*
        !           595:      $          ( SIGN( ONE, D( LL ) )+SHIFT / D( LL ) )
        !           596:             G = E( LL )
        !           597:             DO 140 I = LL, M - 1
        !           598:                CALL DLARTG( F, G, COSR, SINR, R )
        !           599:                IF( I.GT.LL )
        !           600:      $            E( I-1 ) = R
        !           601:                F = COSR*D( I ) + SINR*E( I )
        !           602:                E( I ) = COSR*E( I ) - SINR*D( I )
        !           603:                G = SINR*D( I+1 )
        !           604:                D( I+1 ) = COSR*D( I+1 )
        !           605:                CALL DLARTG( F, G, COSL, SINL, R )
        !           606:                D( I ) = R
        !           607:                F = COSL*E( I ) + SINL*D( I+1 )
        !           608:                D( I+1 ) = COSL*D( I+1 ) - SINL*E( I )
        !           609:                IF( I.LT.M-1 ) THEN
        !           610:                   G = SINL*E( I+1 )
        !           611:                   E( I+1 ) = COSL*E( I+1 )
        !           612:                END IF
        !           613:                WORK( I-LL+1 ) = COSR
        !           614:                WORK( I-LL+1+NM1 ) = SINR
        !           615:                WORK( I-LL+1+NM12 ) = COSL
        !           616:                WORK( I-LL+1+NM13 ) = SINL
        !           617:   140       CONTINUE
        !           618:             E( M-1 ) = F
        !           619: *
        !           620: *           Update singular vectors
        !           621: *
        !           622:             IF( NCVT.GT.0 )
        !           623:      $         CALL DLASR( 'L', 'V', 'F', M-LL+1, NCVT, WORK( 1 ),
        !           624:      $                     WORK( N ), VT( LL, 1 ), LDVT )
        !           625:             IF( NRU.GT.0 )
        !           626:      $         CALL DLASR( 'R', 'V', 'F', NRU, M-LL+1, WORK( NM12+1 ),
        !           627:      $                     WORK( NM13+1 ), U( 1, LL ), LDU )
        !           628:             IF( NCC.GT.0 )
        !           629:      $         CALL DLASR( 'L', 'V', 'F', M-LL+1, NCC, WORK( NM12+1 ),
        !           630:      $                     WORK( NM13+1 ), C( LL, 1 ), LDC )
        !           631: *
        !           632: *           Test convergence
        !           633: *
        !           634:             IF( ABS( E( M-1 ) ).LE.THRESH )
        !           635:      $         E( M-1 ) = ZERO
        !           636: *
        !           637:          ELSE
        !           638: *
        !           639: *           Chase bulge from bottom to top
        !           640: *           Save cosines and sines for later singular vector updates
        !           641: *
        !           642:             F = ( ABS( D( M ) )-SHIFT )*( SIGN( ONE, D( M ) )+SHIFT /
        !           643:      $          D( M ) )
        !           644:             G = E( M-1 )
        !           645:             DO 150 I = M, LL + 1, -1
        !           646:                CALL DLARTG( F, G, COSR, SINR, R )
        !           647:                IF( I.LT.M )
        !           648:      $            E( I ) = R
        !           649:                F = COSR*D( I ) + SINR*E( I-1 )
        !           650:                E( I-1 ) = COSR*E( I-1 ) - SINR*D( I )
        !           651:                G = SINR*D( I-1 )
        !           652:                D( I-1 ) = COSR*D( I-1 )
        !           653:                CALL DLARTG( F, G, COSL, SINL, R )
        !           654:                D( I ) = R
        !           655:                F = COSL*E( I-1 ) + SINL*D( I-1 )
        !           656:                D( I-1 ) = COSL*D( I-1 ) - SINL*E( I-1 )
        !           657:                IF( I.GT.LL+1 ) THEN
        !           658:                   G = SINL*E( I-2 )
        !           659:                   E( I-2 ) = COSL*E( I-2 )
        !           660:                END IF
        !           661:                WORK( I-LL ) = COSR
        !           662:                WORK( I-LL+NM1 ) = -SINR
        !           663:                WORK( I-LL+NM12 ) = COSL
        !           664:                WORK( I-LL+NM13 ) = -SINL
        !           665:   150       CONTINUE
        !           666:             E( LL ) = F
        !           667: *
        !           668: *           Test convergence
        !           669: *
        !           670:             IF( ABS( E( LL ) ).LE.THRESH )
        !           671:      $         E( LL ) = ZERO
        !           672: *
        !           673: *           Update singular vectors if desired
        !           674: *
        !           675:             IF( NCVT.GT.0 )
        !           676:      $         CALL DLASR( 'L', 'V', 'B', M-LL+1, NCVT, WORK( NM12+1 ),
        !           677:      $                     WORK( NM13+1 ), VT( LL, 1 ), LDVT )
        !           678:             IF( NRU.GT.0 )
        !           679:      $         CALL DLASR( 'R', 'V', 'B', NRU, M-LL+1, WORK( 1 ),
        !           680:      $                     WORK( N ), U( 1, LL ), LDU )
        !           681:             IF( NCC.GT.0 )
        !           682:      $         CALL DLASR( 'L', 'V', 'B', M-LL+1, NCC, WORK( 1 ),
        !           683:      $                     WORK( N ), C( LL, 1 ), LDC )
        !           684:          END IF
        !           685:       END IF
        !           686: *
        !           687: *     QR iteration finished, go back and check convergence
        !           688: *
        !           689:       GO TO 60
        !           690: *
        !           691: *     All singular values converged, so make them positive
        !           692: *
        !           693:   160 CONTINUE
        !           694:       DO 170 I = 1, N
        !           695:          IF( D( I ).LT.ZERO ) THEN
        !           696:             D( I ) = -D( I )
        !           697: *
        !           698: *           Change sign of singular vectors, if desired
        !           699: *
        !           700:             IF( NCVT.GT.0 )
        !           701:      $         CALL DSCAL( NCVT, NEGONE, VT( I, 1 ), LDVT )
        !           702:          END IF
        !           703:   170 CONTINUE
        !           704: *
        !           705: *     Sort the singular values into decreasing order (insertion sort on
        !           706: *     singular values, but only one transposition per singular vector)
        !           707: *
        !           708:       DO 190 I = 1, N - 1
        !           709: *
        !           710: *        Scan for smallest D(I)
        !           711: *
        !           712:          ISUB = 1
        !           713:          SMIN = D( 1 )
        !           714:          DO 180 J = 2, N + 1 - I
        !           715:             IF( D( J ).LE.SMIN ) THEN
        !           716:                ISUB = J
        !           717:                SMIN = D( J )
        !           718:             END IF
        !           719:   180    CONTINUE
        !           720:          IF( ISUB.NE.N+1-I ) THEN
        !           721: *
        !           722: *           Swap singular values and vectors
        !           723: *
        !           724:             D( ISUB ) = D( N+1-I )
        !           725:             D( N+1-I ) = SMIN
        !           726:             IF( NCVT.GT.0 )
        !           727:      $         CALL DSWAP( NCVT, VT( ISUB, 1 ), LDVT, VT( N+1-I, 1 ),
        !           728:      $                     LDVT )
        !           729:             IF( NRU.GT.0 )
        !           730:      $         CALL DSWAP( NRU, U( 1, ISUB ), 1, U( 1, N+1-I ), 1 )
        !           731:             IF( NCC.GT.0 )
        !           732:      $         CALL DSWAP( NCC, C( ISUB, 1 ), LDC, C( N+1-I, 1 ), LDC )
        !           733:          END IF
        !           734:   190 CONTINUE
        !           735:       GO TO 220
        !           736: *
        !           737: *     Maximum number of iterations exceeded, failure to converge
        !           738: *
        !           739:   200 CONTINUE
        !           740:       INFO = 0
        !           741:       DO 210 I = 1, N - 1
        !           742:          IF( E( I ).NE.ZERO )
        !           743:      $      INFO = INFO + 1
        !           744:   210 CONTINUE
        !           745:   220 CONTINUE
        !           746:       RETURN
        !           747: *
        !           748: *     End of DBDSQR
        !           749: *
        !           750:       END

CVSweb interface <joel.bertrand@systella.fr>