Annotation of rpl/lapack/lapack/zgtts2.f, revision 1.7

1.1       bertrand    1:       SUBROUTINE ZGTTS2( ITRANS, N, NRHS, DL, D, DU, DU2, IPIV, B, LDB )
                      2: *
                      3: *  -- LAPACK auxiliary routine (version 3.2) --
                      4: *  -- LAPACK is a software package provided by Univ. of Tennessee,    --
                      5: *  -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..--
                      6: *     November 2006
                      7: *
                      8: *     .. Scalar Arguments ..
                      9:       INTEGER            ITRANS, LDB, N, NRHS
                     10: *     ..
                     11: *     .. Array Arguments ..
                     12:       INTEGER            IPIV( * )
                     13:       COMPLEX*16         B( LDB, * ), D( * ), DL( * ), DU( * ), DU2( * )
                     14: *     ..
                     15: *
                     16: *  Purpose
                     17: *  =======
                     18: *
                     19: *  ZGTTS2 solves one of the systems of equations
                     20: *     A * X = B,  A**T * X = B,  or  A**H * X = B,
                     21: *  with a tridiagonal matrix A using the LU factorization computed
                     22: *  by ZGTTRF.
                     23: *
                     24: *  Arguments
                     25: *  =========
                     26: *
                     27: *  ITRANS  (input) INTEGER
                     28: *          Specifies the form of the system of equations.
                     29: *          = 0:  A * X = B     (No transpose)
                     30: *          = 1:  A**T * X = B  (Transpose)
                     31: *          = 2:  A**H * X = B  (Conjugate transpose)
                     32: *
                     33: *  N       (input) INTEGER
                     34: *          The order of the matrix A.
                     35: *
                     36: *  NRHS    (input) INTEGER
                     37: *          The number of right hand sides, i.e., the number of columns
                     38: *          of the matrix B.  NRHS >= 0.
                     39: *
                     40: *  DL      (input) COMPLEX*16 array, dimension (N-1)
                     41: *          The (n-1) multipliers that define the matrix L from the
                     42: *          LU factorization of A.
                     43: *
                     44: *  D       (input) COMPLEX*16 array, dimension (N)
                     45: *          The n diagonal elements of the upper triangular matrix U from
                     46: *          the LU factorization of A.
                     47: *
                     48: *  DU      (input) COMPLEX*16 array, dimension (N-1)
                     49: *          The (n-1) elements of the first super-diagonal of U.
                     50: *
                     51: *  DU2     (input) COMPLEX*16 array, dimension (N-2)
                     52: *          The (n-2) elements of the second super-diagonal of U.
                     53: *
                     54: *  IPIV    (input) INTEGER array, dimension (N)
                     55: *          The pivot indices; for 1 <= i <= n, row i of the matrix was
                     56: *          interchanged with row IPIV(i).  IPIV(i) will always be either
                     57: *          i or i+1; IPIV(i) = i indicates a row interchange was not
                     58: *          required.
                     59: *
                     60: *  B       (input/output) COMPLEX*16 array, dimension (LDB,NRHS)
                     61: *          On entry, the matrix of right hand side vectors B.
                     62: *          On exit, B is overwritten by the solution vectors X.
                     63: *
                     64: *  LDB     (input) INTEGER
                     65: *          The leading dimension of the array B.  LDB >= max(1,N).
                     66: *
                     67: *  =====================================================================
                     68: *
                     69: *     .. Local Scalars ..
                     70:       INTEGER            I, J
                     71:       COMPLEX*16         TEMP
                     72: *     ..
                     73: *     .. Intrinsic Functions ..
                     74:       INTRINSIC          DCONJG
                     75: *     ..
                     76: *     .. Executable Statements ..
                     77: *
                     78: *     Quick return if possible
                     79: *
                     80:       IF( N.EQ.0 .OR. NRHS.EQ.0 )
                     81:      $   RETURN
                     82: *
                     83:       IF( ITRANS.EQ.0 ) THEN
                     84: *
                     85: *        Solve A*X = B using the LU factorization of A,
                     86: *        overwriting each right hand side vector with its solution.
                     87: *
                     88:          IF( NRHS.LE.1 ) THEN
                     89:             J = 1
                     90:    10       CONTINUE
                     91: *
                     92: *           Solve L*x = b.
                     93: *
                     94:             DO 20 I = 1, N - 1
                     95:                IF( IPIV( I ).EQ.I ) THEN
                     96:                   B( I+1, J ) = B( I+1, J ) - DL( I )*B( I, J )
                     97:                ELSE
                     98:                   TEMP = B( I, J )
                     99:                   B( I, J ) = B( I+1, J )
                    100:                   B( I+1, J ) = TEMP - DL( I )*B( I, J )
                    101:                END IF
                    102:    20       CONTINUE
                    103: *
                    104: *           Solve U*x = b.
                    105: *
                    106:             B( N, J ) = B( N, J ) / D( N )
                    107:             IF( N.GT.1 )
                    108:      $         B( N-1, J ) = ( B( N-1, J )-DU( N-1 )*B( N, J ) ) /
                    109:      $                       D( N-1 )
                    110:             DO 30 I = N - 2, 1, -1
                    111:                B( I, J ) = ( B( I, J )-DU( I )*B( I+1, J )-DU2( I )*
                    112:      $                     B( I+2, J ) ) / D( I )
                    113:    30       CONTINUE
                    114:             IF( J.LT.NRHS ) THEN
                    115:                J = J + 1
                    116:                GO TO 10
                    117:             END IF
                    118:          ELSE
                    119:             DO 60 J = 1, NRHS
                    120: *
                    121: *           Solve L*x = b.
                    122: *
                    123:                DO 40 I = 1, N - 1
                    124:                   IF( IPIV( I ).EQ.I ) THEN
                    125:                      B( I+1, J ) = B( I+1, J ) - DL( I )*B( I, J )
                    126:                   ELSE
                    127:                      TEMP = B( I, J )
                    128:                      B( I, J ) = B( I+1, J )
                    129:                      B( I+1, J ) = TEMP - DL( I )*B( I, J )
                    130:                   END IF
                    131:    40          CONTINUE
                    132: *
                    133: *           Solve U*x = b.
                    134: *
                    135:                B( N, J ) = B( N, J ) / D( N )
                    136:                IF( N.GT.1 )
                    137:      $            B( N-1, J ) = ( B( N-1, J )-DU( N-1 )*B( N, J ) ) /
                    138:      $                          D( N-1 )
                    139:                DO 50 I = N - 2, 1, -1
                    140:                   B( I, J ) = ( B( I, J )-DU( I )*B( I+1, J )-DU2( I )*
                    141:      $                        B( I+2, J ) ) / D( I )
                    142:    50          CONTINUE
                    143:    60       CONTINUE
                    144:          END IF
                    145:       ELSE IF( ITRANS.EQ.1 ) THEN
                    146: *
                    147: *        Solve A**T * X = B.
                    148: *
                    149:          IF( NRHS.LE.1 ) THEN
                    150:             J = 1
                    151:    70       CONTINUE
                    152: *
                    153: *           Solve U**T * x = b.
                    154: *
                    155:             B( 1, J ) = B( 1, J ) / D( 1 )
                    156:             IF( N.GT.1 )
                    157:      $         B( 2, J ) = ( B( 2, J )-DU( 1 )*B( 1, J ) ) / D( 2 )
                    158:             DO 80 I = 3, N
                    159:                B( I, J ) = ( B( I, J )-DU( I-1 )*B( I-1, J )-DU2( I-2 )*
                    160:      $                     B( I-2, J ) ) / D( I )
                    161:    80       CONTINUE
                    162: *
                    163: *           Solve L**T * x = b.
                    164: *
                    165:             DO 90 I = N - 1, 1, -1
                    166:                IF( IPIV( I ).EQ.I ) THEN
                    167:                   B( I, J ) = B( I, J ) - DL( I )*B( I+1, J )
                    168:                ELSE
                    169:                   TEMP = B( I+1, J )
                    170:                   B( I+1, J ) = B( I, J ) - DL( I )*TEMP
                    171:                   B( I, J ) = TEMP
                    172:                END IF
                    173:    90       CONTINUE
                    174:             IF( J.LT.NRHS ) THEN
                    175:                J = J + 1
                    176:                GO TO 70
                    177:             END IF
                    178:          ELSE
                    179:             DO 120 J = 1, NRHS
                    180: *
                    181: *           Solve U**T * x = b.
                    182: *
                    183:                B( 1, J ) = B( 1, J ) / D( 1 )
                    184:                IF( N.GT.1 )
                    185:      $            B( 2, J ) = ( B( 2, J )-DU( 1 )*B( 1, J ) ) / D( 2 )
                    186:                DO 100 I = 3, N
                    187:                   B( I, J ) = ( B( I, J )-DU( I-1 )*B( I-1, J )-
                    188:      $                        DU2( I-2 )*B( I-2, J ) ) / D( I )
                    189:   100          CONTINUE
                    190: *
                    191: *           Solve L**T * x = b.
                    192: *
                    193:                DO 110 I = N - 1, 1, -1
                    194:                   IF( IPIV( I ).EQ.I ) THEN
                    195:                      B( I, J ) = B( I, J ) - DL( I )*B( I+1, J )
                    196:                   ELSE
                    197:                      TEMP = B( I+1, J )
                    198:                      B( I+1, J ) = B( I, J ) - DL( I )*TEMP
                    199:                      B( I, J ) = TEMP
                    200:                   END IF
                    201:   110          CONTINUE
                    202:   120       CONTINUE
                    203:          END IF
                    204:       ELSE
                    205: *
                    206: *        Solve A**H * X = B.
                    207: *
                    208:          IF( NRHS.LE.1 ) THEN
                    209:             J = 1
                    210:   130       CONTINUE
                    211: *
                    212: *           Solve U**H * x = b.
                    213: *
                    214:             B( 1, J ) = B( 1, J ) / DCONJG( D( 1 ) )
                    215:             IF( N.GT.1 )
                    216:      $         B( 2, J ) = ( B( 2, J )-DCONJG( DU( 1 ) )*B( 1, J ) ) /
                    217:      $                     DCONJG( D( 2 ) )
                    218:             DO 140 I = 3, N
                    219:                B( I, J ) = ( B( I, J )-DCONJG( DU( I-1 ) )*B( I-1, J )-
                    220:      $                     DCONJG( DU2( I-2 ) )*B( I-2, J ) ) /
                    221:      $                     DCONJG( D( I ) )
                    222:   140       CONTINUE
                    223: *
                    224: *           Solve L**H * x = b.
                    225: *
                    226:             DO 150 I = N - 1, 1, -1
                    227:                IF( IPIV( I ).EQ.I ) THEN
                    228:                   B( I, J ) = B( I, J ) - DCONJG( DL( I ) )*B( I+1, J )
                    229:                ELSE
                    230:                   TEMP = B( I+1, J )
                    231:                   B( I+1, J ) = B( I, J ) - DCONJG( DL( I ) )*TEMP
                    232:                   B( I, J ) = TEMP
                    233:                END IF
                    234:   150       CONTINUE
                    235:             IF( J.LT.NRHS ) THEN
                    236:                J = J + 1
                    237:                GO TO 130
                    238:             END IF
                    239:          ELSE
                    240:             DO 180 J = 1, NRHS
                    241: *
                    242: *           Solve U**H * x = b.
                    243: *
                    244:                B( 1, J ) = B( 1, J ) / DCONJG( D( 1 ) )
                    245:                IF( N.GT.1 )
                    246:      $            B( 2, J ) = ( B( 2, J )-DCONJG( DU( 1 ) )*B( 1, J ) )
                    247:      $                         / DCONJG( D( 2 ) )
                    248:                DO 160 I = 3, N
                    249:                   B( I, J ) = ( B( I, J )-DCONJG( DU( I-1 ) )*
                    250:      $                        B( I-1, J )-DCONJG( DU2( I-2 ) )*
                    251:      $                        B( I-2, J ) ) / DCONJG( D( I ) )
                    252:   160          CONTINUE
                    253: *
                    254: *           Solve L**H * x = b.
                    255: *
                    256:                DO 170 I = N - 1, 1, -1
                    257:                   IF( IPIV( I ).EQ.I ) THEN
                    258:                      B( I, J ) = B( I, J ) - DCONJG( DL( I ) )*
                    259:      $                           B( I+1, J )
                    260:                   ELSE
                    261:                      TEMP = B( I+1, J )
                    262:                      B( I+1, J ) = B( I, J ) - DCONJG( DL( I ) )*TEMP
                    263:                      B( I, J ) = TEMP
                    264:                   END IF
                    265:   170          CONTINUE
                    266:   180       CONTINUE
                    267:          END IF
                    268:       END IF
                    269: *
                    270: *     End of ZGTTS2
                    271: *
                    272:       END

CVSweb interface <joel.bertrand@systella.fr>