1*> \brief \b CQLT03 2* 3* =========== DOCUMENTATION =========== 4* 5* Online html documentation available at 6* http://www.netlib.org/lapack/explore-html/ 7* 8* Definition: 9* =========== 10* 11* SUBROUTINE CQLT03( M, N, K, AF, C, CC, Q, LDA, TAU, WORK, LWORK, 12* RWORK, RESULT ) 13* 14* .. Scalar Arguments .. 15* INTEGER K, LDA, LWORK, M, N 16* .. 17* .. Array Arguments .. 18* REAL RESULT( * ), RWORK( * ) 19* COMPLEX AF( LDA, * ), C( LDA, * ), CC( LDA, * ), 20* $ Q( LDA, * ), TAU( * ), WORK( LWORK ) 21* .. 22* 23* 24*> \par Purpose: 25* ============= 26*> 27*> \verbatim 28*> 29*> CQLT03 tests CUNMQL, which computes Q*C, Q'*C, C*Q or C*Q'. 30*> 31*> CQLT03 compares the results of a call to CUNMQL with the results of 32*> forming Q explicitly by a call to CUNGQL and then performing matrix 33*> multiplication by a call to CGEMM. 34*> \endverbatim 35* 36* Arguments: 37* ========== 38* 39*> \param[in] M 40*> \verbatim 41*> M is INTEGER 42*> The order of the orthogonal matrix Q. M >= 0. 43*> \endverbatim 44*> 45*> \param[in] N 46*> \verbatim 47*> N is INTEGER 48*> The number of rows or columns of the matrix C; C is m-by-n if 49*> Q is applied from the left, or n-by-m if Q is applied from 50*> the right. N >= 0. 51*> \endverbatim 52*> 53*> \param[in] K 54*> \verbatim 55*> K is INTEGER 56*> The number of elementary reflectors whose product defines the 57*> orthogonal matrix Q. M >= K >= 0. 58*> \endverbatim 59*> 60*> \param[in] AF 61*> \verbatim 62*> AF is COMPLEX array, dimension (LDA,N) 63*> Details of the QL factorization of an m-by-n matrix, as 64*> returned by CGEQLF. See CGEQLF for further details. 65*> \endverbatim 66*> 67*> \param[out] C 68*> \verbatim 69*> C is COMPLEX array, dimension (LDA,N) 70*> \endverbatim 71*> 72*> \param[out] CC 73*> \verbatim 74*> CC is COMPLEX array, dimension (LDA,N) 75*> \endverbatim 76*> 77*> \param[out] Q 78*> \verbatim 79*> Q is COMPLEX array, dimension (LDA,M) 80*> \endverbatim 81*> 82*> \param[in] LDA 83*> \verbatim 84*> LDA is INTEGER 85*> The leading dimension of the arrays AF, C, CC, and Q. 86*> \endverbatim 87*> 88*> \param[in] TAU 89*> \verbatim 90*> TAU is COMPLEX array, dimension (min(M,N)) 91*> The scalar factors of the elementary reflectors corresponding 92*> to the QL factorization in AF. 93*> \endverbatim 94*> 95*> \param[out] WORK 96*> \verbatim 97*> WORK is COMPLEX array, dimension (LWORK) 98*> \endverbatim 99*> 100*> \param[in] LWORK 101*> \verbatim 102*> LWORK is INTEGER 103*> The length of WORK. LWORK must be at least M, and should be 104*> M*NB, where NB is the blocksize for this environment. 105*> \endverbatim 106*> 107*> \param[out] RWORK 108*> \verbatim 109*> RWORK is REAL array, dimension (M) 110*> \endverbatim 111*> 112*> \param[out] RESULT 113*> \verbatim 114*> RESULT is REAL array, dimension (4) 115*> The test ratios compare two techniques for multiplying a 116*> random matrix C by an m-by-m orthogonal matrix Q. 117*> RESULT(1) = norm( Q*C - Q*C ) / ( M * norm(C) * EPS ) 118*> RESULT(2) = norm( C*Q - C*Q ) / ( M * norm(C) * EPS ) 119*> RESULT(3) = norm( Q'*C - Q'*C )/ ( M * norm(C) * EPS ) 120*> RESULT(4) = norm( C*Q' - C*Q' )/ ( M * norm(C) * EPS ) 121*> \endverbatim 122* 123* Authors: 124* ======== 125* 126*> \author Univ. of Tennessee 127*> \author Univ. of California Berkeley 128*> \author Univ. of Colorado Denver 129*> \author NAG Ltd. 130* 131*> \ingroup complex_lin 132* 133* ===================================================================== 134 SUBROUTINE CQLT03( M, N, K, AF, C, CC, Q, LDA, TAU, WORK, LWORK, 135 $ RWORK, RESULT ) 136* 137* -- LAPACK test routine -- 138* -- LAPACK is a software package provided by Univ. of Tennessee, -- 139* -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..-- 140* 141* .. Scalar Arguments .. 142 INTEGER K, LDA, LWORK, M, N 143* .. 144* .. Array Arguments .. 145 REAL RESULT( * ), RWORK( * ) 146 COMPLEX AF( LDA, * ), C( LDA, * ), CC( LDA, * ), 147 $ Q( LDA, * ), TAU( * ), WORK( LWORK ) 148* .. 149* 150* ===================================================================== 151* 152* .. Parameters .. 153 REAL ZERO, ONE 154 PARAMETER ( ZERO = 0.0E+0, ONE = 1.0E+0 ) 155 COMPLEX ROGUE 156 PARAMETER ( ROGUE = ( -1.0E+10, -1.0E+10 ) ) 157* .. 158* .. Local Scalars .. 159 CHARACTER SIDE, TRANS 160 INTEGER INFO, ISIDE, ITRANS, J, MC, MINMN, NC 161 REAL CNORM, EPS, RESID 162* .. 163* .. External Functions .. 164 LOGICAL LSAME 165 REAL CLANGE, SLAMCH 166 EXTERNAL LSAME, CLANGE, SLAMCH 167* .. 168* .. External Subroutines .. 169 EXTERNAL CGEMM, CLACPY, CLARNV, CLASET, CUNGQL, CUNMQL 170* .. 171* .. Local Arrays .. 172 INTEGER ISEED( 4 ) 173* .. 174* .. Intrinsic Functions .. 175 INTRINSIC CMPLX, MAX, MIN, REAL 176* .. 177* .. Scalars in Common .. 178 CHARACTER*32 SRNAMT 179* .. 180* .. Common blocks .. 181 COMMON / SRNAMC / SRNAMT 182* .. 183* .. Data statements .. 184 DATA ISEED / 1988, 1989, 1990, 1991 / 185* .. 186* .. Executable Statements .. 187* 188 EPS = SLAMCH( 'Epsilon' ) 189 MINMN = MIN( M, N ) 190* 191* Quick return if possible 192* 193 IF( MINMN.EQ.0 ) THEN 194 RESULT( 1 ) = ZERO 195 RESULT( 2 ) = ZERO 196 RESULT( 3 ) = ZERO 197 RESULT( 4 ) = ZERO 198 RETURN 199 ENDIF 200* 201* Copy the last k columns of the factorization to the array Q 202* 203 CALL CLASET( 'Full', M, M, ROGUE, ROGUE, Q, LDA ) 204 IF( K.GT.0 .AND. M.GT.K ) 205 $ CALL CLACPY( 'Full', M-K, K, AF( 1, N-K+1 ), LDA, 206 $ Q( 1, M-K+1 ), LDA ) 207 IF( K.GT.1 ) 208 $ CALL CLACPY( 'Upper', K-1, K-1, AF( M-K+1, N-K+2 ), LDA, 209 $ Q( M-K+1, M-K+2 ), LDA ) 210* 211* Generate the m-by-m matrix Q 212* 213 SRNAMT = 'CUNGQL' 214 CALL CUNGQL( M, M, K, Q, LDA, TAU( MINMN-K+1 ), WORK, LWORK, 215 $ INFO ) 216* 217 DO 30 ISIDE = 1, 2 218 IF( ISIDE.EQ.1 ) THEN 219 SIDE = 'L' 220 MC = M 221 NC = N 222 ELSE 223 SIDE = 'R' 224 MC = N 225 NC = M 226 END IF 227* 228* Generate MC by NC matrix C 229* 230 DO 10 J = 1, NC 231 CALL CLARNV( 2, ISEED, MC, C( 1, J ) ) 232 10 CONTINUE 233 CNORM = CLANGE( '1', MC, NC, C, LDA, RWORK ) 234 IF( CNORM.EQ.ZERO ) 235 $ CNORM = ONE 236* 237 DO 20 ITRANS = 1, 2 238 IF( ITRANS.EQ.1 ) THEN 239 TRANS = 'N' 240 ELSE 241 TRANS = 'C' 242 END IF 243* 244* Copy C 245* 246 CALL CLACPY( 'Full', MC, NC, C, LDA, CC, LDA ) 247* 248* Apply Q or Q' to C 249* 250 SRNAMT = 'CUNMQL' 251 IF( K.GT.0 ) 252 $ CALL CUNMQL( SIDE, TRANS, MC, NC, K, AF( 1, N-K+1 ), 253 $ LDA, TAU( MINMN-K+1 ), CC, LDA, WORK, 254 $ LWORK, INFO ) 255* 256* Form explicit product and subtract 257* 258 IF( LSAME( SIDE, 'L' ) ) THEN 259 CALL CGEMM( TRANS, 'No transpose', MC, NC, MC, 260 $ CMPLX( -ONE ), Q, LDA, C, LDA, CMPLX( ONE ), 261 $ CC, LDA ) 262 ELSE 263 CALL CGEMM( 'No transpose', TRANS, MC, NC, NC, 264 $ CMPLX( -ONE ), C, LDA, Q, LDA, CMPLX( ONE ), 265 $ CC, LDA ) 266 END IF 267* 268* Compute error in the difference 269* 270 RESID = CLANGE( '1', MC, NC, CC, LDA, RWORK ) 271 RESULT( ( ISIDE-1 )*2+ITRANS ) = RESID / 272 $ ( REAL( MAX( 1, M ) )*CNORM*EPS ) 273* 274 20 CONTINUE 275 30 CONTINUE 276* 277 RETURN 278* 279* End of CQLT03 280* 281 END 282