1lis_esolver_set_option(3f) Lis Library Functions lis_esolver_set_option(3f)
2
6 lis_esolver_set_option - set the options for the eigensolver
7
10 subroutine lis_esolver_set_option(char *text, LIS_ESOLVER *esolver,
11 LIS_INTEGER ierr);
12
15 Set the options for the eigensolver.
16
19 text The command line options
20
23 esolver
24 The eigensolver
25
28 The table below shows the available command line options, where -e
29 {pi|1} means -e pi or -e 1 and -emaxiter [1000] indicates that -emax‐
30 iter defaults to 1,000.
31
34 The following options are supported:
35 -e eigensolver
37 The following options are supported for eigensolver:
38 -e {pi|1}
40 Power
41 -e {ii|2}
43 Inverse
44 -i [bicg]
46 The linear solver
47 -e {rqi|3}
49 Rayleigh Quotient
50 -i [bicg]
52 The linear solver
53 -e {cg|4}
55 CG
56 -i [cg]
58 The linear solver
59 -e {cr|5}
61 CR
62 -i [bicg]
64 The linear solver
65 -e {si|6}
67 Subspace
68 -ss [1]
70 The size of the subspace
71 -e {li|7}
73 Lanczos
74 -ss [1]
76 The size of the subspace
77 -e {ai|8}
79 Arnoldi
80 -ss [1]
82 The size of the subspace
83 -e {gpi|9}
85 Generalized Power
86 -i [bicg]
88 The linear solver
89 -e {gii|10}
91 Generalized Inverse
92 -i [bicg]
94 The linear solver
95 -e {grqi|11}
97 Generalized Rayleigh Quotient
98 -i [bicg]
100 The linear solver
101 -e {gcg|12}
103 Generalized CG
104 -i [cg]
106 The linear solver
107 -e {gcr|13}
109 Generalized CR
110 -i [bicg]
112 The linear solver
113 -e {gsi|14}
115 Generalized Subspace
116 -ss [1]
118 The size of the subspace
119 -e {gli|15}
121 Generalized Lanczos
122 -ss [1]
124 The size of the subspace
125 -e {gai|16}
127 Generalized Arnoldi
128 -ss [1]
130 The size of the subspace
131 -i linear solver
133 The following options are supported for inner linear solver:
134 -i {cg|1}
136 CG
137 -i {bicg|2}
139 BiCG
140 -i {cgs|3}
142 CGS
143 -i {bicgstab|4}
145 BiCGSTAB
146 -i {bicgstabl|5}
148 BiCGSTAB(l)
149 -ell [2]
151 The degree l
152 -i {gpbicg|6}
154 GPBiCG
155 -i {tfqmr|7}
157 TFQMR
158 -i {orthomin|8}
160 Orthomin(m)
161 -restart [40]
163 The restart value m
164 -i {gmres|9}
166 GMRES(m)
167 -restart [40]
169 The restart value m
170 -i {jacobi|10}
172 Jacobi
173 -i {gs|11}
175 Gauss-Seidel
176 -i {sor|12}
178 SOR
179 -omega [1.9]
181 The relaxation coefficient omega (0<omega<2)
182 -i {bicgsafe|13}
184 BiCGSafe
185 -i {cr|14}
187 CR
188 -i {bicr|15}
190 BiCR
191 -i {crs|16}
193 CRS
194 -i {bicrstab|17}
196 BiCRSTAB
197 -i {gpbicr|18}
199 GPBiCR
200 -i {bicrsafe|19}
202 BiCRSafe
203 -i {fgmres|20}
205 FGMRES(m)
206 -restart [40]
208 The restart value m
209 -i {idrs|21}
211 IDR(s)
212 -irestart [2]
214 The restart value s
215 -i {idr1|22}
217 IDR(1)
218 -i {minres|23}
220 MINRES
221 -i {cocg|24}
223 COCG
224 -i {cocr|25}
226 COCR
227 -p preconditioner
230 The following options are supported for preconditioner:
231 -p {none|0}
233 None
234 -p {jacobi|1}
236 Jacobi
237 -p {ilu|2}
239 ILU(k)
240 -ilu_fill [0]
242 The fill level k
243 -p {ssor|3}
245 SSOR
246 -ssor_omega [1.0]
248 The relaxation coefficient omega (0<omega<2)
249 -p {hybrid|4}
251 Hybrid
252 -hybrid_i [sor]
254 The linear solver
255 -hybrid_maxiter [25]
257 The maximum number of iterations
258 -hybrid_tol [1.0e-3]
260 The convergence criterion
261 -hybrid_omega [1.5]
263 The relaxation coefficient omega of the SOR
264 (0<omega<2)
265 -hybrid_ell [2]
267 The degree l of the BiCGSTAB(l)
268 -hybrid_restart [40]
270 The restart values of the GMRES and Orthomin
271 -p {is|5}
273 I+S
274 -is_alpha [1.0]
276 The parameter alpha of I+alpha*S(m)
277 -is_m [3]
279 The parameter m of I+alpha*S(m)
280 -p {sainv|6}
282 SAINV
283 -sainv_drop [0.05]
285 The drop criterion
286 -p {saamg|7}
288 SA-AMG
289 -saamg_unsym [false]
291 Select the unsymmetric version (The matrix struc‐
292 ture must be symmetric)
293 -saamg_theta [0.05|0.12]
295 The drop criterion
296 -p {iluc|8}
298 Crout ILU
299 -iluc_drop [0.05]
301 The drop criterion
302 -iluc_rate [5.0]
304 The ration of maximum fill-in
305 -p {ilut|9}
307 ILUT
308 -ilut_drop [0.05]
310 The drop criterion
311 -ilut_rate [5.0]
313 The ration of maximum fill-in
314 -adds true
316 Additive Schwarz
317 -adds_iter [1]
319 The number of iteration
320 Other Options for eigensolver:
322 -emaxiter [1000]
324 The maximum number of iterations
325 -etol [1.0e-12]
327 The convergence criterion
328 -eprint [0]
330 The display of the residual
331 -eprint {none|0}
333 None
334 -eprint {mem|1}
336 Save the residual history
337 -eprint {out|2}
339 Display the residual history
340 -eprint {all|3}
342 Save the residual history and display it on the screen
343 -ie [ii]
345 The inner eigensolver used in Subspace, Lanczos, and Arnoldi
346 -ige [ii]
348 The inner eigensolver used in Generalized Subspace, Generalized
349 Lanczos, and Generalized Arnoldi
350 -shift [0.0]
352 The amount of the shift
353 -initx_ones [true]
355 The behavior of the initial vector x_0
356 -initx_ones {false|0}
358 Given values
359 -initx_ones {true|1}
361 All values are set to 1
362 -omp_num_threads [t]
364 The number of threads (t represents the maximum number of
365 threads)
366 -estorage [0]
368 The matrix storage format
369 -estorage_block [2]
371 The block size of the BSR and BSC formats
372 -ef [0]
374 The precision of the eigensolver
375 -ef {double|0}
377 Double precision
378 -ef {quad|1}
380 Double-double (quadruple) precision
381 Other options for inner linear solver:
383 -maxiter [1000]
385 The maximum number of iterations
386 -tol [1.0e-12]
388 The convergence criterion
389 -print [0]
391 The display of the residual
392 -print {none|0}
394 None
395 -print {mem|1}
397 Save the residual history
398 -print {out|2}
400 Display the residual history
401 -print {all|3}
403 Save the residual history and display it on the screen
404 -scale [0]
406 The scaling
407 -scale {none|0}
409 No scaling
410 -scale {jacobi|1}
412 The Jacobi scaling
413 -scale {symm_diag|2}
415 The diagonal scaling
416 -initx_zeros [true]
418 The behavior of the initial vector x_0
419 -initx_zero {false|0}
421 Given values
422 -initx_zero {true|1}
424 All values are set to 0
425 -omp_num_threads [t]
427 The number of threads (t represents the maximum number of
428 threads)
429 -storage [0]
431 The matrix storage format
432 -storage_block [2]
434 The block size of the BSR and BSC formats
435 -f [0] The precision of the linear solver
437 -f {double|0}
439 Double precision
440 -f {quad|1}
442 Double-double (quadruple) precision
443 See Lis User Guide for full description.
445
448 lis(3)
449 http://www.ssisc.org/lis/
451Man Page 14 Sep 2017 lis_esolver_set_option(3f)