FreeBSD Manual Pages
lis_esolver_set_option(3) Lis Library Functions lis_esolver_set_option(3) 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 -emax- iter 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 [bicg] The linear solver -e {rqi|3} Rayleigh Quotient -i [bicg] The linear solver -e {cg|4} CG -i [cg] The linear solver -e {cr|5} CR -i [bicg] The linear solver -e {si|6} Subspace -ss [1] The size of the subspace -e {li|7} Lanczos -ss [1] The size of the subspace -e {ai|8} Arnoldi -ss [1] The size of the subspace -e {gpi|9} Generalized Power -i [bicg] The linear solver -e {gii|10} Generalized Inverse -i [bicg] The linear solver -e {grqi|11} Generalized Rayleigh Quotient -i [bicg] The linear solver -e {gcg|12} Generalized CG -i [cg] The linear solver -e {gcr|13} Generalized CR -i [bicg] The linear solver -e {gsi|14} Generalized Subspace -ss [1] The size of the subspace -e {gli|15} Generalized Lanczos -ss [1] The size of the subspace -e {gai|16} Generalized Arnoldi -ss [1] The size of the subspace -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] The degree l -i {gpbicg|6} GPBiCG -i {tfqmr|7} TFQMR -i {orthomin|8} Orthomin(m) -restart [40] The restart value m -i {gmres|9} GMRES(m) -restart [40] The restart value m -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] The restart value m -i {idrs|21} IDR(s) -irestart [2] The restart value s -i {idr1|22} IDR(1) -i {minres|23} MINRES -i {cocg|24} COCG -i {cocr|25} COCR -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] The fill level k -p {ssor|3} SSOR -ssor_omega [1.0] The relaxation coefficient omega (0<omega<2) -p {hybrid|4} Hybrid -hybrid_i [sor] The linear solver -hybrid_maxiter [25] The maximum number of iterations -hybrid_tol [1.0e-3] The convergence criterion -hybrid_omega [1.5] The relaxation coefficient omega of the SOR (0<omega<2) -hybrid_ell [2] The degree l of the BiCGSTAB(l) -hybrid_restart [40] The restart values of the GMRES and Orthomin -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] The drop criterion -p {saamg|7} SA-AMG -saamg_unsym [false] Select the unsymmetric version (The matrix struc- ture must be symmetric) -saamg_theta [0.05|0.12] The drop criterion -p {iluc|8} Crout ILU -iluc_drop [0.05] The drop criterion -iluc_rate [5.0] The ration of maximum fill-in -p {ilut|9} ILUT -ilut_drop [0.05] The drop criterion -ilut_rate [5.0] The ration of maximum fill-in -adds true Additive Schwarz -adds_iter [1] The number of iteration 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} None -eprint {mem|1} Save the residual history -eprint {out|2} Display the residual history -eprint {all|3} Save the residual history and display it on the screen -ie [ii] The inner eigensolver used in Subspace, Lanczos, and Arnoldi -ige [ii] The inner eigensolver used in Generalized Subspace, Generalized Lanczos, and Generalized Arnoldi -shift [0.0] The amount of the shift -initx_ones [true] The behavior of the initial vector x_0 -initx_ones {false|0} Given values -initx_ones {true|1} All values are set to 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} Double precision -ef {quad|1} Double-double (quadruple) precision 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} None -print {mem|1} Save the residual history -print {out|2} Display the residual history -print {all|3} Save the residual history and display it on the screen -scale [0] The scaling -scale {none|0} No scaling -scale {jacobi|1} The Jacobi scaling -scale {symm_diag|2} The diagonal scaling -initx_zeros [true] The behavior of the initial vector x_0 -initx_zero {false|0} Given values -initx_zero {true|1} All values are set to 0 -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} Double precision -f {quad|1} Double-double (quadruple) precision See Lis User Guide for full description. SEE ALSO lis(3) http://www.ssisc.org/lis/ Man Page 14 Sep 2017 lis_esolver_set_option(3)
NAME | SYNOPSIS | DESCRIPTION | INPUT | OUTPUT | EXIT STATUS | NOTE | OPTIONS | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=lis_esolver_set_option&sektion=3&manpath=FreeBSD+Ports+15.0>