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

1.1     ! bertrand    1:       SUBROUTINE ZSYTRS2( UPLO, N, NRHS, A, LDA, IPIV, B, LDB, 
        !             2:      $                    WORK, INFO )
        !             3: *
        !             4: *  -- LAPACK PROTOTYPE routine (version 3.2.2) --
        !             5: *
        !             6: *  -- Written by Julie Langou of the Univ. of TN    --
        !             7: *     May 2010
        !             8: *
        !             9: *  -- LAPACK is a software package provided by Univ. of Tennessee,    --
        !            10: *  -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..--
        !            11: *
        !            12: *     .. Scalar Arguments ..
        !            13:       CHARACTER          UPLO
        !            14:       INTEGER            INFO, LDA, LDB, N, NRHS
        !            15: *     ..
        !            16: *     .. Array Arguments ..
        !            17:       INTEGER            IPIV( * )
        !            18:       DOUBLE COMPLEX   A( LDA, * ), B( LDB, * ), WORK( * )
        !            19: *     ..
        !            20: *
        !            21: *  Purpose
        !            22: *  =======
        !            23: *
        !            24: *  ZSYTRS2 solves a system of linear equations A*X = B with a real
        !            25: *  symmetric matrix A using the factorization A = U*D*U**T or
        !            26: *  A = L*D*L**T computed by ZSYTRF and converted by ZSYCONV.
        !            27: *
        !            28: *  Arguments
        !            29: *  =========
        !            30: *
        !            31: *  UPLO    (input) CHARACTER*1
        !            32: *          Specifies whether the details of the factorization are stored
        !            33: *          as an upper or lower triangular matrix.
        !            34: *          = 'U':  Upper triangular, form is A = U*D*U**T;
        !            35: *          = 'L':  Lower triangular, form is A = L*D*L**T.
        !            36: *
        !            37: *  N       (input) INTEGER
        !            38: *          The order of the matrix A.  N >= 0.
        !            39: *
        !            40: *  NRHS    (input) INTEGER
        !            41: *          The number of right hand sides, i.e., the number of columns
        !            42: *          of the matrix B.  NRHS >= 0.
        !            43: *
        !            44: *  A       (input) DOUBLE COMPLEX array, dimension (LDA,N)
        !            45: *          The block diagonal matrix D and the multipliers used to
        !            46: *          obtain the factor U or L as computed by ZSYTRF.
        !            47: *
        !            48: *  LDA     (input) INTEGER
        !            49: *          The leading dimension of the array A.  LDA >= max(1,N).
        !            50: *
        !            51: *  IPIV    (input) INTEGER array, dimension (N)
        !            52: *          Details of the interchanges and the block structure of D
        !            53: *          as determined by ZSYTRF.
        !            54: *
        !            55: *  B       (input/output) DOUBLE COMPLEX array, dimension (LDB,NRHS)
        !            56: *          On entry, the right hand side matrix B.
        !            57: *          On exit, the solution matrix X.
        !            58: *
        !            59: *  LDB     (input) INTEGER
        !            60: *          The leading dimension of the array B.  LDB >= max(1,N).
        !            61: *
        !            62: *  WORK    (workspace) REAL array, dimension (N)
        !            63: *
        !            64: *  INFO    (output) INTEGER
        !            65: *          = 0:  successful exit
        !            66: *          < 0:  if INFO = -i, the i-th argument had an illegal value
        !            67: *
        !            68: *  =====================================================================
        !            69: *
        !            70: *     .. Parameters ..
        !            71:       DOUBLE COMPLEX     ONE
        !            72:       PARAMETER          ( ONE = (1.0D+0,0.0D+0) )
        !            73: *     ..
        !            74: *     .. Local Scalars ..
        !            75:       LOGICAL            UPPER
        !            76:       INTEGER            I, IINFO, J, K, KP
        !            77:       DOUBLE COMPLEX     AK, AKM1, AKM1K, BK, BKM1, DENOM
        !            78: *     ..
        !            79: *     .. External Functions ..
        !            80:       LOGICAL            LSAME
        !            81:       EXTERNAL           LSAME
        !            82: *     ..
        !            83: *     .. External Subroutines ..
        !            84:       EXTERNAL           ZSCAL, ZSYCONV, ZSWAP, ZTRSM, XERBLA
        !            85: *     ..
        !            86: *     .. Intrinsic Functions ..
        !            87:       INTRINSIC          MAX
        !            88: *     ..
        !            89: *     .. Executable Statements ..
        !            90: *
        !            91:       INFO = 0
        !            92:       UPPER = LSAME( UPLO, 'U' )
        !            93:       IF( .NOT.UPPER .AND. .NOT.LSAME( UPLO, 'L' ) ) THEN
        !            94:          INFO = -1
        !            95:       ELSE IF( N.LT.0 ) THEN
        !            96:          INFO = -2
        !            97:       ELSE IF( NRHS.LT.0 ) THEN
        !            98:          INFO = -3
        !            99:       ELSE IF( LDA.LT.MAX( 1, N ) ) THEN
        !           100:          INFO = -5
        !           101:       ELSE IF( LDB.LT.MAX( 1, N ) ) THEN
        !           102:          INFO = -8
        !           103:       END IF
        !           104:       IF( INFO.NE.0 ) THEN
        !           105:          CALL XERBLA( 'ZSYTRS2', -INFO )
        !           106:          RETURN
        !           107:       END IF
        !           108: *
        !           109: *     Quick return if possible
        !           110: *
        !           111:       IF( N.EQ.0 .OR. NRHS.EQ.0 )
        !           112:      $   RETURN
        !           113: *
        !           114: *     Convert A
        !           115: *
        !           116:       CALL ZSYCONV( UPLO, 'C', N, A, LDA, IPIV, WORK, IINFO )
        !           117: *
        !           118:       IF( UPPER ) THEN
        !           119: *
        !           120: *        Solve A*X = B, where A = U*D*U'.
        !           121: *
        !           122: *       P' * B  
        !           123:         K=N
        !           124:         DO WHILE ( K .GE. 1 )
        !           125:          IF( IPIV( K ).GT.0 ) THEN
        !           126: *           1 x 1 diagonal block
        !           127: *           Interchange rows K and IPIV(K).
        !           128:             KP = IPIV( K )
        !           129:             IF( KP.NE.K )
        !           130:      $         CALL ZSWAP( NRHS, B( K, 1 ), LDB, B( KP, 1 ), LDB )
        !           131:             K=K-1
        !           132:          ELSE
        !           133: *           2 x 2 diagonal block
        !           134: *           Interchange rows K-1 and -IPIV(K).
        !           135:             KP = -IPIV( K )
        !           136:             IF( KP.EQ.-IPIV( K-1 ) )
        !           137:      $         CALL ZSWAP( NRHS, B( K-1, 1 ), LDB, B( KP, 1 ), LDB )
        !           138:             K=K-2
        !           139:          END IF
        !           140:         END DO
        !           141: *
        !           142: *  Compute (U \P' * B) -> B    [ (U \P' * B) ]
        !           143: *
        !           144:         CALL ZTRSM('L','U','N','U',N,NRHS,ONE,A,N,B,N)
        !           145: *
        !           146: *  Compute D \ B -> B   [ D \ (U \P' * B) ]
        !           147: *       
        !           148:          I=N
        !           149:          DO WHILE ( I .GE. 1 )
        !           150:             IF( IPIV(I) .GT. 0 ) THEN
        !           151:               CALL ZSCAL( NRHS, ONE / A( I, I ), B( I, 1 ), N )
        !           152:             ELSEIF ( I .GT. 1) THEN
        !           153:                IF ( IPIV(I-1) .EQ. IPIV(I) ) THEN
        !           154:                   AKM1K = WORK(I)
        !           155:                   AKM1 = A( I-1, I-1 ) / AKM1K
        !           156:                   AK = A( I, I ) / AKM1K
        !           157:                   DENOM = AKM1*AK - ONE
        !           158:                   DO 15 J = 1, NRHS
        !           159:                      BKM1 = B( I-1, J ) / AKM1K
        !           160:                      BK = B( I, J ) / AKM1K
        !           161:                      B( I-1, J ) = ( AK*BKM1-BK ) / DENOM
        !           162:                      B( I, J ) = ( AKM1*BK-BKM1 ) / DENOM
        !           163:  15              CONTINUE
        !           164:                I = I - 1
        !           165:                ENDIF
        !           166:             ENDIF
        !           167:             I = I - 1
        !           168:          END DO
        !           169: *
        !           170: *      Compute (U' \ B) -> B   [ U' \ (D \ (U \P' * B) ) ]
        !           171: *
        !           172:          CALL ZTRSM('L','U','T','U',N,NRHS,ONE,A,N,B,N)
        !           173: *
        !           174: *       P * B  [ P * (U' \ (D \ (U \P' * B) )) ]
        !           175: *
        !           176:         K=1
        !           177:         DO WHILE ( K .LE. N )
        !           178:          IF( IPIV( K ).GT.0 ) THEN
        !           179: *           1 x 1 diagonal block
        !           180: *           Interchange rows K and IPIV(K).
        !           181:             KP = IPIV( K )
        !           182:             IF( KP.NE.K )
        !           183:      $         CALL ZSWAP( NRHS, B( K, 1 ), LDB, B( KP, 1 ), LDB )
        !           184:             K=K+1
        !           185:          ELSE
        !           186: *           2 x 2 diagonal block
        !           187: *           Interchange rows K-1 and -IPIV(K).
        !           188:             KP = -IPIV( K )
        !           189:             IF( K .LT. N .AND. KP.EQ.-IPIV( K+1 ) )
        !           190:      $         CALL ZSWAP( NRHS, B( K, 1 ), LDB, B( KP, 1 ), LDB )
        !           191:             K=K+2
        !           192:          ENDIF
        !           193:         END DO
        !           194: *
        !           195:       ELSE
        !           196: *
        !           197: *        Solve A*X = B, where A = L*D*L'.
        !           198: *
        !           199: *       P' * B  
        !           200:         K=1
        !           201:         DO WHILE ( K .LE. N )
        !           202:          IF( IPIV( K ).GT.0 ) THEN
        !           203: *           1 x 1 diagonal block
        !           204: *           Interchange rows K and IPIV(K).
        !           205:             KP = IPIV( K )
        !           206:             IF( KP.NE.K )
        !           207:      $         CALL ZSWAP( NRHS, B( K, 1 ), LDB, B( KP, 1 ), LDB )
        !           208:             K=K+1
        !           209:          ELSE
        !           210: *           2 x 2 diagonal block
        !           211: *           Interchange rows K and -IPIV(K+1).
        !           212:             KP = -IPIV( K+1 )
        !           213:             IF( KP.EQ.-IPIV( K ) )
        !           214:      $         CALL ZSWAP( NRHS, B( K+1, 1 ), LDB, B( KP, 1 ), LDB )
        !           215:             K=K+2
        !           216:          ENDIF
        !           217:         END DO
        !           218: *
        !           219: *  Compute (L \P' * B) -> B    [ (L \P' * B) ]
        !           220: *
        !           221:         CALL ZTRSM('L','L','N','U',N,NRHS,ONE,A,N,B,N)
        !           222: *
        !           223: *  Compute D \ B -> B   [ D \ (L \P' * B) ]
        !           224: *       
        !           225:          I=1
        !           226:          DO WHILE ( I .LE. N )
        !           227:             IF( IPIV(I) .GT. 0 ) THEN
        !           228:               CALL ZSCAL( NRHS, ONE / A( I, I ), B( I, 1 ), N )
        !           229:             ELSE
        !           230:                   AKM1K = WORK(I)
        !           231:                   AKM1 = A( I, I ) / AKM1K
        !           232:                   AK = A( I+1, I+1 ) / AKM1K
        !           233:                   DENOM = AKM1*AK - ONE
        !           234:                   DO 25 J = 1, NRHS
        !           235:                      BKM1 = B( I, J ) / AKM1K
        !           236:                      BK = B( I+1, J ) / AKM1K
        !           237:                      B( I, J ) = ( AK*BKM1-BK ) / DENOM
        !           238:                      B( I+1, J ) = ( AKM1*BK-BKM1 ) / DENOM
        !           239:  25              CONTINUE
        !           240:                   I = I + 1
        !           241:             ENDIF
        !           242:             I = I + 1
        !           243:          END DO
        !           244: *
        !           245: *  Compute (L' \ B) -> B   [ L' \ (D \ (L \P' * B) ) ]
        !           246: * 
        !           247:         CALL ZTRSM('L','L','T','U',N,NRHS,ONE,A,N,B,N)
        !           248: *
        !           249: *       P * B  [ P * (L' \ (D \ (L \P' * B) )) ]
        !           250: *
        !           251:         K=N
        !           252:         DO WHILE ( K .GE. 1 )
        !           253:          IF( IPIV( K ).GT.0 ) THEN
        !           254: *           1 x 1 diagonal block
        !           255: *           Interchange rows K and IPIV(K).
        !           256:             KP = IPIV( K )
        !           257:             IF( KP.NE.K )
        !           258:      $         CALL ZSWAP( NRHS, B( K, 1 ), LDB, B( KP, 1 ), LDB )
        !           259:             K=K-1
        !           260:          ELSE
        !           261: *           2 x 2 diagonal block
        !           262: *           Interchange rows K-1 and -IPIV(K).
        !           263:             KP = -IPIV( K )
        !           264:             IF( K.GT.1 .AND. KP.EQ.-IPIV( K-1 ) )
        !           265:      $         CALL ZSWAP( NRHS, B( K, 1 ), LDB, B( KP, 1 ), LDB )
        !           266:             K=K-2
        !           267:          ENDIF
        !           268:         END DO
        !           269: *
        !           270:       END IF
        !           271: *
        !           272: *     Revert A
        !           273: *
        !           274:       CALL ZSYCONV( UPLO, 'R', N, A, LDA, IPIV, WORK, IINFO )
        !           275: *
        !           276:       RETURN
        !           277: *
        !           278: *     End of ZSYTRS2
        !           279: *
        !           280:       END

CVSweb interface <joel.bertrand@systella.fr>