1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
|
---
:name: dlaqgb
:md5sum: 3e680371f6b032c8b947d3a6023a369f
:category: :subroutine
:arguments:
- m:
:type: integer
:intent: input
- n:
:type: integer
:intent: input
- kl:
:type: integer
:intent: input
- ku:
:type: integer
:intent: input
- ab:
:type: doublereal
:intent: input/output
:dims:
- ldab
- n
- ldab:
:type: integer
:intent: input
- r:
:type: doublereal
:intent: input
:dims:
- m
- c:
:type: doublereal
:intent: input
:dims:
- n
- rowcnd:
:type: doublereal
:intent: input
- colcnd:
:type: doublereal
:intent: input
- amax:
:type: doublereal
:intent: input
- equed:
:type: char
:intent: output
:substitutions: {}
:fortran_help: " SUBROUTINE DLAQGB( M, N, KL, KU, AB, LDAB, R, C, ROWCND, COLCND, AMAX, EQUED )\n\n\
* Purpose\n\
* =======\n\
*\n\
* DLAQGB equilibrates a general M by N band matrix A with KL\n\
* subdiagonals and KU superdiagonals using the row and scaling factors\n\
* in the vectors R and C.\n\
*\n\n\
* Arguments\n\
* =========\n\
*\n\
* M (input) INTEGER\n\
* The number of rows of the matrix A. M >= 0.\n\
*\n\
* N (input) INTEGER\n\
* The number of columns of the matrix A. N >= 0.\n\
*\n\
* KL (input) INTEGER\n\
* The number of subdiagonals within the band of A. KL >= 0.\n\
*\n\
* KU (input) INTEGER\n\
* The number of superdiagonals within the band of A. KU >= 0.\n\
*\n\
* AB (input/output) DOUBLE PRECISION array, dimension (LDAB,N)\n\
* On entry, the matrix A in band storage, in rows 1 to KL+KU+1.\n\
* The j-th column of A is stored in the j-th column of the\n\
* array AB as follows:\n\
* AB(ku+1+i-j,j) = A(i,j) for max(1,j-ku)<=i<=min(m,j+kl)\n\
*\n\
* On exit, the equilibrated matrix, in the same storage format\n\
* as A. See EQUED for the form of the equilibrated matrix.\n\
*\n\
* LDAB (input) INTEGER\n\
* The leading dimension of the array AB. LDA >= KL+KU+1.\n\
*\n\
* R (input) DOUBLE PRECISION array, dimension (M)\n\
* The row scale factors for A.\n\
*\n\
* C (input) DOUBLE PRECISION array, dimension (N)\n\
* The column scale factors for A.\n\
*\n\
* ROWCND (input) DOUBLE PRECISION\n\
* Ratio of the smallest R(i) to the largest R(i).\n\
*\n\
* COLCND (input) DOUBLE PRECISION\n\
* Ratio of the smallest C(i) to the largest C(i).\n\
*\n\
* AMAX (input) DOUBLE PRECISION\n\
* Absolute value of largest matrix entry.\n\
*\n\
* EQUED (output) CHARACTER*1\n\
* Specifies the form of equilibration that was done.\n\
* = 'N': No equilibration\n\
* = 'R': Row equilibration, i.e., A has been premultiplied by\n\
* diag(R).\n\
* = 'C': Column equilibration, i.e., A has been postmultiplied\n\
* by diag(C).\n\
* = 'B': Both row and column equilibration, i.e., A has been\n\
* replaced by diag(R) * A * diag(C).\n\
*\n\
* Internal Parameters\n\
* ===================\n\
*\n\
* THRESH is a threshold value used to decide if row or column scaling\n\
* should be done based on the ratio of the row or column scaling\n\
* factors. If ROWCND < THRESH, row scaling is done, and if\n\
* COLCND < THRESH, column scaling is done.\n\
*\n\
* LARGE and SMALL are threshold values used to decide if row scaling\n\
* should be done based on the absolute size of the largest matrix\n\
* element. If AMAX > LARGE or AMAX < SMALL, row scaling is done.\n\
*\n\n\
* =====================================================================\n\
*\n"
|
