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

1.4       bertrand    1: *> \brief \b DSYCONV
                      2: *
                      3: *  =========== DOCUMENTATION ===========
                      4: *
                      5: * Online html documentation available at 
                      6: *            http://www.netlib.org/lapack/explore-html/ 
                      7: *
                      8: *> \htmlonly
                      9: *> Download DSYCONV + dependencies 
                     10: *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.tgz?format=tgz&filename=/lapack/lapack_routine/dsyconv.f"> 
                     11: *> [TGZ]</a> 
                     12: *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.zip?format=zip&filename=/lapack/lapack_routine/dsyconv.f"> 
                     13: *> [ZIP]</a> 
                     14: *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.txt?format=txt&filename=/lapack/lapack_routine/dsyconv.f"> 
                     15: *> [TXT]</a>
                     16: *> \endhtmlonly 
                     17: *
                     18: *  Definition:
                     19: *  ===========
                     20: *
                     21: *       SUBROUTINE DSYCONV( UPLO, WAY, N, A, LDA, IPIV, WORK, INFO )
                     22: * 
                     23: *       .. Scalar Arguments ..
                     24: *       CHARACTER          UPLO, WAY
                     25: *       INTEGER            INFO, LDA, N
                     26: *       ..
                     27: *       .. Array Arguments ..
                     28: *       INTEGER            IPIV( * )
                     29: *       DOUBLE PRECISION   A( LDA, * ), WORK( * )
                     30: *       ..
                     31: *  
                     32: *
                     33: *> \par Purpose:
                     34: *  =============
                     35: *>
                     36: *> \verbatim
                     37: *>
                     38: *> DSYCONV convert A given by TRF into L and D and vice-versa.
                     39: *> Get Non-diag elements of D (returned in workspace) and 
                     40: *> apply or reverse permutation done in TRF.
                     41: *> \endverbatim
                     42: *
                     43: *  Arguments:
                     44: *  ==========
                     45: *
                     46: *> \param[in] UPLO
                     47: *> \verbatim
                     48: *>          UPLO is CHARACTER*1
                     49: *>          Specifies whether the details of the factorization are stored
                     50: *>          as an upper or lower triangular matrix.
                     51: *>          = 'U':  Upper triangular, form is A = U*D*U**T;
                     52: *>          = 'L':  Lower triangular, form is A = L*D*L**T.
                     53: *> \endverbatim
                     54: *>
                     55: *> \param[in] WAY
                     56: *> \verbatim
                     57: *>          WAY is CHARACTER*1
                     58: *>          = 'C': Convert 
                     59: *>          = 'R': Revert
                     60: *> \endverbatim
                     61: *>
                     62: *> \param[in] N
                     63: *> \verbatim
                     64: *>          N is INTEGER
                     65: *>          The order of the matrix A.  N >= 0.
                     66: *> \endverbatim
                     67: *>
                     68: *> \param[in] A
                     69: *> \verbatim
                     70: *>          A is DOUBLE PRECISION array, dimension (LDA,N)
                     71: *>          The block diagonal matrix D and the multipliers used to
                     72: *>          obtain the factor U or L as computed by DSYTRF.
                     73: *> \endverbatim
                     74: *>
                     75: *> \param[in] LDA
                     76: *> \verbatim
                     77: *>          LDA is INTEGER
                     78: *>          The leading dimension of the array A.  LDA >= max(1,N).
                     79: *> \endverbatim
                     80: *>
                     81: *> \param[in] IPIV
                     82: *> \verbatim
                     83: *>          IPIV is INTEGER array, dimension (N)
                     84: *>          Details of the interchanges and the block structure of D
                     85: *>          as determined by DSYTRF.
                     86: *> \endverbatim
                     87: *>
                     88: *> \param[out] WORK
                     89: *> \verbatim
                     90: *>          WORK is DOUBLE PRECISION array, dimension (N)
                     91: *> \endverbatim
                     92: *>
                     93: *> \param[out] INFO
                     94: *> \verbatim
                     95: *>          INFO is INTEGER
                     96: *>          = 0:  successful exit
                     97: *>          < 0:  if INFO = -i, the i-th argument had an illegal value
                     98: *> \endverbatim
                     99: *
                    100: *  Authors:
                    101: *  ========
                    102: *
                    103: *> \author Univ. of Tennessee 
                    104: *> \author Univ. of California Berkeley 
                    105: *> \author Univ. of Colorado Denver 
                    106: *> \author NAG Ltd. 
                    107: *
                    108: *> \date November 2011
                    109: *
                    110: *> \ingroup doubleSYcomputational
                    111: *
                    112: *  =====================================================================
1.1       bertrand  113:       SUBROUTINE DSYCONV( UPLO, WAY, N, A, LDA, IPIV, WORK, INFO )
                    114: *
1.4       bertrand  115: *  -- LAPACK computational routine (version 3.4.0) --
1.1       bertrand  116: *  -- LAPACK is a software package provided by Univ. of Tennessee,    --
                    117: *  -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..--
1.4       bertrand  118: *     November 2011
1.1       bertrand  119: *
                    120: *     .. Scalar Arguments ..
                    121:       CHARACTER          UPLO, WAY
                    122:       INTEGER            INFO, LDA, N
                    123: *     ..
                    124: *     .. Array Arguments ..
                    125:       INTEGER            IPIV( * )
                    126:       DOUBLE PRECISION   A( LDA, * ), WORK( * )
                    127: *     ..
                    128: *
                    129: *  =====================================================================
                    130: *
                    131: *     .. Parameters ..
                    132:       DOUBLE PRECISION   ZERO
                    133:       PARAMETER          ( ZERO = 0.0D+0 )
                    134: *     ..
                    135: *     .. External Functions ..
                    136:       LOGICAL            LSAME
                    137:       EXTERNAL           LSAME
                    138: *
                    139: *     .. External Subroutines ..
                    140:       EXTERNAL           XERBLA
                    141: *     .. Local Scalars ..
                    142:       LOGICAL            UPPER, CONVERT
                    143:       INTEGER            I, IP, J
                    144:       DOUBLE PRECISION   TEMP
                    145: *     ..
                    146: *     .. Executable Statements ..
                    147: *
                    148:       INFO = 0
                    149:       UPPER = LSAME( UPLO, 'U' )
                    150:       CONVERT = LSAME( WAY, 'C' )
                    151:       IF( .NOT.UPPER .AND. .NOT.LSAME( UPLO, 'L' ) ) THEN
                    152:          INFO = -1
                    153:       ELSE IF( .NOT.CONVERT .AND. .NOT.LSAME( WAY, 'R' ) ) THEN
                    154:          INFO = -2
                    155:       ELSE IF( N.LT.0 ) THEN
                    156:          INFO = -3
                    157:       ELSE IF( LDA.LT.MAX( 1, N ) ) THEN
                    158:          INFO = -5
                    159: 
                    160:       END IF
                    161:       IF( INFO.NE.0 ) THEN
                    162:          CALL XERBLA( 'DSYCONV', -INFO )
                    163:          RETURN
                    164:       END IF
                    165: *
                    166: *     Quick return if possible
                    167: *
                    168:       IF( N.EQ.0 )
                    169:      $   RETURN
                    170: *
                    171:       IF( UPPER ) THEN
                    172: *
                    173: *      A is UPPER
                    174: *
                    175: *      Convert A (A is upper)
                    176: *
                    177: *        Convert VALUE
                    178: *
                    179:          IF ( CONVERT ) THEN
                    180:             I=N
                    181:             WORK(1)=ZERO
                    182:             DO WHILE ( I .GT. 1 )
                    183:                IF( IPIV(I) .LT. 0 ) THEN
                    184:                   WORK(I)=A(I-1,I)
                    185:                   A(I-1,I)=ZERO
                    186:                   I=I-1
                    187:                ELSE
                    188:                   WORK(I)=ZERO
                    189:                ENDIF
                    190:                I=I-1
                    191:             END DO
                    192: *
                    193: *        Convert PERMUTATIONS
                    194: *  
                    195:          I=N
                    196:          DO WHILE ( I .GE. 1 )
                    197:             IF( IPIV(I) .GT. 0) THEN
                    198:                IP=IPIV(I)
                    199:                IF( I .LT. N) THEN
                    200:                   DO 12 J= I+1,N
                    201:                     TEMP=A(IP,J)
                    202:                     A(IP,J)=A(I,J)
                    203:                     A(I,J)=TEMP
                    204:  12            CONTINUE
                    205:                ENDIF
                    206:             ELSE
                    207:               IP=-IPIV(I)
                    208:                IF( I .LT. N) THEN
                    209:              DO 13 J= I+1,N
                    210:                  TEMP=A(IP,J)
                    211:                  A(IP,J)=A(I-1,J)
                    212:                  A(I-1,J)=TEMP
                    213:  13            CONTINUE
                    214:                 ENDIF
                    215:                 I=I-1
                    216:            ENDIF
                    217:            I=I-1
                    218:         END DO
                    219: 
                    220:          ELSE
                    221: *
                    222: *      Revert A (A is upper)
                    223: *
                    224: *
                    225: *        Revert PERMUTATIONS
                    226: *  
                    227:             I=1
                    228:             DO WHILE ( I .LE. N )
                    229:                IF( IPIV(I) .GT. 0 ) THEN
                    230:                   IP=IPIV(I)
                    231:                   IF( I .LT. N) THEN
                    232:                   DO J= I+1,N
                    233:                     TEMP=A(IP,J)
                    234:                     A(IP,J)=A(I,J)
                    235:                     A(I,J)=TEMP
                    236:                   END DO
                    237:                   ENDIF
                    238:                ELSE
                    239:                  IP=-IPIV(I)
                    240:                  I=I+1
                    241:                  IF( I .LT. N) THEN
                    242:                     DO J= I+1,N
                    243:                        TEMP=A(IP,J)
                    244:                        A(IP,J)=A(I-1,J)
                    245:                        A(I-1,J)=TEMP
                    246:                     END DO
                    247:                  ENDIF
                    248:                ENDIF
                    249:                I=I+1
                    250:             END DO
                    251: *
                    252: *        Revert VALUE
                    253: *
                    254:             I=N
                    255:             DO WHILE ( I .GT. 1 )
                    256:                IF( IPIV(I) .LT. 0 ) THEN
                    257:                   A(I-1,I)=WORK(I)
                    258:                   I=I-1
                    259:                ENDIF
                    260:                I=I-1
                    261:             END DO
                    262:          END IF
                    263:       ELSE
                    264: *
                    265: *      A is LOWER
                    266: *
                    267:          IF ( CONVERT ) THEN
                    268: *
                    269: *      Convert A (A is lower)
                    270: *
                    271: *
                    272: *        Convert VALUE
                    273: *
                    274:             I=1
                    275:             WORK(N)=ZERO
                    276:             DO WHILE ( I .LE. N )
                    277:                IF( I.LT.N .AND. IPIV(I) .LT. 0 ) THEN
                    278:                   WORK(I)=A(I+1,I)
                    279:                   A(I+1,I)=ZERO
                    280:                   I=I+1
                    281:                ELSE
                    282:                   WORK(I)=ZERO
                    283:                ENDIF
                    284:                I=I+1
                    285:             END DO
                    286: *
                    287: *        Convert PERMUTATIONS
                    288: *
                    289:          I=1
                    290:          DO WHILE ( I .LE. N )
                    291:             IF( IPIV(I) .GT. 0 ) THEN
                    292:                IP=IPIV(I)
                    293:                IF (I .GT. 1) THEN
                    294:                DO 22 J= 1,I-1
                    295:                  TEMP=A(IP,J)
                    296:                  A(IP,J)=A(I,J)
                    297:                  A(I,J)=TEMP
                    298:  22            CONTINUE
                    299:                ENDIF
                    300:             ELSE
                    301:               IP=-IPIV(I)
                    302:               IF (I .GT. 1) THEN
                    303:               DO 23 J= 1,I-1
                    304:                  TEMP=A(IP,J)
                    305:                  A(IP,J)=A(I+1,J)
                    306:                  A(I+1,J)=TEMP
                    307:  23           CONTINUE
                    308:               ENDIF
                    309:               I=I+1
                    310:            ENDIF
                    311:            I=I+1
                    312:         END DO
                    313:          ELSE
                    314: *
                    315: *      Revert A (A is lower)
                    316: *
                    317: *
                    318: *        Revert PERMUTATIONS
                    319: *
                    320:             I=N
                    321:             DO WHILE ( I .GE. 1 )
                    322:                IF( IPIV(I) .GT. 0 ) THEN
                    323:                   IP=IPIV(I)
                    324:                   IF (I .GT. 1) THEN
                    325:                      DO J= 1,I-1
                    326:                         TEMP=A(I,J)
                    327:                         A(I,J)=A(IP,J)
                    328:                         A(IP,J)=TEMP
                    329:                      END DO
                    330:                   ENDIF
                    331:                ELSE
                    332:                   IP=-IPIV(I)
                    333:                   I=I-1
                    334:                   IF (I .GT. 1) THEN
                    335:                      DO J= 1,I-1
                    336:                         TEMP=A(I+1,J)
                    337:                         A(I+1,J)=A(IP,J)
                    338:                         A(IP,J)=TEMP
                    339:                      END DO
                    340:                   ENDIF
                    341:                ENDIF
                    342:                I=I-1
                    343:             END DO
                    344: *
                    345: *        Revert VALUE
                    346: *
                    347:             I=1
                    348:             DO WHILE ( I .LE. N-1 )
                    349:                IF( IPIV(I) .LT. ZERO ) THEN
                    350:                   A(I+1,I)=WORK(I)
                    351:                   I=I+1
                    352:                ENDIF
                    353:                I=I+1
                    354:             END DO
                    355:          END IF
                    356:       END IF
                    357: 
                    358:       RETURN
                    359: *
                    360: *     End of DSYCONV
                    361: *
                    362:       END

CVSweb interface <joel.bertrand@systella.fr>