lis_esolver_set_option(3) - Linux man page
Name
lis_esolver_set_option - set the options for the eigensolver
Synopsis
#include "lis.h"
LIS_INT lis_esolver_set_option(char *text, LIS_ESOLVER *esolver);
Description
Set the options for the eigensolver.
Input
- text
- The
command line options
Output
- esolver
- The eigensolver
Exit Status
The following exit values are returned:
- 0
- The process is normally terminated
- unspecified
- An
error occurred
Note
The table below shows the available command line options, where -e {pi|1} means -e pi or -e 1 and -emaxiter [1000] indicates that -emaxiter defaults to 1,000.
Options
The following options are supported:
- -e eigensolver
- The following options are supported for eigensolver:
- -e {pi|1}
- Power
- -e {ii|2}
- Inverse
- -i [cg]
- -e {aii|3}
- Approximate Inverse
- -i [cg]
- The linear solver
- -e {rqi|4}
- Rayleigh Quotient
- -i [cg]
- -e {si|5}
- Subspace
- -ss [2]
- -e {li|6}
- Lanczos
- -ss [2]
The mode number
- -m [0]
- -e {cg|7}
- CG
- -e {cr|8}
- -i linear solver
- The following options are supported for inner linear solver:
- -i {cg|1}
- CG
- -i {bicg|2}
- BiCG
- -i {cgs|3}
- CGS
- -i {bicgstab|4}
- BiCGSTAB
- -i {bicgstabl|5}
- BiCGSTAB(l)
- -ell [2]
- -i {gpbicg|6}
- GPBiCG
- -i {tfqmr|7}
- TFQMR
- -i {orthomin|8}
- Orthomin(m)
- -restart [40]
- -i {gmres|9}
- GMRES(m)
- -restart [40]
- -i {jacobi|10}
- Jacobi
- -i {gs|11}
- Gauss-Seidel
- -i {sor|12}
- SOR
- -omega [1.9]
- The relaxation coefficient omega (0<omega<2)
- -i {bicgsafe|13}
- BiCGSafe
- -i {cr|14}
- CR
- -i {bicr|15}
- BiCR
- -i {crs|16}
- CRS
- -i {bicrstab|17}
- BiCRSTAB
- -i {gpbicr|18}
- GPBiCR
- -i {bicrsafe|19}
- BiCRSafe
- -i {fgmres|20}
- FGMRES(m)
- -restart [40]
- -i {idrs|21}
- IDR(s)
- -irestart [2]
- -i {minres|22}
- -p preconditioner
- The following options are supported for preconditioner:
- -p {none|0}
- None
- -p {jacobi|1}
- Jacobi
- -p {ilu|2}
- ILU(k)
- -ilu_fill [0]
- -p {ssor|3}
- SSOR
- -ssor_w [1.0]
- The relaxation coefficient omega (0<omega<2)
- -p {hybrid|4}
- Hybrid
- -hybrid_i [sor]
The maximum number of iterations
- -hybrid_maxiter [25]
The convergence criterion
- -hybrid_tol [1.0e-3]
- -hybrid_w [1.5]
- The relaxation coefficient omega of the SOR (0<omega<2)
- -hybrid_ell [2]
- The degree l of the BiCGSTAB(l)
The restart values of the GMRES and Orthomin
- -hybrid_restart [40]
- -p {is|5}
- I+S
- -is_alpha [1.0]
- The parameter alpha of I+alpha*S(m)
- -is_m [3]
- The parameter m of I+alpha*S(m)
- -p {sainv|6}
- SAINV
- -sainv_drop [0.05]
- -p {saamg|7}
- SA-AMG
- -saamg_unsym [false]
- Select the unsymmetric version (The matrix structure must be symmetric)
The drop criterion
- -saamg_theta [0.05|0.12]
- -p {iluc|8}
- Crout ILU
- -iluc_drop [0.05]
The ration of maximum fill-in
- -iluc_rate [5.0]
- -p {ilut|9}
- ILUT
- -ilut_drop [0.05]
The ration of maximum fill-in
- -ilut_rate [5.0]
- -adds true
- Additive Schwarz
- -adds_iter [1]
Other Options for eigensolver:
- -emaxiter [1000]
- The maximum number of iterations
- -etol [1.0e-12]
- The convergence criterion
- -eprint [0]
- The display of the residual
- -eprint {none|0}
Save the residual history
- -eprint {mem|1}
Display the residual history
- -eprint {out|2}
Save the residual history and display it on the screen
- -eprint {all|3}
- -ie [ii]
- The inner eigensolver used in the Lanczos and Subspace
- -shift [0.0]
- The amount of the shift
- -initx_ones [true]
- The behavior of the initial vector x_0
- -initx_ones {false|0}
All values are set to 1
- -initx_ones {true|1}
- -omp_num_threads [t]
- The number of threads (t represents the maximum number of threads)
- -estorage [0]
- The matrix storage format
- -estorage_block [2]
- The block size of the BSR and BSC formats
- -ef [0]
- The precision of the eigensolver
- -ef {double|0}
Quadruple precision
- -ef {quad|1}
Other options for inner linear solver:
- -maxiter [1000]
- The maximum number of iterations
- -tol [1.0e-12]
- The convergence criterion
- -print [0]
- The display of the residual
- -print {none|0}
Save the residual history
- -print {mem|1}
Display the residual history
- -print {out|2}
Save the residual history and display it on the screen
- -print {all|3}
- -scale [0]
- The scaling
- -scale {none|0}
The Jacobi scaling
- -scale {jacobi|1}
The diagonal scaling
- -scale {symm_diag|2}
- -initx_zeros [true]
- The behavior of the initial vector x_0
- -initx_zero {false|0}
All values are set to 0
- -initx_zero {true|1}
- -omp_num_threads [t]
- The number of threads (t represents the maximum number of threads)
- -storage [0]
- The matrix storage format
- -storage_block [2]
- The block size of the BSR and BSC formats
- -f [0]
- The precision of the linear solver
- -f {double|0}
Quadruple precision
- -f {quad|1}
See Lis User Manual for full description.
See Also
lis(3)