*> \brief \b CQLT02 * * =========== DOCUMENTATION =========== * * Online html documentation available at * http://www.netlib.org/lapack/explore-html/ * * Definition: * =========== * * SUBROUTINE CQLT02( M, N, K, A, AF, Q, L, LDA, TAU, WORK, LWORK, * RWORK, RESULT ) * * .. Scalar Arguments .. * INTEGER K, LDA, LWORK, M, N * .. * .. Array Arguments .. * REAL RESULT( * ), RWORK( * ) * COMPLEX A( LDA, * ), AF( LDA, * ), L( LDA, * ), * \$ Q( LDA, * ), TAU( * ), WORK( LWORK ) * .. * * *> \par Purpose: * ============= *> *> \verbatim *> *> CQLT02 tests CUNGQL, which generates an m-by-n matrix Q with *> orthonornmal columns that is defined as the product of k elementary *> reflectors. *> *> Given the QL factorization of an m-by-n matrix A, CQLT02 generates *> the orthogonal matrix Q defined by the factorization of the last k *> columns of A; it compares L(m-n+1:m,n-k+1:n) with *> Q(1:m,m-n+1:m)'*A(1:m,n-k+1:n), and checks that the columns of Q are *> orthonormal. *> \endverbatim * * Arguments: * ========== * *> \param[in] M *> \verbatim *> M is INTEGER *> The number of rows of the matrix Q to be generated. M >= 0. *> \endverbatim *> *> \param[in] N *> \verbatim *> N is INTEGER *> The number of columns of the matrix Q to be generated. *> M >= N >= 0. *> \endverbatim *> *> \param[in] K *> \verbatim *> K is INTEGER *> The number of elementary reflectors whose product defines the *> matrix Q. N >= K >= 0. *> \endverbatim *> *> \param[in] A *> \verbatim *> A is COMPLEX array, dimension (LDA,N) *> The m-by-n matrix A which was factorized by CQLT01. *> \endverbatim *> *> \param[in] AF *> \verbatim *> AF is COMPLEX array, dimension (LDA,N) *> Details of the QL factorization of A, as returned by CGEQLF. *> See CGEQLF for further details. *> \endverbatim *> *> \param[out] Q *> \verbatim *> Q is COMPLEX array, dimension (LDA,N) *> \endverbatim *> *> \param[out] L *> \verbatim *> L is COMPLEX array, dimension (LDA,N) *> \endverbatim *> *> \param[in] LDA *> \verbatim *> LDA is INTEGER *> The leading dimension of the arrays A, AF, Q and L. LDA >= M. *> \endverbatim *> *> \param[in] TAU *> \verbatim *> TAU is COMPLEX array, dimension (N) *> The scalar factors of the elementary reflectors corresponding *> to the QL factorization in AF. *> \endverbatim *> *> \param[out] WORK *> \verbatim *> WORK is COMPLEX array, dimension (LWORK) *> \endverbatim *> *> \param[in] LWORK *> \verbatim *> LWORK is INTEGER *> The dimension of the array WORK. *> \endverbatim *> *> \param[out] RWORK *> \verbatim *> RWORK is REAL array, dimension (M) *> \endverbatim *> *> \param[out] RESULT *> \verbatim *> RESULT is REAL array, dimension (2) *> The test ratios: *> RESULT(1) = norm( L - Q'*A ) / ( M * norm(A) * EPS ) *> RESULT(2) = norm( I - Q'*Q ) / ( M * EPS ) *> \endverbatim * * Authors: * ======== * *> \author Univ. of Tennessee *> \author Univ. of California Berkeley *> \author Univ. of Colorado Denver *> \author NAG Ltd. * *> \ingroup complex_lin * * ===================================================================== SUBROUTINE CQLT02( M, N, K, A, AF, Q, L, LDA, TAU, WORK, LWORK, \$ RWORK, RESULT ) * * -- LAPACK test routine -- * -- LAPACK is a software package provided by Univ. of Tennessee, -- * -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..-- * * .. Scalar Arguments .. INTEGER K, LDA, LWORK, M, N * .. * .. Array Arguments .. REAL RESULT( * ), RWORK( * ) COMPLEX A( LDA, * ), AF( LDA, * ), L( LDA, * ), \$ Q( LDA, * ), TAU( * ), WORK( LWORK ) * .. * * ===================================================================== * * .. Parameters .. REAL ZERO, ONE PARAMETER ( ZERO = 0.0E+0, ONE = 1.0E+0 ) COMPLEX ROGUE PARAMETER ( ROGUE = ( -1.0E+10, -1.0E+10 ) ) * .. * .. Local Scalars .. INTEGER INFO REAL ANORM, EPS, RESID * .. * .. External Functions .. REAL CLANGE, CLANSY, SLAMCH EXTERNAL CLANGE, CLANSY, SLAMCH * .. * .. External Subroutines .. EXTERNAL CGEMM, CHERK, CLACPY, CLASET, CUNGQL * .. * .. Intrinsic Functions .. INTRINSIC CMPLX, MAX, REAL * .. * .. Scalars in Common .. CHARACTER*32 SRNAMT * .. * .. Common blocks .. COMMON / SRNAMC / SRNAMT * .. * .. Executable Statements .. * * Quick return if possible * IF( M.EQ.0 .OR. N.EQ.0 .OR. K.EQ.0 ) THEN RESULT( 1 ) = ZERO RESULT( 2 ) = ZERO RETURN END IF * EPS = SLAMCH( 'Epsilon' ) * * Copy the last k columns of the factorization to the array Q * CALL CLASET( 'Full', M, N, ROGUE, ROGUE, Q, LDA ) IF( K.LT.M ) \$ CALL CLACPY( 'Full', M-K, K, AF( 1, N-K+1 ), LDA, \$ Q( 1, N-K+1 ), LDA ) IF( K.GT.1 ) \$ CALL CLACPY( 'Upper', K-1, K-1, AF( M-K+1, N-K+2 ), LDA, \$ Q( M-K+1, N-K+2 ), LDA ) * * Generate the last n columns of the matrix Q * SRNAMT = 'CUNGQL' CALL CUNGQL( M, N, K, Q, LDA, TAU( N-K+1 ), WORK, LWORK, INFO ) * * Copy L(m-n+1:m,n-k+1:n) * CALL CLASET( 'Full', N, K, CMPLX( ZERO ), CMPLX( ZERO ), \$ L( M-N+1, N-K+1 ), LDA ) CALL CLACPY( 'Lower', K, K, AF( M-K+1, N-K+1 ), LDA, \$ L( M-K+1, N-K+1 ), LDA ) * * Compute L(m-n+1:m,n-k+1:n) - Q(1:m,m-n+1:m)' * A(1:m,n-k+1:n) * CALL CGEMM( 'Conjugate transpose', 'No transpose', N, K, M, \$ CMPLX( -ONE ), Q, LDA, A( 1, N-K+1 ), LDA, \$ CMPLX( ONE ), L( M-N+1, N-K+1 ), LDA ) * * Compute norm( L - Q'*A ) / ( M * norm(A) * EPS ) . * ANORM = CLANGE( '1', M, K, A( 1, N-K+1 ), LDA, RWORK ) RESID = CLANGE( '1', N, K, L( M-N+1, N-K+1 ), LDA, RWORK ) IF( ANORM.GT.ZERO ) THEN RESULT( 1 ) = ( ( RESID / REAL( MAX( 1, M ) ) ) / ANORM ) / EPS ELSE RESULT( 1 ) = ZERO END IF * * Compute I - Q'*Q * CALL CLASET( 'Full', N, N, CMPLX( ZERO ), CMPLX( ONE ), L, LDA ) CALL CHERK( 'Upper', 'Conjugate transpose', N, M, -ONE, Q, LDA, \$ ONE, L, LDA ) * * Compute norm( I - Q'*Q ) / ( M * EPS ) . * RESID = CLANSY( '1', 'Upper', N, L, LDA, RWORK ) * RESULT( 2 ) = ( RESID / REAL( MAX( 1, M ) ) ) / EPS * RETURN * * End of CQLT02 * END