1esolve(1)                      Utility Commands                      esolve(1)
2
3
4

NAME

6       esolve - eigensolver for standard eigenvalue problems
7
8

SYNOPSIS

10       esolve   matrix_filename   evalues_filename  evectors_filename  residu‐
11       als_filename iters_filename [options]
12
13

DESCRIPTION

15       This program inputs the matrix data from matrix_filename and solves the
16       standard  eigenvalue  problem  A*x  =  l*x with the solver specified by
17       options.  It outputs the specified number of eigenvalues, the number of
18       which  is  given  by option -ss, to evalues_filename and the associated
19       eigenvectors, residual  norms,  and  numbers  of  iterations  to  evec‐
20       tors_filename,  residuals_filename,  and iters_filename respectively in
21       the extended Matrix Market format (see Appendix  of  Lis  User  Guide).
22       Both  the  Matrix  Market format and the Harwell-Boeing format are sup‐
23       ported for the matrix filename.
24
25

OPTIONS

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

EXIT STATUS

379       The following exit values are returned:
380
381       0      The process is normally terminated
382
383       unspecified
384              An error occurred
385
386

SEE ALSO

388       lis(3),  lsolve(1),  hpcg_kernel(1),  hpcg_spmvtest(1),   spmvtest1(1),
389       spmvtest2(1), spmvtest2b(1), spmvtest3(1), spmvtest3b(1), spmvtest4(1),
390       spmvtest5(1)
391
392       http://www.ssisc.org/lis/
393       http://math.nist.gov/MatrixMarket/
394
395
396
397
398Man Page                          19 Sep 2017                        esolve(1)
Impressum