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

1.1     ! bertrand    1:       SUBROUTINE DLASQ3( I0, N0, Z, PP, DMIN, SIGMA, DESIG, QMAX, NFAIL,
        !             2:      $                   ITER, NDIV, IEEE, TTYPE, DMIN1, DMIN2, DN, DN1,
        !             3:      $                   DN2, G, TAU )
        !             4: *
        !             5: *  -- LAPACK routine (version 3.2)                                    --
        !             6: *
        !             7: *  -- Contributed by Osni Marques of the Lawrence Berkeley National   --
        !             8: *  -- Laboratory and Beresford Parlett of the Univ. of California at  --
        !             9: *  -- Berkeley                                                        --
        !            10: *  -- November 2008                                                   --
        !            11: *
        !            12: *  -- LAPACK is a software package provided by Univ. of Tennessee,    --
        !            13: *  -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..--
        !            14: *
        !            15: *     .. Scalar Arguments ..
        !            16:       LOGICAL            IEEE
        !            17:       INTEGER            I0, ITER, N0, NDIV, NFAIL, PP
        !            18:       DOUBLE PRECISION   DESIG, DMIN, DMIN1, DMIN2, DN, DN1, DN2, G,
        !            19:      $                   QMAX, SIGMA, TAU
        !            20: *     ..
        !            21: *     .. Array Arguments ..
        !            22:       DOUBLE PRECISION   Z( * )
        !            23: *     ..
        !            24: *
        !            25: *  Purpose
        !            26: *  =======
        !            27: *
        !            28: *  DLASQ3 checks for deflation, computes a shift (TAU) and calls dqds.
        !            29: *  In case of failure it changes shifts, and tries again until output
        !            30: *  is positive.
        !            31: *
        !            32: *  Arguments
        !            33: *  =========
        !            34: *
        !            35: *  I0     (input) INTEGER
        !            36: *         First index.
        !            37: *
        !            38: *  N0     (input) INTEGER
        !            39: *         Last index.
        !            40: *
        !            41: *  Z      (input) DOUBLE PRECISION array, dimension ( 4*N )
        !            42: *         Z holds the qd array.
        !            43: *
        !            44: *  PP     (input/output) INTEGER
        !            45: *         PP=0 for ping, PP=1 for pong.
        !            46: *         PP=2 indicates that flipping was applied to the Z array   
        !            47: *         and that the initial tests for deflation should not be 
        !            48: *         performed.
        !            49: *
        !            50: *  DMIN   (output) DOUBLE PRECISION
        !            51: *         Minimum value of d.
        !            52: *
        !            53: *  SIGMA  (output) DOUBLE PRECISION
        !            54: *         Sum of shifts used in current segment.
        !            55: *
        !            56: *  DESIG  (input/output) DOUBLE PRECISION
        !            57: *         Lower order part of SIGMA
        !            58: *
        !            59: *  QMAX   (input) DOUBLE PRECISION
        !            60: *         Maximum value of q.
        !            61: *
        !            62: *  NFAIL  (output) INTEGER
        !            63: *         Number of times shift was too big.
        !            64: *
        !            65: *  ITER   (output) INTEGER
        !            66: *         Number of iterations.
        !            67: *
        !            68: *  NDIV   (output) INTEGER
        !            69: *         Number of divisions.
        !            70: *
        !            71: *  IEEE   (input) LOGICAL
        !            72: *         Flag for IEEE or non IEEE arithmetic (passed to DLASQ5).
        !            73: *
        !            74: *  TTYPE  (input/output) INTEGER
        !            75: *         Shift type.
        !            76: *
        !            77: *  DMIN1, DMIN2, DN, DN1, DN2, G, TAU (input/output) DOUBLE PRECISION
        !            78: *         These are passed as arguments in order to save their values
        !            79: *         between calls to DLASQ3.
        !            80: *
        !            81: *  =====================================================================
        !            82: *
        !            83: *     .. Parameters ..
        !            84:       DOUBLE PRECISION   CBIAS
        !            85:       PARAMETER          ( CBIAS = 1.50D0 )
        !            86:       DOUBLE PRECISION   ZERO, QURTR, HALF, ONE, TWO, HUNDRD
        !            87:       PARAMETER          ( ZERO = 0.0D0, QURTR = 0.250D0, HALF = 0.5D0,
        !            88:      $                     ONE = 1.0D0, TWO = 2.0D0, HUNDRD = 100.0D0 )
        !            89: *     ..
        !            90: *     .. Local Scalars ..
        !            91:       INTEGER            IPN4, J4, N0IN, NN, TTYPE
        !            92:       DOUBLE PRECISION   EPS, S, T, TEMP, TOL, TOL2
        !            93: *     ..
        !            94: *     .. External Subroutines ..
        !            95:       EXTERNAL           DLASQ4, DLASQ5, DLASQ6
        !            96: *     ..
        !            97: *     .. External Function ..
        !            98:       DOUBLE PRECISION   DLAMCH
        !            99:       LOGICAL            DISNAN
        !           100:       EXTERNAL           DISNAN, DLAMCH
        !           101: *     ..
        !           102: *     .. Intrinsic Functions ..
        !           103:       INTRINSIC          ABS, MAX, MIN, SQRT
        !           104: *     ..
        !           105: *     .. Executable Statements ..
        !           106: *
        !           107:       N0IN = N0
        !           108:       EPS = DLAMCH( 'Precision' )
        !           109:       TOL = EPS*HUNDRD
        !           110:       TOL2 = TOL**2
        !           111: *
        !           112: *     Check for deflation.
        !           113: *
        !           114:    10 CONTINUE
        !           115: *
        !           116:       IF( N0.LT.I0 )
        !           117:      $   RETURN
        !           118:       IF( N0.EQ.I0 )
        !           119:      $   GO TO 20
        !           120:       NN = 4*N0 + PP
        !           121:       IF( N0.EQ.( I0+1 ) )
        !           122:      $   GO TO 40
        !           123: *
        !           124: *     Check whether E(N0-1) is negligible, 1 eigenvalue.
        !           125: *
        !           126:       IF( Z( NN-5 ).GT.TOL2*( SIGMA+Z( NN-3 ) ) .AND.
        !           127:      $    Z( NN-2*PP-4 ).GT.TOL2*Z( NN-7 ) )
        !           128:      $   GO TO 30
        !           129: *
        !           130:    20 CONTINUE
        !           131: *
        !           132:       Z( 4*N0-3 ) = Z( 4*N0+PP-3 ) + SIGMA
        !           133:       N0 = N0 - 1
        !           134:       GO TO 10
        !           135: *
        !           136: *     Check  whether E(N0-2) is negligible, 2 eigenvalues.
        !           137: *
        !           138:    30 CONTINUE
        !           139: *
        !           140:       IF( Z( NN-9 ).GT.TOL2*SIGMA .AND.
        !           141:      $    Z( NN-2*PP-8 ).GT.TOL2*Z( NN-11 ) )
        !           142:      $   GO TO 50
        !           143: *
        !           144:    40 CONTINUE
        !           145: *
        !           146:       IF( Z( NN-3 ).GT.Z( NN-7 ) ) THEN
        !           147:          S = Z( NN-3 )
        !           148:          Z( NN-3 ) = Z( NN-7 )
        !           149:          Z( NN-7 ) = S
        !           150:       END IF
        !           151:       IF( Z( NN-5 ).GT.Z( NN-3 )*TOL2 ) THEN
        !           152:          T = HALF*( ( Z( NN-7 )-Z( NN-3 ) )+Z( NN-5 ) )
        !           153:          S = Z( NN-3 )*( Z( NN-5 ) / T )
        !           154:          IF( S.LE.T ) THEN
        !           155:             S = Z( NN-3 )*( Z( NN-5 ) /
        !           156:      $          ( T*( ONE+SQRT( ONE+S / T ) ) ) )
        !           157:          ELSE
        !           158:             S = Z( NN-3 )*( Z( NN-5 ) / ( T+SQRT( T )*SQRT( T+S ) ) )
        !           159:          END IF
        !           160:          T = Z( NN-7 ) + ( S+Z( NN-5 ) )
        !           161:          Z( NN-3 ) = Z( NN-3 )*( Z( NN-7 ) / T )
        !           162:          Z( NN-7 ) = T
        !           163:       END IF
        !           164:       Z( 4*N0-7 ) = Z( NN-7 ) + SIGMA
        !           165:       Z( 4*N0-3 ) = Z( NN-3 ) + SIGMA
        !           166:       N0 = N0 - 2
        !           167:       GO TO 10
        !           168: *
        !           169:    50 CONTINUE
        !           170:       IF( PP.EQ.2        !           171:      $   PP = 0
        !           172: *
        !           173: *     Reverse the qd-array, if warranted.
        !           174: *
        !           175:       IF( DMIN.LE.ZERO .OR. N0.LT.N0IN ) THEN
        !           176:          IF( CBIAS*Z( 4*I0+PP-3 ).LT.Z( 4*N0+PP-3 ) ) THEN
        !           177:             IPN4 = 4*( I0+N0 )
        !           178:             DO 60 J4 = 4*I0, 2*( I0+N0-1 ), 4
        !           179:                TEMP = Z( J4-3 )
        !           180:                Z( J4-3 ) = Z( IPN4-J4-3 )
        !           181:                Z( IPN4-J4-3 ) = TEMP
        !           182:                TEMP = Z( J4-2 )
        !           183:                Z( J4-2 ) = Z( IPN4-J4-2 )
        !           184:                Z( IPN4-J4-2 ) = TEMP
        !           185:                TEMP = Z( J4-1 )
        !           186:                Z( J4-1 ) = Z( IPN4-J4-5 )
        !           187:                Z( IPN4-J4-5 ) = TEMP
        !           188:                TEMP = Z( J4 )
        !           189:                Z( J4 ) = Z( IPN4-J4-4 )
        !           190:                Z( IPN4-J4-4 ) = TEMP
        !           191:    60       CONTINUE
        !           192:             IF( N0-I0.LE.4 ) THEN
        !           193:                Z( 4*N0+PP-1 ) = Z( 4*I0+PP-1 )
        !           194:                Z( 4*N0-PP ) = Z( 4*I0-PP )
        !           195:             END IF
        !           196:             DMIN2 = MIN( DMIN2, Z( 4*N0+PP-1 ) )
        !           197:             Z( 4*N0+PP-1 ) = MIN( Z( 4*N0+PP-1 ), Z( 4*I0+PP-1 ),
        !           198:      $                            Z( 4*I0+PP+3 ) )
        !           199:             Z( 4*N0-PP ) = MIN( Z( 4*N0-PP ), Z( 4*I0-PP ),
        !           200:      $                          Z( 4*I0-PP+4 ) )
        !           201:             QMAX = MAX( QMAX, Z( 4*I0+PP-3 ), Z( 4*I0+PP+1 ) )
        !           202:             DMIN = -ZERO
        !           203:          END IF
        !           204:       END IF
        !           205: *
        !           206: *     Choose a shift.
        !           207: *
        !           208:       CALL DLASQ4( I0, N0, Z, PP, N0IN, DMIN, DMIN1, DMIN2, DN, DN1,
        !           209:      $             DN2, TAU, TTYPE, G )
        !           210: *
        !           211: *     Call dqds until DMIN > 0.
        !           212: *
        !           213:    70 CONTINUE
        !           214: *
        !           215:       CALL DLASQ5( I0, N0, Z, PP, TAU, DMIN, DMIN1, DMIN2, DN,
        !           216:      $             DN1, DN2, IEEE )
        !           217: *
        !           218:       NDIV = NDIV + ( N0-I0+2 )
        !           219:       ITER = ITER + 1
        !           220: *
        !           221: *     Check status.
        !           222: *
        !           223:       IF( DMIN.GE.ZERO .AND. DMIN1.GT.ZERO ) THEN
        !           224: *
        !           225: *        Success.
        !           226: *
        !           227:          GO TO 90
        !           228: *
        !           229:       ELSE IF( DMIN.LT.ZERO .AND. DMIN1.GT.ZERO .AND. 
        !           230:      $         Z( 4*( N0-1 )-PP ).LT.TOL*( SIGMA+DN1 ) .AND.
        !           231:      $         ABS( DN ).LT.TOL*SIGMA ) THEN
        !           232: *
        !           233: *        Convergence hidden by negative DN.
        !           234: *
        !           235:          Z( 4*( N0-1 )-PP+2 ) = ZERO
        !           236:          DMIN = ZERO
        !           237:          GO TO 90
        !           238:       ELSE IF( DMIN.LT.ZERO ) THEN
        !           239: *
        !           240: *        TAU too big. Select new TAU and try again.
        !           241: *
        !           242:          NFAIL = NFAIL + 1
        !           243:          IF( TTYPE.LT.-22 ) THEN
        !           244: *
        !           245: *           Failed twice. Play it safe.
        !           246: *
        !           247:             TAU = ZERO
        !           248:          ELSE IF( DMIN1.GT.ZERO ) THEN
        !           249: *
        !           250: *           Late failure. Gives excellent shift.
        !           251: *
        !           252:             TAU = ( TAU+DMIN )*( ONE-TWO*EPS )
        !           253:             TTYPE = TTYPE - 11
        !           254:          ELSE
        !           255: *
        !           256: *           Early failure. Divide by 4.
        !           257: *
        !           258:             TAU = QURTR*TAU
        !           259:             TTYPE = TTYPE - 12
        !           260:          END IF
        !           261:          GO TO 70
        !           262:       ELSE IF( DISNAN( DMIN ) ) THEN
        !           263: *
        !           264: *        NaN.
        !           265: *
        !           266:          IF( TAU.EQ.ZERO ) THEN
        !           267:             GO TO 80
        !           268:          ELSE
        !           269:             TAU = ZERO
        !           270:             GO TO 70
        !           271:          END IF
        !           272:       ELSE
        !           273: *            
        !           274: *        Possible underflow. Play it safe.
        !           275: *
        !           276:          GO TO 80
        !           277:       END IF
        !           278: *
        !           279: *     Risk of underflow.
        !           280: *
        !           281:    80 CONTINUE
        !           282:       CALL DLASQ6( I0, N0, Z, PP, DMIN, DMIN1, DMIN2, DN, DN1, DN2 )
        !           283:       NDIV = NDIV + ( N0-I0+2 )
        !           284:       ITER = ITER + 1
        !           285:       TAU = ZERO
        !           286: *
        !           287:    90 CONTINUE
        !           288:       IF( TAU.LT.SIGMA ) THEN
        !           289:          DESIG = DESIG + TAU
        !           290:          T = SIGMA + DESIG
        !           291:          DESIG = DESIG - ( T-SIGMA )
        !           292:       ELSE
        !           293:          T = SIGMA + TAU
        !           294:          DESIG = SIGMA - ( T-TAU ) + DESIG
        !           295:       END IF
        !           296:       SIGMA = T
        !           297: *
        !           298:       RETURN
        !           299: *
        !           300: *     End of DLASQ3
        !           301: *
        !           302:       END

CVSweb interface <joel.bertrand@systella.fr>