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 -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]
            The linear solver

    -e {aii|3}
        Approximate Inverse

        -i [cg]
            The linear solver

        -e {rqi|4}
            Rayleigh Quotient

            -i [cg]
                The linear solver

        -e {si|5}
            Subspace

            -ss [2]
                The size of the subspace

        -e {li|6}
            Lanczos

            -ss [2]
                The size of the subspace

            -m [0]
                The mode number

        -e {cg|7}
            CG

        -e {cr|8}
            CR

    -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 {minres|22}
            MINRES

    -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_w [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_w [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 structure 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 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}
            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}
            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}
            Quadruple precision
See Lis User Manual for full description.

SEE ALSO
lis(3)

http://www.ssisc.org/lis/