LAPACK  3.8.0
LAPACK: Linear Algebra PACKage

◆ cqrt17()

real function cqrt17 ( character  TRANS,
integer  IRESID,
integer  M,
integer  N,
integer  NRHS,
complex, dimension( lda, * )  A,
integer  LDA,
complex, dimension( ldx, * )  X,
integer  LDX,
complex, dimension( ldb, * )  B,
integer  LDB,
complex, dimension( ldb, * )  C,
complex, dimension( lwork )  WORK,
integer  LWORK 
)

CQRT17

Purpose:
 CQRT17 computes the ratio

    || R'*op(A) ||/(||A||*alpha*max(M,N,NRHS)*eps)

 where R = op(A)*X - B, op(A) is A or A', and

    alpha = ||B|| if IRESID = 1 (zero-residual problem)
    alpha = ||R|| if IRESID = 2 (otherwise).
Parameters
[in]TRANS
          TRANS is CHARACTER*1
          Specifies whether or not the transpose of A is used.
          = 'N':  No transpose, op(A) = A.
          = 'C':  Conjugate transpose, op(A) = A'.
[in]IRESID
          IRESID is INTEGER
          IRESID = 1 indicates zero-residual problem.
          IRESID = 2 indicates non-zero residual.
[in]M
          M is INTEGER
          The number of rows of the matrix A.
          If TRANS = 'N', the number of rows of the matrix B.
          If TRANS = 'C', the number of rows of the matrix X.
[in]N
          N is INTEGER
          The number of columns of the matrix  A.
          If TRANS = 'N', the number of rows of the matrix X.
          If TRANS = 'C', the number of rows of the matrix B.
[in]NRHS
          NRHS is INTEGER
          The number of columns of the matrices X and B.
[in]A
          A is COMPLEX array, dimension (LDA,N)
          The m-by-n matrix A.
[in]LDA
          LDA is INTEGER
          The leading dimension of the array A. LDA >= M.
[in]X
          X is COMPLEX array, dimension (LDX,NRHS)
          If TRANS = 'N', the n-by-nrhs matrix X.
          If TRANS = 'C', the m-by-nrhs matrix X.
[in]LDX
          LDX is INTEGER
          The leading dimension of the array X.
          If TRANS = 'N', LDX >= N.
          If TRANS = 'C', LDX >= M.
[in]B
          B is COMPLEX array, dimension (LDB,NRHS)
          If TRANS = 'N', the m-by-nrhs matrix B.
          If TRANS = 'C', the n-by-nrhs matrix B.
[in]LDB
          LDB is INTEGER
          The leading dimension of the array B.
          If TRANS = 'N', LDB >= M.
          If TRANS = 'C', LDB >= N.
[out]C
          C is COMPLEX array, dimension (LDB,NRHS)
[out]WORK
          WORK is COMPLEX array, dimension (LWORK)
[in]LWORK
          LWORK is INTEGER
          The length of the array WORK.  LWORK >= NRHS*(M+N).
Author
Univ. of Tennessee
Univ. of California Berkeley
Univ. of Colorado Denver
NAG Ltd.
Date
December 2016

Definition at line 152 of file cqrt17.f.

152 *
153 * -- LAPACK test routine (version 3.7.0) --
154 * -- LAPACK is a software package provided by Univ. of Tennessee, --
155 * -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..--
156 * December 2016
157 *
158 * .. Scalar Arguments ..
159  CHARACTER trans
160  INTEGER iresid, lda, ldb, ldx, lwork, m, n, nrhs
161 * ..
162 * .. Array Arguments ..
163  COMPLEX a( lda, * ), b( ldb, * ), c( ldb, * ),
164  $ work( lwork ), x( ldx, * )
165 * ..
166 *
167 * =====================================================================
168 *
169 * .. Parameters ..
170  REAL zero, one
171  parameter( zero = 0.0e0, one = 1.0e0 )
172 * ..
173 * .. Local Scalars ..
174  INTEGER info, iscl, ncols, nrows
175  REAL bignum, err, norma, normb, normrs, smlnum
176 * ..
177 * .. Local Arrays ..
178  REAL rwork( 1 )
179 * ..
180 * .. External Functions ..
181  LOGICAL lsame
182  REAL clange, slamch
183  EXTERNAL lsame, clange, slamch
184 * ..
185 * .. External Subroutines ..
186  EXTERNAL cgemm, clacpy, clascl, xerbla
187 * ..
188 * .. Intrinsic Functions ..
189  INTRINSIC cmplx, max, real
190 * ..
191 * .. Executable Statements ..
192 *
193  cqrt17 = zero
194 *
195  IF( lsame( trans, 'N' ) ) THEN
196  nrows = m
197  ncols = n
198  ELSE IF( lsame( trans, 'C' ) ) THEN
199  nrows = n
200  ncols = m
201  ELSE
202  CALL xerbla( 'CQRT17', 1 )
203  RETURN
204  END IF
205 *
206  IF( lwork.LT.ncols*nrhs ) THEN
207  CALL xerbla( 'CQRT17', 13 )
208  RETURN
209  END IF
210 *
211  IF( m.LE.0 .OR. n.LE.0 .OR. nrhs.LE.0 )
212  $ RETURN
213 *
214  norma = clange( 'One-norm', m, n, a, lda, rwork )
215  smlnum = slamch( 'Safe minimum' ) / slamch( 'Precision' )
216  bignum = one / smlnum
217  iscl = 0
218 *
219 * compute residual and scale it
220 *
221  CALL clacpy( 'All', nrows, nrhs, b, ldb, c, ldb )
222  CALL cgemm( trans, 'No transpose', nrows, nrhs, ncols,
223  $ cmplx( -one ), a, lda, x, ldx, cmplx( one ), c, ldb )
224  normrs = clange( 'Max', nrows, nrhs, c, ldb, rwork )
225  IF( normrs.GT.smlnum ) THEN
226  iscl = 1
227  CALL clascl( 'General', 0, 0, normrs, one, nrows, nrhs, c, ldb,
228  $ info )
229  END IF
230 *
231 * compute R'*A
232 *
233  CALL cgemm( 'Conjugate transpose', trans, nrhs, ncols, nrows,
234  $ cmplx( one ), c, ldb, a, lda, cmplx( zero ), work,
235  $ nrhs )
236 *
237 * compute and properly scale error
238 *
239  err = clange( 'One-norm', nrhs, ncols, work, nrhs, rwork )
240  IF( norma.NE.zero )
241  $ err = err / norma
242 *
243  IF( iscl.EQ.1 )
244  $ err = err*normrs
245 *
246  IF( iresid.EQ.1 ) THEN
247  normb = clange( 'One-norm', nrows, nrhs, b, ldb, rwork )
248  IF( normb.NE.zero )
249  $ err = err / normb
250  ELSE
251  IF( normrs.NE.zero )
252  $ err = err / normrs
253  END IF
254 *
255  cqrt17 = err / ( slamch( 'Epsilon' )*REAL( MAX( M, N, NRHS ) ) )
256  RETURN
257 *
258 * End of CQRT17
259 *
subroutine clascl(TYPE, KL, KU, CFROM, CTO, M, N, A, LDA, INFO)
CLASCL multiplies a general rectangular matrix by a real scalar defined as cto/cfrom.
Definition: clascl.f:145
real function clange(NORM, M, N, A, LDA, WORK)
CLANGE returns the value of the 1-norm, Frobenius norm, infinity-norm, or the largest absolute value ...
Definition: clange.f:117
subroutine xerbla(SRNAME, INFO)
XERBLA
Definition: xerbla.f:62
logical function lsame(CA, CB)
LSAME
Definition: lsame.f:55
real function slamch(CMACH)
SLAMCH
Definition: slamch.f:69
subroutine clacpy(UPLO, M, N, A, LDA, B, LDB)
CLACPY copies all or part of one two-dimensional array to another.
Definition: clacpy.f:105
subroutine cgemm(TRANSA, TRANSB, M, N, K, ALPHA, A, LDA, B, LDB, BETA, C, LDC)
CGEMM
Definition: cgemm.f:189
real function cqrt17(TRANS, IRESID, M, N, NRHS, A, LDA, X, LDX, B, LDB, C, WORK, LWORK)
CQRT17
Definition: cqrt17.f:152
Here is the call graph for this function: