1DLASCL(1) LAPACK auxiliary routine (version 3.1) DLASCL(1)
2
3
4
6 DLASCL - the M by N real matrix A by the real scalar CTO/CFROM
7
9 SUBROUTINE DLASCL( TYPE, KL, KU, CFROM, CTO, M, N, A, LDA, INFO )
10
11 CHARACTER TYPE
12
13 INTEGER INFO, KL, KU, LDA, M, N
14
15 DOUBLE PRECISION CFROM, CTO
16
17 DOUBLE PRECISION A( LDA, * )
18
20 DLASCL multiplies the M by N real matrix A by the real scalar
21 CTO/CFROM. This is done without over/underflow as long as the final
22 result CTO*A(I,J)/CFROM does not over/underflow. TYPE specifies that A
23 may be full, upper triangular, lower triangular, upper Hessenberg, or
24 banded.
25
26
28 TYPE (input) CHARACTER*1
29 TYPE indices the storage type of the input matrix. = 'G': A
30 is a full matrix.
31 = 'L': A is a lower triangular matrix.
32 = 'U': A is an upper triangular matrix.
33 = 'H': A is an upper Hessenberg matrix.
34 = 'B': A is a symmetric band matrix with lower bandwidth KL
35 and upper bandwidth KU and with the only the lower half stored.
36 = 'Q': A is a symmetric band matrix with lower bandwidth KL
37 and upper bandwidth KU and with the only the upper half stored.
38 = 'Z': A is a band matrix with lower bandwidth KL and upper
39 bandwidth KU.
40
41 KL (input) INTEGER
42 The lower bandwidth of A. Referenced only if TYPE = 'B', 'Q'
43 or 'Z'.
44
45 KU (input) INTEGER
46 The upper bandwidth of A. Referenced only if TYPE = 'B', 'Q'
47 or 'Z'.
48
49 CFROM (input) DOUBLE PRECISION
50 CTO (input) DOUBLE PRECISION The matrix A is multiplied by
51 CTO/CFROM. A(I,J) is computed without over/underflow if the
52 final result CTO*A(I,J)/CFROM can be represented without
53 over/underflow. CFROM must be nonzero.
54
55 M (input) INTEGER
56 The number of rows of the matrix A. M >= 0.
57
58 N (input) INTEGER
59 The number of columns of the matrix A. N >= 0.
60
61 A (input/output) DOUBLE PRECISION array, dimension (LDA,N)
62 The matrix to be multiplied by CTO/CFROM. See TYPE for the
63 storage type.
64
65 LDA (input) INTEGER
66 The leading dimension of the array A. LDA >= max(1,M).
67
68 INFO (output) INTEGER
69 0 - successful exit <0 - if INFO = -i, the i-th argument had
70 an illegal value.
71
72
73
74 LAPACK auxiliary routine (versionNo3v.e1m)ber 2006 DLASCL(1)