1esolve(1) Utility Commands esolve(1)
2
6 esolve - eigensolver for standard eigenvalue problems
7
10 esolve matrix_filename evalues_filename evectors_filename residu‐
11 als_filename iters_filename [options]
12
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
27 The following options are supported:
28 -e eigensolver
30 The following options are supported for eigensolver:
31 -e {pi|1}
33 Power
34 -e {ii|2}
36 Inverse
37 -e {rqi|3}
39 Rayleigh Quotient
40 -e {cg|4}
42 CG
43 -e {cr|5}
45 CR
46 -e {si|6}
48 Subspace
49 -ss [1]
51 The size of the subspace
52 -e {li|7}
54 Lanczos
55 -ss [1]
57 The size of the subspace
58 -e {ai|8}
60 Arnoldi
61 -ss [1]
63 The size of the subspace
64 -i linear solver
66 The following options are supported for inner linear solver:
67 -i {cg|1}
69 CG
70 -i {bicg|2}
72 BiCG
73 -i {cgs|3}
75 CGS
76 -i {bicgstab|4}
78 BiCGSTAB
79 -i {bicgstabl|5}
81 BiCGSTAB(l)
82 -ell [2]
84 The degree l
85 -i {gpbicg|6}
87 GPBiCG
88 -i {tfqmr|7}
90 TFQMR
91 -i {orthomin|8}
93 Orthomin(m)
94 -restart [40]
96 The restart value m
97 -i {gmres|9}
99 GMRES(m)
100 -restart [40]
102 The restart value m
103 -i {jacobi|10}
105 Jacobi
106 -i {gs|11}
108 Gauss-Seidel
109 -i {sor|12}
111 SOR
112 -omega [1.9]
114 The relaxation coefficient omega (0<omega<2)
115 -i {bicgsafe|13}
117 BiCGSafe
118 -i {cr|14}
120 CR
121 -i {bicr|15}
123 BiCR
124 -i {crs|16}
126 CRS
127 -i {bicrstab|17}
129 BiCRSTAB
130 -i {gpbicr|18}
132 GPBiCR
133 -i {bicrsafe|19}
135 BiCRSafe
136 -i {fgmres|20}
138 FGMRES(m)
139 -restart [40]
141 The restart value m
142 -i {idrs|21}
144 IDR(s)
145 -irestart [2]
147 The restart value s
148 -i {idr1|22}
150 IDR(1)
151 -i {minres|23}
153 MINRES
154 -i {cocg|24}
156 COCG
157 -i {cocr|25}
159 COCR
160 -p preconditioner
163 The following options are supported for preconditioner:
164 -p {none|0}
166 None
167 -p {jacobi|1}
169 Jacobi
170 -p {ilu|2}
172 ILU(k)
173 -ilu_fill [0]
175 The fill level k
176 -p {ssor|3}
178 SSOR
179 -ssor_omega [1.0]
181 The relaxation coefficient omega (0<omega<2)
182 -p {hybrid|4}
184 Hybrid
185 -hybrid_i [sor]
187 The linear solver
188 -hybrid_maxiter [25]
190 The maximum number of the iterations
191 -hybrid_tol [1.0e-3]
193 The convergence criterion
194 -hybrid_omega [1.5]
196 The relaxation coefficient omega of the SOR
197 (0<omega<2)
198 -hybrid_ell [2]
200 The degree l of the BiCGSTAB(l)
201 -hybrid_restart [40]
203 The restart values of the GMRES and Orthomin
204 -p {is|5}
206 I+S
207 -is_alpha [1.0]
209 The parameter alpha of I+alpha*S(m)
210 -is_m [3]
212 The parameter m of I+alpha*S(m)
213 -p {sainv|6}
215 SAINV
216 -sainv_drop [0.05]
218 The drop criterion
219 -p {saamg|7}
221 SA-AMG
222 -saamg_unsym [false]
224 Select the unsymmetric version (The matrix struc‐
225 ture must be symmetric)
226 -saamg_theta [0.05|0.12]
228 The drop criterion
229 -p {iluc|8}
231 Crout ILU
232 -iluc_drop [0.05]
234 The drop criterion
235 -iluc_rate [5.0]
237 The ration of maximum fill-in
238 -p {ilut|9}
240 ILUT
241 -ilut_drop [0.05]
243 The drop criterion
244 -ilut_rate [5.0]
246 The ration of maximum fill-in
247 -adds true
249 Additive Schwarz
250 -adds_iter [1]
252 The number of the iteration
253 Other Options for eigensolver:
255 -emaxiter [1000]
257 The maximum number of the iterations
258 -etol [1.0e-12]
260 The convergence criterion
261 -eprint [0]
263 The output of the residual history
264 -eprint {none|0}
266 None
267 -eprint {mem|1}
269 Save the residual history
270 -eprint {out|2}
272 Output it to the standard output
273 -eprint {all|3}
275 Save the residual history and output it to the standard
276 output
277 -ie [ii]
279 The inner eigensolver used in Subspace, Lanczos and Arnoldi
280 -shift [0.0]
282 The amount of the shift
283 -initx_ones [true]
285 The behavior of the initial vector x_0
286 -initx_ones {false|0}
288 Given values
289 -initx_ones {true|1}
291 All values are set to 1
292 -omp_num_threads [t]
294 The number of the threads (t represents the maximum number of
295 the threads)
296 -estorage [0]
298 The matrix storage format
299 -estorage_block [2]
301 The block size of the BSR and BSC formats
302 -ef [0]
304 The precision of the eigensolver
305 -ef {double|0}
307 Double precision
308 -ef {quad|1}
310 Double-double (quadruple) precision
311 Other options for inner linear solver:
313 -maxiter [1000]
315 The maximum number of the iterations
316 -tol [1.0e-12]
318 The convergence criterion
319 -print [0]
321 The output of the residual history
322 -print {none|0}
324 None
325 -print {mem|1}
327 Save the residual history
328 -print {out|2}
330 Output it to the standard output
331 -print {all|3}
333 Save the residual history and output it to the standard
334 output
335 -scale [0]
337 The scaling
338 -scale {none|0}
340 No scaling
341 -scale {jacobi|1}
343 The Jacobi scaling
344 -scale {symm_diag|2}
346 The diagonal scaling
347 -initx_zeros [true]
349 The behavior of the initial vector x_0
350 -initx_zero {false|0}
352 Given values
353 -initx_zero {true|1}
355 All values are set to 0
356 -omp_num_threads [t]
358 The number of the threads (t represents the maximum number of
359 the threads)
360 -storage [0]
362 The matrix storage format
363 -storage_block [2]
365 The block size of the BSR and BSC formats
366 -f [0] The precision of the linear solver
368 -f {double|0}
370 Double precision
371 -f {quad|1}
373 Double-double (quadruple) precision
374 See Lis User Guide for full description.
376
379 The following exit values are returned:
380 0 The process is normally terminated
382 unspecified
384 An error occurred
385
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 http://www.ssisc.org/lis/
393 http://math.nist.gov/MatrixMarket/
394Man Page 19 Sep 2017 esolve(1)