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

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>