1lis_esolver_set_option(3f)   Lis Library Functions  lis_esolver_set_option(3f)
2
3
4

NAME

6       lis_esolver_set_option - set the options for the eigensolver
7
8

SYNOPSIS

10       subroutine  lis_esolver_set_option(char  *text,  LIS_ESOLVER  *esolver,
11       LIS_INTEGER ierr);
12
13

DESCRIPTION

15       Set the options for the eigensolver.
16
17

INPUT

19       text   The command line options
20
21

OUTPUT

23       esolver
24              The eigensolver
25
26

NOTE

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
32

OPTIONS

34       The following options are supported:
35
36       -e eigensolver
37              The following options are supported for eigensolver:
38
39              -e {pi|1}
40                     Power
41
42              -e {ii|2}
43                     Inverse
44
45                     -i [bicg]
46                            The linear solver
47
48              -e {rqi|3}
49                     Rayleigh Quotient
50
51                     -i [bicg]
52                            The linear solver
53
54              -e {cg|4}
55                     CG
56
57                     -i [cg]
58                            The linear solver
59
60              -e {cr|5}
61                     CR
62
63                     -i [bicg]
64                            The linear solver
65
66              -e {si|6}
67                     Subspace
68
69                     -ss [1]
70                            The size of the subspace
71
72              -e {li|7}
73                     Lanczos
74
75                     -ss [1]
76                            The size of the subspace
77
78              -e {ai|8}
79                     Arnoldi
80
81                     -ss [1]
82                            The size of the subspace
83
84              -e {gpi|9}
85                     Generalized Power
86
87                     -i [bicg]
88                            The linear solver
89
90              -e {gii|10}
91                     Generalized Inverse
92
93                     -i [bicg]
94                            The linear solver
95
96              -e {grqi|11}
97                     Generalized Rayleigh Quotient
98
99                     -i [bicg]
100                            The linear solver
101
102              -e {gcg|12}
103                     Generalized CG
104
105                     -i [cg]
106                            The linear solver
107
108              -e {gcr|13}
109                     Generalized CR
110
111                     -i [bicg]
112                            The linear solver
113
114              -e {gsi|14}
115                     Generalized Subspace
116
117                     -ss [1]
118                            The size of the subspace
119
120              -e {gli|15}
121                     Generalized Lanczos
122
123                     -ss [1]
124                            The size of the subspace
125
126              -e {gai|16}
127                     Generalized Arnoldi
128
129                     -ss [1]
130                            The size of the subspace
131
132       -i linear solver
133              The following options are supported for inner linear solver:
134
135              -i {cg|1}
136                     CG
137
138              -i {bicg|2}
139                     BiCG
140
141              -i {cgs|3}
142                     CGS
143
144              -i {bicgstab|4}
145                     BiCGSTAB
146
147              -i {bicgstabl|5}
148                     BiCGSTAB(l)
149
150                     -ell [2]
151                            The degree l
152
153              -i {gpbicg|6}
154                     GPBiCG
155
156              -i {tfqmr|7}
157                     TFQMR
158
159              -i {orthomin|8}
160                     Orthomin(m)
161
162                     -restart [40]
163                            The restart value m
164
165              -i {gmres|9}
166                     GMRES(m)
167
168                     -restart [40]
169                            The restart value m
170
171              -i {jacobi|10}
172                     Jacobi
173
174              -i {gs|11}
175                     Gauss-Seidel
176
177              -i {sor|12}
178                     SOR
179
180                     -omega [1.9]
181                            The relaxation coefficient omega (0<omega<2)
182
183              -i {bicgsafe|13}
184                     BiCGSafe
185
186              -i {cr|14}
187                     CR
188
189              -i {bicr|15}
190                     BiCR
191
192              -i {crs|16}
193                     CRS
194
195              -i {bicrstab|17}
196                     BiCRSTAB
197
198              -i {gpbicr|18}
199                     GPBiCR
200
201              -i {bicrsafe|19}
202                     BiCRSafe
203
204              -i {fgmres|20}
205                     FGMRES(m)
206
207                     -restart [40]
208                            The restart value m
209
210              -i {idrs|21}
211                     IDR(s)
212
213                     -irestart [2]
214                            The restart value s
215
216              -i {idr1|22}
217                     IDR(1)
218
219              -i {minres|23}
220                     MINRES
221
222              -i {cocg|24}
223                     COCG
224
225              -i {cocr|25}
226                     COCR
227
228
229       -p preconditioner
230              The following options are supported for preconditioner:
231
232              -p {none|0}
233                     None
234
235              -p {jacobi|1}
236                     Jacobi
237
238              -p {ilu|2}
239                     ILU(k)
240
241                     -ilu_fill [0]
242                            The fill level k
243
244              -p {ssor|3}
245                     SSOR
246
247                     -ssor_omega [1.0]
248                            The relaxation coefficient omega (0<omega<2)
249
250              -p {hybrid|4}
251                     Hybrid
252
253                     -hybrid_i [sor]
254                            The linear solver
255
256                     -hybrid_maxiter [25]
257                            The maximum number of iterations
258
259                     -hybrid_tol [1.0e-3]
260                            The convergence criterion
261
262                     -hybrid_omega [1.5]
263                            The  relaxation  coefficient  omega  of  the   SOR
264                            (0<omega<2)
265
266                     -hybrid_ell [2]
267                            The degree l of the BiCGSTAB(l)
268
269                     -hybrid_restart [40]
270                            The restart values of the GMRES and Orthomin
271
272              -p {is|5}
273                     I+S
274
275                     -is_alpha [1.0]
276                            The parameter alpha of I+alpha*S(m)
277
278                     -is_m [3]
279                            The parameter m of I+alpha*S(m)
280
281              -p {sainv|6}
282                     SAINV
283
284                     -sainv_drop [0.05]
285                            The drop criterion
286
287              -p {saamg|7}
288                     SA-AMG
289
290                     -saamg_unsym [false]
291                            Select  the unsymmetric version (The matrix struc‐
292                            ture must be symmetric)
293
294                     -saamg_theta [0.05|0.12]
295                            The drop criterion
296
297              -p {iluc|8}
298                     Crout ILU
299
300                     -iluc_drop [0.05]
301                            The drop criterion
302
303                     -iluc_rate [5.0]
304                            The ration of maximum fill-in
305
306              -p {ilut|9}
307                     ILUT
308
309                     -ilut_drop [0.05]
310                            The drop criterion
311
312                     -ilut_rate [5.0]
313                            The ration of maximum fill-in
314
315              -adds true
316                     Additive Schwarz
317
318                     -adds_iter [1]
319                            The number of iteration
320
321       Other Options for eigensolver:
322
323       -emaxiter [1000]
324              The maximum number of iterations
325
326       -etol [1.0e-12]
327              The convergence criterion
328
329       -eprint [0]
330              The display of the residual
331
332              -eprint {none|0}
333                     None
334
335              -eprint {mem|1}
336                     Save the residual history
337
338              -eprint {out|2}
339                     Display the residual history
340
341              -eprint {all|3}
342                     Save the residual history and display it on the screen
343
344       -ie [ii]
345              The inner eigensolver used in Subspace, Lanczos, and Arnoldi
346
347       -ige [ii]
348              The inner eigensolver used in Generalized Subspace,  Generalized
349              Lanczos, and Generalized Arnoldi
350
351       -shift [0.0]
352              The amount of the shift
353
354       -initx_ones [true]
355              The behavior of the initial vector x_0
356
357              -initx_ones {false|0}
358                     Given values
359
360              -initx_ones {true|1}
361                     All values are set to 1
362
363       -omp_num_threads [t]
364              The  number  of  threads  (t  represents  the  maximum number of
365              threads)
366
367       -estorage [0]
368              The matrix storage format
369
370       -estorage_block [2]
371              The block size of the BSR and BSC formats
372
373       -ef [0]
374              The precision of the eigensolver
375
376              -ef {double|0}
377                     Double precision
378
379              -ef {quad|1}
380                     Double-double (quadruple) precision
381
382       Other options for inner linear solver:
383
384       -maxiter [1000]
385              The maximum number of iterations
386
387       -tol [1.0e-12]
388              The convergence criterion
389
390       -print [0]
391              The display of the residual
392
393              -print {none|0}
394                     None
395
396              -print {mem|1}
397                     Save the residual history
398
399              -print {out|2}
400                     Display the residual history
401
402              -print {all|3}
403                     Save the residual history and display it on the screen
404
405       -scale [0]
406              The scaling
407
408              -scale {none|0}
409                     No scaling
410
411              -scale {jacobi|1}
412                     The Jacobi scaling
413
414              -scale {symm_diag|2}
415                     The diagonal scaling
416
417       -initx_zeros [true]
418              The behavior of the initial vector x_0
419
420              -initx_zero {false|0}
421                     Given values
422
423              -initx_zero {true|1}
424                     All values are set to 0
425
426       -omp_num_threads [t]
427              The number of  threads  (t  represents  the  maximum  number  of
428              threads)
429
430       -storage [0]
431              The matrix storage format
432
433       -storage_block [2]
434              The block size of the BSR and BSC formats
435
436       -f [0] The precision of the linear solver
437
438              -f {double|0}
439                     Double precision
440
441              -f {quad|1}
442                     Double-double (quadruple) precision
443
444       See Lis User Guide for full description.
445
446

SEE ALSO

448       lis(3)
449
450       http://www.ssisc.org/lis/
451
452
453
454
455Man Page                          14 Sep 2017       lis_esolver_set_option(3f)
Impressum