LAPACK 3.12.0
LAPACK: Linear Algebra PACKage
Loading...
Searching...
No Matches
zqrt15.f
Go to the documentation of this file.
1*> \brief \b ZQRT15
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 ZQRT15( SCALE, RKSEL, M, N, NRHS, A, LDA, B, LDB, S,
12* RANK, NORMA, NORMB, ISEED, WORK, LWORK )
13*
14* .. Scalar Arguments ..
15* INTEGER LDA, LDB, LWORK, M, N, NRHS, RANK, RKSEL, SCALE
16* DOUBLE PRECISION NORMA, NORMB
17* ..
18* .. Array Arguments ..
19* INTEGER ISEED( 4 )
20* DOUBLE PRECISION S( * )
21* COMPLEX*16 A( LDA, * ), B( LDB, * ), WORK( LWORK )
22* ..
23*
24*
25*> \par Purpose:
26* =============
27*>
28*> \verbatim
29*>
30*> ZQRT15 generates a matrix with full or deficient rank and of various
31*> norms.
32*> \endverbatim
33*
34* Arguments:
35* ==========
36*
37*> \param[in] SCALE
38*> \verbatim
39*> SCALE is INTEGER
40*> SCALE = 1: normally scaled matrix
41*> SCALE = 2: matrix scaled up
42*> SCALE = 3: matrix scaled down
43*> \endverbatim
44*>
45*> \param[in] RKSEL
46*> \verbatim
47*> RKSEL is INTEGER
48*> RKSEL = 1: full rank matrix
49*> RKSEL = 2: rank-deficient matrix
50*> \endverbatim
51*>
52*> \param[in] M
53*> \verbatim
54*> M is INTEGER
55*> The number of rows of the matrix A.
56*> \endverbatim
57*>
58*> \param[in] N
59*> \verbatim
60*> N is INTEGER
61*> The number of columns of A.
62*> \endverbatim
63*>
64*> \param[in] NRHS
65*> \verbatim
66*> NRHS is INTEGER
67*> The number of columns of B.
68*> \endverbatim
69*>
70*> \param[out] A
71*> \verbatim
72*> A is COMPLEX*16 array, dimension (LDA,N)
73*> The M-by-N matrix A.
74*> \endverbatim
75*>
76*> \param[in] LDA
77*> \verbatim
78*> LDA is INTEGER
79*> The leading dimension of the array A.
80*> \endverbatim
81*>
82*> \param[out] B
83*> \verbatim
84*> B is COMPLEX*16 array, dimension (LDB, NRHS)
85*> A matrix that is in the range space of matrix A.
86*> \endverbatim
87*>
88*> \param[in] LDB
89*> \verbatim
90*> LDB is INTEGER
91*> The leading dimension of the array B.
92*> \endverbatim
93*>
94*> \param[out] S
95*> \verbatim
96*> S is DOUBLE PRECISION array, dimension MIN(M,N)
97*> Singular values of A.
98*> \endverbatim
99*>
100*> \param[out] RANK
101*> \verbatim
102*> RANK is INTEGER
103*> number of nonzero singular values of A.
104*> \endverbatim
105*>
106*> \param[out] NORMA
107*> \verbatim
108*> NORMA is DOUBLE PRECISION
109*> one-norm norm of A.
110*> \endverbatim
111*>
112*> \param[out] NORMB
113*> \verbatim
114*> NORMB is DOUBLE PRECISION
115*> one-norm norm of B.
116*> \endverbatim
117*>
118*> \param[in,out] ISEED
119*> \verbatim
120*> ISEED is integer array, dimension (4)
121*> seed for random number generator.
122*> \endverbatim
123*>
124*> \param[out] WORK
125*> \verbatim
126*> WORK is COMPLEX*16 array, dimension (LWORK)
127*> \endverbatim
128*>
129*> \param[in] LWORK
130*> \verbatim
131*> LWORK is INTEGER
132*> length of work space required.
133*> LWORK >= MAX(M+MIN(M,N),NRHS*MIN(M,N),2*N+M)
134*> \endverbatim
135*
136* Authors:
137* ========
138*
139*> \author Univ. of Tennessee
140*> \author Univ. of California Berkeley
141*> \author Univ. of Colorado Denver
142*> \author NAG Ltd.
143*
144*> \ingroup complex16_lin
145*
146* =====================================================================
147 SUBROUTINE zqrt15( SCALE, RKSEL, M, N, NRHS, A, LDA, B, LDB, S,
148 $ RANK, NORMA, NORMB, ISEED, WORK, LWORK )
149*
150* -- LAPACK test routine --
151* -- LAPACK is a software package provided by Univ. of Tennessee, --
152* -- Univ. of California Berkeley, Univ. of Colorado Denver and NAG Ltd..--
153*
154* .. Scalar Arguments ..
155 INTEGER LDA, LDB, LWORK, M, N, NRHS, RANK, RKSEL, SCALE
156 DOUBLE PRECISION NORMA, NORMB
157* ..
158* .. Array Arguments ..
159 INTEGER ISEED( 4 )
160 DOUBLE PRECISION S( * )
161 COMPLEX*16 A( LDA, * ), B( LDB, * ), WORK( LWORK )
162* ..
163*
164* =====================================================================
165*
166* .. Parameters ..
167 DOUBLE PRECISION ZERO, ONE, TWO, SVMIN
168 parameter( zero = 0.0d+0, one = 1.0d+0, two = 2.0d+0,
169 $ svmin = 0.1d+0 )
170 COMPLEX*16 CZERO, CONE
171 parameter( czero = ( 0.0d+0, 0.0d+0 ),
172 $ cone = ( 1.0d+0, 0.0d+0 ) )
173* ..
174* .. Local Scalars ..
175 INTEGER INFO, J, MN
176 DOUBLE PRECISION BIGNUM, EPS, SMLNUM, TEMP
177* ..
178* .. Local Arrays ..
179 DOUBLE PRECISION DUMMY( 1 )
180* ..
181* .. External Functions ..
182 DOUBLE PRECISION DASUM, DLAMCH, DLARND, DZNRM2, ZLANGE
183 EXTERNAL dasum, dlamch, dlarnd, dznrm2, zlange
184* ..
185* .. External Subroutines ..
186 EXTERNAL dlaord, dlascl, xerbla, zdscal, zgemm, zlarf,
188* ..
189* .. Intrinsic Functions ..
190 INTRINSIC abs, dcmplx, max, min
191* ..
192* .. Executable Statements ..
193*
194 mn = min( m, n )
195 IF( lwork.LT.max( m+mn, mn*nrhs, 2*n+m ) ) THEN
196 CALL xerbla( 'ZQRT15', 16 )
197 RETURN
198 END IF
199*
200 smlnum = dlamch( 'Safe minimum' )
201 bignum = one / smlnum
202 eps = dlamch( 'Epsilon' )
203 smlnum = ( smlnum / eps ) / eps
204 bignum = one / smlnum
205*
206* Determine rank and (unscaled) singular values
207*
208 IF( rksel.EQ.1 ) THEN
209 rank = mn
210 ELSE IF( rksel.EQ.2 ) THEN
211 rank = ( 3*mn ) / 4
212 DO 10 j = rank + 1, mn
213 s( j ) = zero
214 10 CONTINUE
215 ELSE
216 CALL xerbla( 'ZQRT15', 2 )
217 END IF
218*
219 IF( rank.GT.0 ) THEN
220*
221* Nontrivial case
222*
223 s( 1 ) = one
224 DO 30 j = 2, rank
225 20 CONTINUE
226 temp = dlarnd( 1, iseed )
227 IF( temp.GT.svmin ) THEN
228 s( j ) = abs( temp )
229 ELSE
230 GO TO 20
231 END IF
232 30 CONTINUE
233 CALL dlaord( 'Decreasing', rank, s, 1 )
234*
235* Generate 'rank' columns of a random orthogonal matrix in A
236*
237 CALL zlarnv( 2, iseed, m, work )
238 CALL zdscal( m, one / dznrm2( m, work, 1 ), work, 1 )
239 CALL zlaset( 'Full', m, rank, czero, cone, a, lda )
240 CALL zlarf( 'Left', m, rank, work, 1, dcmplx( two ), a, lda,
241 $ work( m+1 ) )
242*
243* workspace used: m+mn
244*
245* Generate consistent rhs in the range space of A
246*
247 CALL zlarnv( 2, iseed, rank*nrhs, work )
248 CALL zgemm( 'No transpose', 'No transpose', m, nrhs, rank,
249 $ cone, a, lda, work, rank, czero, b, ldb )
250*
251* work space used: <= mn *nrhs
252*
253* generate (unscaled) matrix A
254*
255 DO 40 j = 1, rank
256 CALL zdscal( m, s( j ), a( 1, j ), 1 )
257 40 CONTINUE
258 IF( rank.LT.n )
259 $ CALL zlaset( 'Full', m, n-rank, czero, czero,
260 $ a( 1, rank+1 ), lda )
261 CALL zlaror( 'Right', 'No initialization', m, n, a, lda, iseed,
262 $ work, info )
263*
264 ELSE
265*
266* work space used 2*n+m
267*
268* Generate null matrix and rhs
269*
270 DO 50 j = 1, mn
271 s( j ) = zero
272 50 CONTINUE
273 CALL zlaset( 'Full', m, n, czero, czero, a, lda )
274 CALL zlaset( 'Full', m, nrhs, czero, czero, b, ldb )
275*
276 END IF
277*
278* Scale the matrix
279*
280 IF( scale.NE.1 ) THEN
281 norma = zlange( 'Max', m, n, a, lda, dummy )
282 IF( norma.NE.zero ) THEN
283 IF( scale.EQ.2 ) THEN
284*
285* matrix scaled up
286*
287 CALL zlascl( 'General', 0, 0, norma, bignum, m, n, a,
288 $ lda, info )
289 CALL dlascl( 'General', 0, 0, norma, bignum, mn, 1, s,
290 $ mn, info )
291 CALL zlascl( 'General', 0, 0, norma, bignum, m, nrhs, b,
292 $ ldb, info )
293 ELSE IF( scale.EQ.3 ) THEN
294*
295* matrix scaled down
296*
297 CALL zlascl( 'General', 0, 0, norma, smlnum, m, n, a,
298 $ lda, info )
299 CALL dlascl( 'General', 0, 0, norma, smlnum, mn, 1, s,
300 $ mn, info )
301 CALL zlascl( 'General', 0, 0, norma, smlnum, m, nrhs, b,
302 $ ldb, info )
303 ELSE
304 CALL xerbla( 'ZQRT15', 1 )
305 RETURN
306 END IF
307 END IF
308 END IF
309*
310 norma = dasum( mn, s, 1 )
311 normb = zlange( 'One-norm', m, nrhs, b, ldb, dummy )
312*
313 RETURN
314*
315* End of ZQRT15
316*
317 END
subroutine xerbla(srname, info)
Definition cblat2.f:3285
subroutine dlaord(job, n, x, incx)
DLAORD
Definition dlaord.f:73
subroutine zgemm(transa, transb, m, n, k, alpha, a, lda, b, ldb, beta, c, ldc)
ZGEMM
Definition zgemm.f:188
subroutine zlarf(side, m, n, v, incv, tau, c, ldc, work)
ZLARF applies an elementary reflector to a general rectangular matrix.
Definition zlarf.f:128
subroutine zlarnv(idist, iseed, n, x)
ZLARNV returns a vector of random numbers from a uniform or normal distribution.
Definition zlarnv.f:99
subroutine zlascl(type, kl, ku, cfrom, cto, m, n, a, lda, info)
ZLASCL multiplies a general rectangular matrix by a real scalar defined as cto/cfrom.
Definition zlascl.f:143
subroutine dlascl(type, kl, ku, cfrom, cto, m, n, a, lda, info)
DLASCL multiplies a general rectangular matrix by a real scalar defined as cto/cfrom.
Definition dlascl.f:143
subroutine zlaset(uplo, m, n, alpha, beta, a, lda)
ZLASET initializes the off-diagonal elements and the diagonal elements of a matrix to given values.
Definition zlaset.f:106
subroutine zdscal(n, da, zx, incx)
ZDSCAL
Definition zdscal.f:78
subroutine zlaror(side, init, m, n, a, lda, iseed, x, info)
ZLAROR
Definition zlaror.f:158
subroutine zqrt15(scale, rksel, m, n, nrhs, a, lda, b, ldb, s, rank, norma, normb, iseed, work, lwork)
ZQRT15
Definition zqrt15.f:149