Annotation of rpl/lapack/lapack/zlarzb.f, revision 1.1
1.1 ! bertrand 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>