File:  [local] / rpl / lapack / lapack / zlarzb.f
Revision 1.5: download - view: text, annotated - select for diffs - revision graph
Sat Aug 7 13:22:41 2010 UTC (13 years, 9 months ago) by bertrand
Branches: MAIN
CVS tags: HEAD
Mise à jour globale de Lapack 3.2.2.

    1:       SUBROUTINE ZLARZB( SIDE, TRANS, DIRECT, STOREV, M, N, K, L, V,
    2:      $                   LDV, T, LDT, C, LDC, WORK, LDWORK )
    3: *
    4: *  -- LAPACK routine (version 3.2) --
    5: *  -- LAPACK is a software package provided by Univ. of Tennessee,    --
    6: *  -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..--
    7: *     November 2006
    8: *
    9: *     .. Scalar Arguments ..
   10:       CHARACTER          DIRECT, SIDE, STOREV, TRANS
   11:       INTEGER            K, L, LDC, LDT, LDV, LDWORK, M, N
   12: *     ..
   13: *     .. Array Arguments ..
   14:       COMPLEX*16         C( LDC, * ), T( LDT, * ), V( LDV, * ),
   15:      $                   WORK( LDWORK, * )
   16: *     ..
   17: *
   18: *  Purpose
   19: *  =======
   20: *
   21: *  ZLARZB applies a complex block reflector H or its transpose H**H
   22: *  to a complex distributed M-by-N  C from the left or the right.
   23: *
   24: *  Currently, only STOREV = 'R' and DIRECT = 'B' are supported.
   25: *
   26: *  Arguments
   27: *  =========
   28: *
   29: *  SIDE    (input) CHARACTER*1
   30: *          = 'L': apply H or H' from the Left
   31: *          = 'R': apply H or H' from the Right
   32: *
   33: *  TRANS   (input) CHARACTER*1
   34: *          = 'N': apply H (No transpose)
   35: *          = 'C': apply H' (Conjugate transpose)
   36: *
   37: *  DIRECT  (input) CHARACTER*1
   38: *          Indicates how H is formed from a product of elementary
   39: *          reflectors
   40: *          = 'F': H = H(1) H(2) . . . H(k) (Forward, not supported yet)
   41: *          = 'B': H = H(k) . . . H(2) H(1) (Backward)
   42: *
   43: *  STOREV  (input) CHARACTER*1
   44: *          Indicates how the vectors which define the elementary
   45: *          reflectors are stored:
   46: *          = 'C': Columnwise                        (not supported yet)
   47: *          = 'R': Rowwise
   48: *
   49: *  M       (input) INTEGER
   50: *          The number of rows of the matrix C.
   51: *
   52: *  N       (input) INTEGER
   53: *          The number of columns of the matrix C.
   54: *
   55: *  K       (input) INTEGER
   56: *          The order of the matrix T (= the number of elementary
   57: *          reflectors whose product defines the block reflector).
   58: *
   59: *  L       (input) INTEGER
   60: *          The number of columns of the matrix V containing the
   61: *          meaningful part of the Householder reflectors.
   62: *          If SIDE = 'L', M >= L >= 0, if SIDE = 'R', N >= L >= 0.
   63: *
   64: *  V       (input) COMPLEX*16 array, dimension (LDV,NV).
   65: *          If STOREV = 'C', NV = K; if STOREV = 'R', NV = L.
   66: *
   67: *  LDV     (input) INTEGER
   68: *          The leading dimension of the array V.
   69: *          If STOREV = 'C', LDV >= L; if STOREV = 'R', LDV >= K.
   70: *
   71: *  T       (input) COMPLEX*16 array, dimension (LDT,K)
   72: *          The triangular K-by-K matrix T in the representation of the
   73: *          block reflector.
   74: *
   75: *  LDT     (input) INTEGER
   76: *          The leading dimension of the array T. LDT >= K.
   77: *
   78: *  C       (input/output) COMPLEX*16 array, dimension (LDC,N)
   79: *          On entry, the M-by-N matrix C.
   80: *          On exit, C is overwritten by H*C or H'*C or C*H or C*H'.
   81: *
   82: *  LDC     (input) INTEGER
   83: *          The leading dimension of the array C. LDC >= max(1,M).
   84: *
   85: *  WORK    (workspace) COMPLEX*16 array, dimension (LDWORK,K)
   86: *
   87: *  LDWORK  (input) INTEGER
   88: *          The leading dimension of the array WORK.
   89: *          If SIDE = 'L', LDWORK >= max(1,N);
   90: *          if SIDE = 'R', LDWORK >= max(1,M).
   91: *
   92: *  Further Details
   93: *  ===============
   94: *
   95: *  Based on contributions by
   96: *    A. Petitet, Computer Science Dept., Univ. of Tenn., Knoxville, USA
   97: *
   98: *  =====================================================================
   99: *
  100: *     .. Parameters ..
  101:       COMPLEX*16         ONE
  102:       PARAMETER          ( ONE = ( 1.0D+0, 0.0D+0 ) )
  103: *     ..
  104: *     .. Local Scalars ..
  105:       CHARACTER          TRANST
  106:       INTEGER            I, INFO, J
  107: *     ..
  108: *     .. External Functions ..
  109:       LOGICAL            LSAME
  110:       EXTERNAL           LSAME
  111: *     ..
  112: *     .. External Subroutines ..
  113:       EXTERNAL           XERBLA, ZCOPY, ZGEMM, ZLACGV, ZTRMM
  114: *     ..
  115: *     .. Executable Statements ..
  116: *
  117: *     Quick return if possible
  118: *
  119:       IF( M.LE.0 .OR. N.LE.0 )
  120:      $   RETURN
  121: *
  122: *     Check for currently supported options
  123: *
  124:       INFO = 0
  125:       IF( .NOT.LSAME( DIRECT, 'B' ) ) THEN
  126:          INFO = -3
  127:       ELSE IF( .NOT.LSAME( STOREV, 'R' ) ) THEN
  128:          INFO = -4
  129:       END IF
  130:       IF( INFO.NE.0 ) THEN
  131:          CALL XERBLA( 'ZLARZB', -INFO )
  132:          RETURN
  133:       END IF
  134: *
  135:       IF( LSAME( TRANS, 'N' ) ) THEN
  136:          TRANST = 'C'
  137:       ELSE
  138:          TRANST = 'N'
  139:       END IF
  140: *
  141:       IF( LSAME( SIDE, 'L' ) ) THEN
  142: *
  143: *        Form  H * C  or  H' * C
  144: *
  145: *        W( 1:n, 1:k ) = conjg( C( 1:k, 1:n )' )
  146: *
  147:          DO 10 J = 1, K
  148:             CALL ZCOPY( N, C( J, 1 ), LDC, WORK( 1, J ), 1 )
  149:    10    CONTINUE
  150: *
  151: *        W( 1:n, 1:k ) = W( 1:n, 1:k ) + ...
  152: *                        conjg( C( m-l+1:m, 1:n )' ) * V( 1:k, 1:l )'
  153: *
  154:          IF( L.GT.0 )
  155:      $      CALL ZGEMM( 'Transpose', 'Conjugate transpose', N, K, L,
  156:      $                  ONE, C( M-L+1, 1 ), LDC, V, LDV, ONE, WORK,
  157:      $                  LDWORK )
  158: *
  159: *        W( 1:n, 1:k ) = W( 1:n, 1:k ) * T'  or  W( 1:m, 1:k ) * T
  160: *
  161:          CALL ZTRMM( 'Right', 'Lower', TRANST, 'Non-unit', N, K, ONE, T,
  162:      $               LDT, WORK, LDWORK )
  163: *
  164: *        C( 1:k, 1:n ) = C( 1:k, 1:n ) - conjg( W( 1:n, 1:k )' )
  165: *
  166:          DO 30 J = 1, N
  167:             DO 20 I = 1, K
  168:                C( I, J ) = C( I, J ) - WORK( J, I )
  169:    20       CONTINUE
  170:    30    CONTINUE
  171: *
  172: *        C( m-l+1:m, 1:n ) = C( m-l+1:m, 1:n ) - ...
  173: *                    conjg( V( 1:k, 1:l )' ) * conjg( W( 1:n, 1:k )' )
  174: *
  175:          IF( L.GT.0 )
  176:      $      CALL ZGEMM( 'Transpose', 'Transpose', L, N, K, -ONE, V, LDV,
  177:      $                  WORK, LDWORK, ONE, C( M-L+1, 1 ), LDC )
  178: *
  179:       ELSE IF( LSAME( SIDE, 'R' ) ) THEN
  180: *
  181: *        Form  C * H  or  C * H'
  182: *
  183: *        W( 1:m, 1:k ) = C( 1:m, 1:k )
  184: *
  185:          DO 40 J = 1, K
  186:             CALL ZCOPY( M, C( 1, J ), 1, WORK( 1, J ), 1 )
  187:    40    CONTINUE
  188: *
  189: *        W( 1:m, 1:k ) = W( 1:m, 1:k ) + ...
  190: *                        C( 1:m, n-l+1:n ) * conjg( V( 1:k, 1:l )' )
  191: *
  192:          IF( L.GT.0 )
  193:      $      CALL ZGEMM( 'No transpose', 'Transpose', M, K, L, ONE,
  194:      $                  C( 1, N-L+1 ), LDC, V, LDV, ONE, WORK, LDWORK )
  195: *
  196: *        W( 1:m, 1:k ) = W( 1:m, 1:k ) * conjg( T )  or
  197: *                        W( 1:m, 1:k ) * conjg( T' )
  198: *
  199:          DO 50 J = 1, K
  200:             CALL ZLACGV( K-J+1, T( J, J ), 1 )
  201:    50    CONTINUE
  202:          CALL ZTRMM( 'Right', 'Lower', TRANS, 'Non-unit', M, K, ONE, T,
  203:      $               LDT, WORK, LDWORK )
  204:          DO 60 J = 1, K
  205:             CALL ZLACGV( K-J+1, T( J, J ), 1 )
  206:    60    CONTINUE
  207: *
  208: *        C( 1:m, 1:k ) = C( 1:m, 1:k ) - W( 1:m, 1:k )
  209: *
  210:          DO 80 J = 1, K
  211:             DO 70 I = 1, M
  212:                C( I, J ) = C( I, J ) - WORK( I, J )
  213:    70       CONTINUE
  214:    80    CONTINUE
  215: *
  216: *        C( 1:m, n-l+1:n ) = C( 1:m, n-l+1:n ) - ...
  217: *                            W( 1:m, 1:k ) * conjg( V( 1:k, 1:l ) )
  218: *
  219:          DO 90 J = 1, L
  220:             CALL ZLACGV( K, V( 1, J ), 1 )
  221:    90    CONTINUE
  222:          IF( L.GT.0 )
  223:      $      CALL ZGEMM( 'No transpose', 'No transpose', M, L, K, -ONE,
  224:      $                  WORK, LDWORK, V, LDV, ONE, C( 1, N-L+1 ), LDC )
  225:          DO 100 J = 1, L
  226:             CALL ZLACGV( K, V( 1, J ), 1 )
  227:   100    CONTINUE
  228: *
  229:       END IF
  230: *
  231:       RETURN
  232: *
  233: *     End of ZLARZB
  234: *
  235:       END

CVSweb interface <joel.bertrand@systella.fr>