Annotation of rpl/lapack/lapack/zlarfb.f, revision 1.12

1.12    ! bertrand    1: *> \brief \b ZLARFB applies a block reflector or its conjugate-transpose to a general rectangular matrix.
1.9       bertrand    2: *
                      3: *  =========== DOCUMENTATION ===========
                      4: *
                      5: * Online html documentation available at 
                      6: *            http://www.netlib.org/lapack/explore-html/ 
                      7: *
                      8: *> \htmlonly
                      9: *> Download ZLARFB + dependencies 
                     10: *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.tgz?format=tgz&filename=/lapack/lapack_routine/zlarfb.f"> 
                     11: *> [TGZ]</a> 
                     12: *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.zip?format=zip&filename=/lapack/lapack_routine/zlarfb.f"> 
                     13: *> [ZIP]</a> 
                     14: *> <a href="http://www.netlib.org/cgi-bin/netlibfiles.txt?format=txt&filename=/lapack/lapack_routine/zlarfb.f"> 
                     15: *> [TXT]</a>
                     16: *> \endhtmlonly 
                     17: *
                     18: *  Definition:
                     19: *  ===========
                     20: *
                     21: *       SUBROUTINE ZLARFB( SIDE, TRANS, DIRECT, STOREV, M, N, K, V, LDV,
                     22: *                          T, LDT, C, LDC, WORK, LDWORK )
                     23: * 
                     24: *       .. Scalar Arguments ..
                     25: *       CHARACTER          DIRECT, SIDE, STOREV, TRANS
                     26: *       INTEGER            K, LDC, LDT, LDV, LDWORK, M, N
                     27: *       ..
                     28: *       .. Array Arguments ..
                     29: *       COMPLEX*16         C( LDC, * ), T( LDT, * ), V( LDV, * ),
                     30: *      $                   WORK( LDWORK, * )
                     31: *       ..
                     32: *  
                     33: *
                     34: *> \par Purpose:
                     35: *  =============
                     36: *>
                     37: *> \verbatim
                     38: *>
                     39: *> ZLARFB applies a complex block reflector H or its transpose H**H to a
                     40: *> complex M-by-N matrix C, from either the left or the right.
                     41: *> \endverbatim
                     42: *
                     43: *  Arguments:
                     44: *  ==========
                     45: *
                     46: *> \param[in] SIDE
                     47: *> \verbatim
                     48: *>          SIDE is CHARACTER*1
                     49: *>          = 'L': apply H or H**H from the Left
                     50: *>          = 'R': apply H or H**H from the Right
                     51: *> \endverbatim
                     52: *>
                     53: *> \param[in] TRANS
                     54: *> \verbatim
                     55: *>          TRANS is CHARACTER*1
                     56: *>          = 'N': apply H (No transpose)
                     57: *>          = 'C': apply H**H (Conjugate transpose)
                     58: *> \endverbatim
                     59: *>
                     60: *> \param[in] DIRECT
                     61: *> \verbatim
                     62: *>          DIRECT is CHARACTER*1
                     63: *>          Indicates how H is formed from a product of elementary
                     64: *>          reflectors
                     65: *>          = 'F': H = H(1) H(2) . . . H(k) (Forward)
                     66: *>          = 'B': H = H(k) . . . H(2) H(1) (Backward)
                     67: *> \endverbatim
                     68: *>
                     69: *> \param[in] STOREV
                     70: *> \verbatim
                     71: *>          STOREV is CHARACTER*1
                     72: *>          Indicates how the vectors which define the elementary
                     73: *>          reflectors are stored:
                     74: *>          = 'C': Columnwise
                     75: *>          = 'R': Rowwise
                     76: *> \endverbatim
                     77: *>
                     78: *> \param[in] M
                     79: *> \verbatim
                     80: *>          M is INTEGER
                     81: *>          The number of rows of the matrix C.
                     82: *> \endverbatim
                     83: *>
                     84: *> \param[in] N
                     85: *> \verbatim
                     86: *>          N is INTEGER
                     87: *>          The number of columns of the matrix C.
                     88: *> \endverbatim
                     89: *>
                     90: *> \param[in] K
                     91: *> \verbatim
                     92: *>          K is INTEGER
                     93: *>          The order of the matrix T (= the number of elementary
                     94: *>          reflectors whose product defines the block reflector).
                     95: *> \endverbatim
                     96: *>
                     97: *> \param[in] V
                     98: *> \verbatim
                     99: *>          V is COMPLEX*16 array, dimension
                    100: *>                                (LDV,K) if STOREV = 'C'
                    101: *>                                (LDV,M) if STOREV = 'R' and SIDE = 'L'
                    102: *>                                (LDV,N) if STOREV = 'R' and SIDE = 'R'
                    103: *>          See Further Details.
                    104: *> \endverbatim
                    105: *>
                    106: *> \param[in] LDV
                    107: *> \verbatim
                    108: *>          LDV is INTEGER
                    109: *>          The leading dimension of the array V.
                    110: *>          If STOREV = 'C' and SIDE = 'L', LDV >= max(1,M);
                    111: *>          if STOREV = 'C' and SIDE = 'R', LDV >= max(1,N);
                    112: *>          if STOREV = 'R', LDV >= K.
                    113: *> \endverbatim
                    114: *>
                    115: *> \param[in] T
                    116: *> \verbatim
                    117: *>          T is COMPLEX*16 array, dimension (LDT,K)
                    118: *>          The triangular K-by-K matrix T in the representation of the
                    119: *>          block reflector.
                    120: *> \endverbatim
                    121: *>
                    122: *> \param[in] LDT
                    123: *> \verbatim
                    124: *>          LDT is INTEGER
                    125: *>          The leading dimension of the array T. LDT >= K.
                    126: *> \endverbatim
                    127: *>
                    128: *> \param[in,out] C
                    129: *> \verbatim
                    130: *>          C is COMPLEX*16 array, dimension (LDC,N)
                    131: *>          On entry, the M-by-N matrix C.
                    132: *>          On exit, C is overwritten by H*C or H**H*C or C*H or C*H**H.
                    133: *> \endverbatim
                    134: *>
                    135: *> \param[in] LDC
                    136: *> \verbatim
                    137: *>          LDC is INTEGER
                    138: *>          The leading dimension of the array C. LDC >= max(1,M).
                    139: *> \endverbatim
                    140: *>
                    141: *> \param[out] WORK
                    142: *> \verbatim
                    143: *>          WORK is COMPLEX*16 array, dimension (LDWORK,K)
                    144: *> \endverbatim
                    145: *>
                    146: *> \param[in] LDWORK
                    147: *> \verbatim
                    148: *>          LDWORK is INTEGER
                    149: *>          The leading dimension of the array WORK.
                    150: *>          If SIDE = 'L', LDWORK >= max(1,N);
                    151: *>          if SIDE = 'R', LDWORK >= max(1,M).
                    152: *> \endverbatim
                    153: *
                    154: *  Authors:
                    155: *  ========
                    156: *
                    157: *> \author Univ. of Tennessee 
                    158: *> \author Univ. of California Berkeley 
                    159: *> \author Univ. of Colorado Denver 
                    160: *> \author NAG Ltd. 
                    161: *
1.12    ! bertrand  162: *> \date September 2012
1.9       bertrand  163: *
                    164: *> \ingroup complex16OTHERauxiliary
                    165: *
                    166: *> \par Further Details:
                    167: *  =====================
                    168: *>
                    169: *> \verbatim
                    170: *>
                    171: *>  The shape of the matrix V and the storage of the vectors which define
                    172: *>  the H(i) is best illustrated by the following example with n = 5 and
                    173: *>  k = 3. The elements equal to 1 are not stored; the corresponding
                    174: *>  array elements are modified but restored on exit. The rest of the
                    175: *>  array is not used.
                    176: *>
                    177: *>  DIRECT = 'F' and STOREV = 'C':         DIRECT = 'F' and STOREV = 'R':
                    178: *>
                    179: *>               V = (  1       )                 V = (  1 v1 v1 v1 v1 )
                    180: *>                   ( v1  1    )                     (     1 v2 v2 v2 )
                    181: *>                   ( v1 v2  1 )                     (        1 v3 v3 )
                    182: *>                   ( v1 v2 v3 )
                    183: *>                   ( v1 v2 v3 )
                    184: *>
                    185: *>  DIRECT = 'B' and STOREV = 'C':         DIRECT = 'B' and STOREV = 'R':
                    186: *>
                    187: *>               V = ( v1 v2 v3 )                 V = ( v1 v1  1       )
                    188: *>                   ( v1 v2 v3 )                     ( v2 v2 v2  1    )
                    189: *>                   (  1 v2 v3 )                     ( v3 v3 v3 v3  1 )
                    190: *>                   (     1 v3 )
                    191: *>                   (        1 )
                    192: *> \endverbatim
                    193: *>
                    194: *  =====================================================================
1.1       bertrand  195:       SUBROUTINE ZLARFB( SIDE, TRANS, DIRECT, STOREV, M, N, K, V, LDV,
                    196:      $                   T, LDT, C, LDC, WORK, LDWORK )
                    197: *
1.12    ! bertrand  198: *  -- LAPACK auxiliary routine (version 3.4.2) --
1.1       bertrand  199: *  -- LAPACK is a software package provided by Univ. of Tennessee,    --
                    200: *  -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..--
1.12    ! bertrand  201: *     September 2012
1.1       bertrand  202: *
                    203: *     .. Scalar Arguments ..
                    204:       CHARACTER          DIRECT, SIDE, STOREV, TRANS
                    205:       INTEGER            K, LDC, LDT, LDV, LDWORK, M, N
                    206: *     ..
                    207: *     .. Array Arguments ..
                    208:       COMPLEX*16         C( LDC, * ), T( LDT, * ), V( LDV, * ),
                    209:      $                   WORK( LDWORK, * )
                    210: *     ..
                    211: *
                    212: *  =====================================================================
                    213: *
                    214: *     .. Parameters ..
                    215:       COMPLEX*16         ONE
                    216:       PARAMETER          ( ONE = ( 1.0D+0, 0.0D+0 ) )
                    217: *     ..
                    218: *     .. Local Scalars ..
                    219:       CHARACTER          TRANST
                    220:       INTEGER            I, J, LASTV, LASTC
                    221: *     ..
                    222: *     .. External Functions ..
                    223:       LOGICAL            LSAME
                    224:       INTEGER            ILAZLR, ILAZLC
                    225:       EXTERNAL           LSAME, ILAZLR, ILAZLC
                    226: *     ..
                    227: *     .. External Subroutines ..
                    228:       EXTERNAL           ZCOPY, ZGEMM, ZLACGV, ZTRMM
                    229: *     ..
                    230: *     .. Intrinsic Functions ..
                    231:       INTRINSIC          DCONJG
                    232: *     ..
                    233: *     .. Executable Statements ..
                    234: *
                    235: *     Quick return if possible
                    236: *
                    237:       IF( M.LE.0 .OR. N.LE.0 )
                    238:      $   RETURN
                    239: *
                    240:       IF( LSAME( TRANS, 'N' ) ) THEN
                    241:          TRANST = 'C'
                    242:       ELSE
                    243:          TRANST = 'N'
                    244:       END IF
                    245: *
                    246:       IF( LSAME( STOREV, 'C' ) ) THEN
                    247: *
                    248:          IF( LSAME( DIRECT, 'F' ) ) THEN
                    249: *
                    250: *           Let  V =  ( V1 )    (first K rows)
                    251: *                     ( V2 )
                    252: *           where  V1  is unit lower triangular.
                    253: *
                    254:             IF( LSAME( SIDE, 'L' ) ) THEN
                    255: *
1.8       bertrand  256: *              Form  H * C  or  H**H * C  where  C = ( C1 )
                    257: *                                                    ( C2 )
1.1       bertrand  258: *
                    259:                LASTV = MAX( K, ILAZLR( M, K, V, LDV ) )
                    260:                LASTC = ILAZLC( LASTV, N, C, LDC )
                    261: *
1.8       bertrand  262: *              W := C**H * V  =  (C1**H * V1 + C2**H * V2)  (stored in WORK)
1.1       bertrand  263: *
1.8       bertrand  264: *              W := C1**H
1.1       bertrand  265: *
                    266:                DO 10 J = 1, K
                    267:                   CALL ZCOPY( LASTC, C( J, 1 ), LDC, WORK( 1, J ), 1 )
                    268:                   CALL ZLACGV( LASTC, WORK( 1, J ), 1 )
                    269:    10          CONTINUE
                    270: *
                    271: *              W := W * V1
                    272: *
                    273:                CALL ZTRMM( 'Right', 'Lower', 'No transpose', 'Unit',
                    274:      $              LASTC, K, ONE, V, LDV, WORK, LDWORK )
                    275:                IF( LASTV.GT.K ) THEN
                    276: *
1.8       bertrand  277: *                 W := W + C2**H *V2
1.1       bertrand  278: *
                    279:                   CALL ZGEMM( 'Conjugate transpose', 'No transpose',
                    280:      $                 LASTC, K, LASTV-K, ONE, C( K+1, 1 ), LDC,
                    281:      $                 V( K+1, 1 ), LDV, ONE, WORK, LDWORK )
                    282:                END IF
                    283: *
1.8       bertrand  284: *              W := W * T**H  or  W * T
1.1       bertrand  285: *
                    286:                CALL ZTRMM( 'Right', 'Upper', TRANST, 'Non-unit',
                    287:      $              LASTC, K, ONE, T, LDT, WORK, LDWORK )
                    288: *
1.8       bertrand  289: *              C := C - V * W**H
1.1       bertrand  290: *
                    291:                IF( M.GT.K ) THEN
                    292: *
1.8       bertrand  293: *                 C2 := C2 - V2 * W**H
1.1       bertrand  294: *
                    295:                   CALL ZGEMM( 'No transpose', 'Conjugate transpose',
                    296:      $                 LASTV-K, LASTC, K,
                    297:      $                 -ONE, V( K+1, 1 ), LDV, WORK, LDWORK,
                    298:      $                 ONE, C( K+1, 1 ), LDC )
                    299:                END IF
                    300: *
1.8       bertrand  301: *              W := W * V1**H
1.1       bertrand  302: *
                    303:                CALL ZTRMM( 'Right', 'Lower', 'Conjugate transpose',
                    304:      $              'Unit', LASTC, K, ONE, V, LDV, WORK, LDWORK )
                    305: *
1.8       bertrand  306: *              C1 := C1 - W**H
1.1       bertrand  307: *
                    308:                DO 30 J = 1, K
                    309:                   DO 20 I = 1, LASTC
                    310:                      C( J, I ) = C( J, I ) - DCONJG( WORK( I, J ) )
                    311:    20             CONTINUE
                    312:    30          CONTINUE
                    313: *
                    314:             ELSE IF( LSAME( SIDE, 'R' ) ) THEN
                    315: *
1.8       bertrand  316: *              Form  C * H  or  C * H**H  where  C = ( C1  C2 )
1.1       bertrand  317: *
                    318:                LASTV = MAX( K, ILAZLR( N, K, V, LDV ) )
                    319:                LASTC = ILAZLR( M, LASTV, C, LDC )
                    320: *
                    321: *              W := C * V  =  (C1*V1 + C2*V2)  (stored in WORK)
                    322: *
                    323: *              W := C1
                    324: *
                    325:                DO 40 J = 1, K
                    326:                   CALL ZCOPY( LASTC, C( 1, J ), 1, WORK( 1, J ), 1 )
                    327:    40          CONTINUE
                    328: *
                    329: *              W := W * V1
                    330: *
                    331:                CALL ZTRMM( 'Right', 'Lower', 'No transpose', 'Unit',
                    332:      $              LASTC, K, ONE, V, LDV, WORK, LDWORK )
                    333:                IF( LASTV.GT.K ) THEN
                    334: *
                    335: *                 W := W + C2 * V2
                    336: *
                    337:                   CALL ZGEMM( 'No transpose', 'No transpose',
                    338:      $                 LASTC, K, LASTV-K,
                    339:      $                 ONE, C( 1, K+1 ), LDC, V( K+1, 1 ), LDV,
                    340:      $                 ONE, WORK, LDWORK )
                    341:                END IF
                    342: *
1.8       bertrand  343: *              W := W * T  or  W * T**H
1.1       bertrand  344: *
                    345:                CALL ZTRMM( 'Right', 'Upper', TRANS, 'Non-unit',
                    346:      $              LASTC, K, ONE, T, LDT, WORK, LDWORK )
                    347: *
1.8       bertrand  348: *              C := C - W * V**H
1.1       bertrand  349: *
                    350:                IF( LASTV.GT.K ) THEN
                    351: *
1.8       bertrand  352: *                 C2 := C2 - W * V2**H
1.1       bertrand  353: *
                    354:                   CALL ZGEMM( 'No transpose', 'Conjugate transpose',
                    355:      $                 LASTC, LASTV-K, K,
                    356:      $                 -ONE, WORK, LDWORK, V( K+1, 1 ), LDV,
                    357:      $                 ONE, C( 1, K+1 ), LDC )
                    358:                END IF
                    359: *
1.8       bertrand  360: *              W := W * V1**H
1.1       bertrand  361: *
                    362:                CALL ZTRMM( 'Right', 'Lower', 'Conjugate transpose',
                    363:      $              'Unit', LASTC, K, ONE, V, LDV, WORK, LDWORK )
                    364: *
                    365: *              C1 := C1 - W
                    366: *
                    367:                DO 60 J = 1, K
                    368:                   DO 50 I = 1, LASTC
                    369:                      C( I, J ) = C( I, J ) - WORK( I, J )
                    370:    50             CONTINUE
                    371:    60          CONTINUE
                    372:             END IF
                    373: *
                    374:          ELSE
                    375: *
                    376: *           Let  V =  ( V1 )
                    377: *                     ( V2 )    (last K rows)
                    378: *           where  V2  is unit upper triangular.
                    379: *
                    380:             IF( LSAME( SIDE, 'L' ) ) THEN
                    381: *
1.8       bertrand  382: *              Form  H * C  or  H**H * C  where  C = ( C1 )
                    383: *                                                    ( C2 )
1.1       bertrand  384: *
1.12    ! bertrand  385:                LASTC = ILAZLC( M, N, C, LDC )
1.1       bertrand  386: *
1.8       bertrand  387: *              W := C**H * V  =  (C1**H * V1 + C2**H * V2)  (stored in WORK)
1.1       bertrand  388: *
1.8       bertrand  389: *              W := C2**H
1.1       bertrand  390: *
                    391:                DO 70 J = 1, K
1.12    ! bertrand  392:                   CALL ZCOPY( LASTC, C( M-K+J, 1 ), LDC,
1.1       bertrand  393:      $                 WORK( 1, J ), 1 )
                    394:                   CALL ZLACGV( LASTC, WORK( 1, J ), 1 )
                    395:    70          CONTINUE
                    396: *
                    397: *              W := W * V2
                    398: *
                    399:                CALL ZTRMM( 'Right', 'Upper', 'No transpose', 'Unit',
1.12    ! bertrand  400:      $              LASTC, K, ONE, V( M-K+1, 1 ), LDV,
1.1       bertrand  401:      $              WORK, LDWORK )
1.12    ! bertrand  402:                IF( M.GT.K ) THEN
1.1       bertrand  403: *
1.8       bertrand  404: *                 W := W + C1**H*V1
1.1       bertrand  405: *
                    406:                   CALL ZGEMM( 'Conjugate transpose', 'No transpose',
1.12    ! bertrand  407:      $                 LASTC, K, M-K,
1.1       bertrand  408:      $                 ONE, C, LDC, V, LDV,
                    409:      $                 ONE, WORK, LDWORK )
                    410:                END IF
                    411: *
1.8       bertrand  412: *              W := W * T**H  or  W * T
1.1       bertrand  413: *
                    414:                CALL ZTRMM( 'Right', 'Lower', TRANST, 'Non-unit',
                    415:      $              LASTC, K, ONE, T, LDT, WORK, LDWORK )
                    416: *
1.8       bertrand  417: *              C := C - V * W**H
1.1       bertrand  418: *
1.12    ! bertrand  419:                IF( M.GT.K ) THEN
1.1       bertrand  420: *
1.8       bertrand  421: *                 C1 := C1 - V1 * W**H
1.1       bertrand  422: *
                    423:                   CALL ZGEMM( 'No transpose', 'Conjugate transpose',
1.12    ! bertrand  424:      $                 M-K, LASTC, K,
1.1       bertrand  425:      $                 -ONE, V, LDV, WORK, LDWORK,
                    426:      $                 ONE, C, LDC )
                    427:                END IF
                    428: *
1.8       bertrand  429: *              W := W * V2**H
1.1       bertrand  430: *
                    431:                CALL ZTRMM( 'Right', 'Upper', 'Conjugate transpose',
1.12    ! bertrand  432:      $              'Unit', LASTC, K, ONE, V( M-K+1, 1 ), LDV,
1.1       bertrand  433:      $              WORK, LDWORK )
                    434: *
1.8       bertrand  435: *              C2 := C2 - W**H
1.1       bertrand  436: *
                    437:                DO 90 J = 1, K
                    438:                   DO 80 I = 1, LASTC
1.12    ! bertrand  439:                      C( M-K+J, I ) = C( M-K+J, I ) -
1.1       bertrand  440:      $                               DCONJG( WORK( I, J ) )
                    441:    80             CONTINUE
                    442:    90          CONTINUE
                    443: *
                    444:             ELSE IF( LSAME( SIDE, 'R' ) ) THEN
                    445: *
1.8       bertrand  446: *              Form  C * H  or  C * H**H  where  C = ( C1  C2 )
1.1       bertrand  447: *
1.12    ! bertrand  448:                LASTC = ILAZLR( M, N, C, LDC )
1.1       bertrand  449: *
                    450: *              W := C * V  =  (C1*V1 + C2*V2)  (stored in WORK)
                    451: *
                    452: *              W := C2
                    453: *
                    454:                DO 100 J = 1, K
1.12    ! bertrand  455:                   CALL ZCOPY( LASTC, C( 1, N-K+J ), 1,
1.1       bertrand  456:      $                 WORK( 1, J ), 1 )
                    457:   100          CONTINUE
                    458: *
                    459: *              W := W * V2
                    460: *
                    461:                CALL ZTRMM( 'Right', 'Upper', 'No transpose', 'Unit',
1.12    ! bertrand  462:      $              LASTC, K, ONE, V( N-K+1, 1 ), LDV,
1.1       bertrand  463:      $              WORK, LDWORK )
1.12    ! bertrand  464:                IF( N.GT.K ) THEN
1.1       bertrand  465: *
                    466: *                 W := W + C1 * V1
                    467: *
                    468:                   CALL ZGEMM( 'No transpose', 'No transpose',
1.12    ! bertrand  469:      $                 LASTC, K, N-K,
1.1       bertrand  470:      $                 ONE, C, LDC, V, LDV, ONE, WORK, LDWORK )
                    471:                END IF
                    472: *
1.8       bertrand  473: *              W := W * T  or  W * T**H
1.1       bertrand  474: *
                    475:                CALL ZTRMM( 'Right', 'Lower', TRANS, 'Non-unit',
                    476:      $              LASTC, K, ONE, T, LDT, WORK, LDWORK )
                    477: *
1.8       bertrand  478: *              C := C - W * V**H
1.1       bertrand  479: *
1.12    ! bertrand  480:                IF( N.GT.K ) THEN
1.1       bertrand  481: *
1.8       bertrand  482: *                 C1 := C1 - W * V1**H
1.1       bertrand  483: *
                    484:                   CALL ZGEMM( 'No transpose', 'Conjugate transpose',
1.12    ! bertrand  485:      $                 LASTC, N-K, K, -ONE, WORK, LDWORK, V, LDV,
1.1       bertrand  486:      $                 ONE, C, LDC )
                    487:                END IF
                    488: *
1.8       bertrand  489: *              W := W * V2**H
1.1       bertrand  490: *
                    491:                CALL ZTRMM( 'Right', 'Upper', 'Conjugate transpose',
1.12    ! bertrand  492:      $              'Unit', LASTC, K, ONE, V( N-K+1, 1 ), LDV,
1.1       bertrand  493:      $              WORK, LDWORK )
                    494: *
                    495: *              C2 := C2 - W
                    496: *
                    497:                DO 120 J = 1, K
                    498:                   DO 110 I = 1, LASTC
1.12    ! bertrand  499:                      C( I, N-K+J ) = C( I, N-K+J )
1.1       bertrand  500:      $                    - WORK( I, J )
                    501:   110             CONTINUE
                    502:   120          CONTINUE
                    503:             END IF
                    504:          END IF
                    505: *
                    506:       ELSE IF( LSAME( STOREV, 'R' ) ) THEN
                    507: *
                    508:          IF( LSAME( DIRECT, 'F' ) ) THEN
                    509: *
                    510: *           Let  V =  ( V1  V2 )    (V1: first K columns)
                    511: *           where  V1  is unit upper triangular.
                    512: *
                    513:             IF( LSAME( SIDE, 'L' ) ) THEN
                    514: *
1.8       bertrand  515: *              Form  H * C  or  H**H * C  where  C = ( C1 )
                    516: *                                                    ( C2 )
1.1       bertrand  517: *
                    518:                LASTV = MAX( K, ILAZLC( K, M, V, LDV ) )
                    519:                LASTC = ILAZLC( LASTV, N, C, LDC )
                    520: *
1.8       bertrand  521: *              W := C**H * V**H  =  (C1**H * V1**H + C2**H * V2**H) (stored in WORK)
1.1       bertrand  522: *
1.8       bertrand  523: *              W := C1**H
1.1       bertrand  524: *
                    525:                DO 130 J = 1, K
                    526:                   CALL ZCOPY( LASTC, C( J, 1 ), LDC, WORK( 1, J ), 1 )
                    527:                   CALL ZLACGV( LASTC, WORK( 1, J ), 1 )
                    528:   130          CONTINUE
                    529: *
1.8       bertrand  530: *              W := W * V1**H
1.1       bertrand  531: *
                    532:                CALL ZTRMM( 'Right', 'Upper', 'Conjugate transpose',
                    533:      $                     'Unit', LASTC, K, ONE, V, LDV, WORK, LDWORK )
                    534:                IF( LASTV.GT.K ) THEN
                    535: *
1.8       bertrand  536: *                 W := W + C2**H*V2**H
1.1       bertrand  537: *
                    538:                   CALL ZGEMM( 'Conjugate transpose',
                    539:      $                 'Conjugate transpose', LASTC, K, LASTV-K,
                    540:      $                 ONE, C( K+1, 1 ), LDC, V( 1, K+1 ), LDV,
                    541:      $                 ONE, WORK, LDWORK )
                    542:                END IF
                    543: *
1.8       bertrand  544: *              W := W * T**H  or  W * T
1.1       bertrand  545: *
                    546:                CALL ZTRMM( 'Right', 'Upper', TRANST, 'Non-unit',
                    547:      $              LASTC, K, ONE, T, LDT, WORK, LDWORK )
                    548: *
1.8       bertrand  549: *              C := C - V**H * W**H
1.1       bertrand  550: *
                    551:                IF( LASTV.GT.K ) THEN
                    552: *
1.8       bertrand  553: *                 C2 := C2 - V2**H * W**H
1.1       bertrand  554: *
                    555:                   CALL ZGEMM( 'Conjugate transpose',
                    556:      $                 'Conjugate transpose', LASTV-K, LASTC, K,
                    557:      $                 -ONE, V( 1, K+1 ), LDV, WORK, LDWORK,
                    558:      $                 ONE, C( K+1, 1 ), LDC )
                    559:                END IF
                    560: *
                    561: *              W := W * V1
                    562: *
                    563:                CALL ZTRMM( 'Right', 'Upper', 'No transpose', 'Unit',
                    564:      $              LASTC, K, ONE, V, LDV, WORK, LDWORK )
                    565: *
1.8       bertrand  566: *              C1 := C1 - W**H
1.1       bertrand  567: *
                    568:                DO 150 J = 1, K
                    569:                   DO 140 I = 1, LASTC
                    570:                      C( J, I ) = C( J, I ) - DCONJG( WORK( I, J ) )
                    571:   140             CONTINUE
                    572:   150          CONTINUE
                    573: *
                    574:             ELSE IF( LSAME( SIDE, 'R' ) ) THEN
                    575: *
1.8       bertrand  576: *              Form  C * H  or  C * H**H  where  C = ( C1  C2 )
1.1       bertrand  577: *
                    578:                LASTV = MAX( K, ILAZLC( K, N, V, LDV ) )
                    579:                LASTC = ILAZLR( M, LASTV, C, LDC )
                    580: *
1.8       bertrand  581: *              W := C * V**H  =  (C1*V1**H + C2*V2**H)  (stored in WORK)
1.1       bertrand  582: *
                    583: *              W := C1
                    584: *
                    585:                DO 160 J = 1, K
                    586:                   CALL ZCOPY( LASTC, C( 1, J ), 1, WORK( 1, J ), 1 )
                    587:   160          CONTINUE
                    588: *
1.8       bertrand  589: *              W := W * V1**H
1.1       bertrand  590: *
                    591:                CALL ZTRMM( 'Right', 'Upper', 'Conjugate transpose',
                    592:      $                     'Unit', LASTC, K, ONE, V, LDV, WORK, LDWORK )
                    593:                IF( LASTV.GT.K ) THEN
                    594: *
1.8       bertrand  595: *                 W := W + C2 * V2**H
1.1       bertrand  596: *
                    597:                   CALL ZGEMM( 'No transpose', 'Conjugate transpose',
                    598:      $                 LASTC, K, LASTV-K, ONE, C( 1, K+1 ), LDC,
                    599:      $                 V( 1, K+1 ), LDV, ONE, WORK, LDWORK )
                    600:                END IF
                    601: *
1.8       bertrand  602: *              W := W * T  or  W * T**H
1.1       bertrand  603: *
                    604:                CALL ZTRMM( 'Right', 'Upper', TRANS, 'Non-unit',
                    605:      $              LASTC, K, ONE, T, LDT, WORK, LDWORK )
                    606: *
                    607: *              C := C - W * V
                    608: *
                    609:                IF( LASTV.GT.K ) THEN
                    610: *
                    611: *                 C2 := C2 - W * V2
                    612: *
                    613:                   CALL ZGEMM( 'No transpose', 'No transpose',
                    614:      $                 LASTC, LASTV-K, K,
                    615:      $                 -ONE, WORK, LDWORK, V( 1, K+1 ), LDV,
                    616:      $                 ONE, C( 1, K+1 ), LDC )
                    617:                END IF
                    618: *
                    619: *              W := W * V1
                    620: *
                    621:                CALL ZTRMM( 'Right', 'Upper', 'No transpose', 'Unit',
                    622:      $              LASTC, K, ONE, V, LDV, WORK, LDWORK )
                    623: *
                    624: *              C1 := C1 - W
                    625: *
                    626:                DO 180 J = 1, K
                    627:                   DO 170 I = 1, LASTC
                    628:                      C( I, J ) = C( I, J ) - WORK( I, J )
                    629:   170             CONTINUE
                    630:   180          CONTINUE
                    631: *
                    632:             END IF
                    633: *
                    634:          ELSE
                    635: *
                    636: *           Let  V =  ( V1  V2 )    (V2: last K columns)
                    637: *           where  V2  is unit lower triangular.
                    638: *
                    639:             IF( LSAME( SIDE, 'L' ) ) THEN
                    640: *
1.8       bertrand  641: *              Form  H * C  or  H**H * C  where  C = ( C1 )
                    642: *                                                    ( C2 )
1.1       bertrand  643: *
1.12    ! bertrand  644:                LASTC = ILAZLC( M, N, C, LDC )
1.1       bertrand  645: *
1.8       bertrand  646: *              W := C**H * V**H  =  (C1**H * V1**H + C2**H * V2**H) (stored in WORK)
1.1       bertrand  647: *
1.8       bertrand  648: *              W := C2**H
1.1       bertrand  649: *
                    650:                DO 190 J = 1, K
1.12    ! bertrand  651:                   CALL ZCOPY( LASTC, C( M-K+J, 1 ), LDC,
1.1       bertrand  652:      $                 WORK( 1, J ), 1 )
                    653:                   CALL ZLACGV( LASTC, WORK( 1, J ), 1 )
                    654:   190          CONTINUE
                    655: *
1.8       bertrand  656: *              W := W * V2**H
1.1       bertrand  657: *
                    658:                CALL ZTRMM( 'Right', 'Lower', 'Conjugate transpose',
1.12    ! bertrand  659:      $              'Unit', LASTC, K, ONE, V( 1, M-K+1 ), LDV,
1.1       bertrand  660:      $              WORK, LDWORK )
1.12    ! bertrand  661:                IF( M.GT.K ) THEN
1.1       bertrand  662: *
1.8       bertrand  663: *                 W := W + C1**H * V1**H
1.1       bertrand  664: *
                    665:                   CALL ZGEMM( 'Conjugate transpose',
1.12    ! bertrand  666:      $                 'Conjugate transpose', LASTC, K, M-K,
1.1       bertrand  667:      $                 ONE, C, LDC, V, LDV, ONE, WORK, LDWORK )
                    668:                END IF
                    669: *
1.8       bertrand  670: *              W := W * T**H  or  W * T
1.1       bertrand  671: *
                    672:                CALL ZTRMM( 'Right', 'Lower', TRANST, 'Non-unit',
                    673:      $              LASTC, K, ONE, T, LDT, WORK, LDWORK )
                    674: *
1.8       bertrand  675: *              C := C - V**H * W**H
1.1       bertrand  676: *
1.12    ! bertrand  677:                IF( M.GT.K ) THEN
1.1       bertrand  678: *
1.8       bertrand  679: *                 C1 := C1 - V1**H * W**H
1.1       bertrand  680: *
                    681:                   CALL ZGEMM( 'Conjugate transpose',
1.12    ! bertrand  682:      $                 'Conjugate transpose', M-K, LASTC, K,
1.1       bertrand  683:      $                 -ONE, V, LDV, WORK, LDWORK, ONE, C, LDC )
                    684:                END IF
                    685: *
                    686: *              W := W * V2
                    687: *
                    688:                CALL ZTRMM( 'Right', 'Lower', 'No transpose', 'Unit',
1.12    ! bertrand  689:      $              LASTC, K, ONE, V( 1, M-K+1 ), LDV,
1.1       bertrand  690:      $              WORK, LDWORK )
                    691: *
1.8       bertrand  692: *              C2 := C2 - W**H
1.1       bertrand  693: *
                    694:                DO 210 J = 1, K
                    695:                   DO 200 I = 1, LASTC
1.12    ! bertrand  696:                      C( M-K+J, I ) = C( M-K+J, I ) -
1.1       bertrand  697:      $                               DCONJG( WORK( I, J ) )
                    698:   200             CONTINUE
                    699:   210          CONTINUE
                    700: *
                    701:             ELSE IF( LSAME( SIDE, 'R' ) ) THEN
                    702: *
1.8       bertrand  703: *              Form  C * H  or  C * H**H  where  C = ( C1  C2 )
1.1       bertrand  704: *
1.12    ! bertrand  705:                LASTC = ILAZLR( M, N, C, LDC )
1.1       bertrand  706: *
1.8       bertrand  707: *              W := C * V**H  =  (C1*V1**H + C2*V2**H)  (stored in WORK)
1.1       bertrand  708: *
                    709: *              W := C2
                    710: *
                    711:                DO 220 J = 1, K
1.12    ! bertrand  712:                   CALL ZCOPY( LASTC, C( 1, N-K+J ), 1,
1.1       bertrand  713:      $                 WORK( 1, J ), 1 )
                    714:   220          CONTINUE
                    715: *
1.8       bertrand  716: *              W := W * V2**H
1.1       bertrand  717: *
                    718:                CALL ZTRMM( 'Right', 'Lower', 'Conjugate transpose',
1.12    ! bertrand  719:      $              'Unit', LASTC, K, ONE, V( 1, N-K+1 ), LDV,
1.1       bertrand  720:      $              WORK, LDWORK )
1.12    ! bertrand  721:                IF( N.GT.K ) THEN
1.1       bertrand  722: *
1.8       bertrand  723: *                 W := W + C1 * V1**H
1.1       bertrand  724: *
                    725:                   CALL ZGEMM( 'No transpose', 'Conjugate transpose',
1.12    ! bertrand  726:      $                 LASTC, K, N-K, ONE, C, LDC, V, LDV, ONE,
1.1       bertrand  727:      $                 WORK, LDWORK )
                    728:                END IF
                    729: *
1.8       bertrand  730: *              W := W * T  or  W * T**H
1.1       bertrand  731: *
                    732:                CALL ZTRMM( 'Right', 'Lower', TRANS, 'Non-unit',
                    733:      $              LASTC, K, ONE, T, LDT, WORK, LDWORK )
                    734: *
                    735: *              C := C - W * V
                    736: *
1.12    ! bertrand  737:                IF( N.GT.K ) THEN
1.1       bertrand  738: *
                    739: *                 C1 := C1 - W * V1
                    740: *
                    741:                   CALL ZGEMM( 'No transpose', 'No transpose',
1.12    ! bertrand  742:      $                 LASTC, N-K, K, -ONE, WORK, LDWORK, V, LDV,
1.1       bertrand  743:      $                 ONE, C, LDC )
                    744:                END IF
                    745: *
                    746: *              W := W * V2
                    747: *
                    748:                CALL ZTRMM( 'Right', 'Lower', 'No transpose', 'Unit',
1.12    ! bertrand  749:      $              LASTC, K, ONE, V( 1, N-K+1 ), LDV,
1.1       bertrand  750:      $              WORK, LDWORK )
                    751: *
                    752: *              C1 := C1 - W
                    753: *
                    754:                DO 240 J = 1, K
                    755:                   DO 230 I = 1, LASTC
1.12    ! bertrand  756:                      C( I, N-K+J ) = C( I, N-K+J ) - WORK( I, J )
1.1       bertrand  757:   230             CONTINUE
                    758:   240          CONTINUE
                    759: *
                    760:             END IF
                    761: *
                    762:          END IF
                    763:       END IF
                    764: *
                    765:       RETURN
                    766: *
                    767: *     End of ZLARFB
                    768: *
                    769:       END

CVSweb interface <joel.bertrand@systella.fr>