krylov_bem_solver

the old Krylov solver only allows a single level preconditioning but the new Krylov solver cannot store intermediate results to restart after the process has been terminated externally (time limit on server, blackout,…)

The parameters for the fftm_multiplication and the preconditioner_electrostatic_parameters are the same as for <fast_multipole_matrix>, see its documentation.

XML element: <krylov_bem_solver>
C++ type: KKrylovChargeDensitySolverOld
Also available as: krylov_bem_solver_old, krylov_charge_density_solver_old
Child elements

Element

Description

fftm_multiplication

preconditioner_electrostatic_parameters

Attributes

Attribute

Type

Description

intermediate_save_interval

unsigned int

the number of main iteration steps between subsequent saves of the intermediate state to the disk

iterations_between_restarts

unsigned int

specify the maximuum number of iterations before the algorithm will restart. This means using the last solution but discarding the constructed Krylov subspace. For more information on the theory of restarted gmres or bicgstab, google it.

max_iterations

unsigned int

specify the maximum number of iterations after which the solver will finish regardless of convergence

max_preconditioner_iterations

unsigned int

only for the implicit_krylov preconditioner! define after how many iterations the precondiitoner stops regardless of convergence

preconditioner

string

specify the preconditioner type. Options are:

  • none: use no preconditioner

  • jacobi: use the inverse of the diagonal as preconditioner

  • implicit_krylov: use an inner Krylov solver with a different FFTM matrix defined by the attributes of the Krylov solver.

  • independent_implicit_krylov: use an inner Krylov solver with a different FFTM matrix defined by the preconditioner_electrostatic_parameters element. This is more flexible than the other Krylov preconditioner option.

preconditioner_degree

unsigned int

only for the implicit_krylov preconditioner! the maximum expansion degree of the multipole and local expansions used in the preconditioner

preconditioner_tolerance

double

only for the implicit_krylov preconditioner! define the tolerance just as in the main procedure

show_plot

bool

works with vtk only: display the convergence curve in a graph

solver_name

string

specify the solver type by name. gmres and bicgstab are available.

time_check_interval

unsigned int

the number of main iterations between calls to the timer enabling it to stop the process.

time_limit_in_seconds

double

time after which the timer will terminate when the then current iteration finishes

tolerance

double

specify the desired reduction of the start residual to define convergence. This defaults to 1e-8, meaning that the algorithm will stop when the norm of the residual has fallen to 1e-8 times its value in the first iteration (the norm of the vector describing the desired potential distribution).

use_display

bool

display progress in the form of iteration number and residual on the console

use_timer

bool

boolean option to stop the programm at the end of a main iteration after a specified amount of time has passed. For time_check_interval greater than one, the timer will be called less often to check if the programm should terminate.

Example:

<krylov_charge_density_solver_old
    solver_name="gmres"
    preconditioner="independent_implicit_krylov"
    tolerance="1e-8"
    max_iterations="500"
    iterations_between_restarts="500"
    preconditioner_tolerance="1e-2"
    max_preconditioner_iterations="5"
    preconditioner_degree="2"
    intermediate_save_interval="0"
    use_display="true"
    show_plot="true"
    use_timer="true"
    time_limit_in_seconds="100"
    time_check_interval="1"
>
    <fftm_multiplication
        strategy="balanced"
        top_level_divisions="4"
        tree_level_divisions="2"
        expansion_degree="5"
        maximum_tree_depth="2"
        region_expansion_factor="1.1"
        use_region_size_estimation="true"
        world_cube_center_x="0"
        world_cube_center_y="0"
        world_cube_center_z="0"
        world_cube_length="10"
        use_caching="false"
        verbosity="3"
        insertion_ratio="1.33333333333"
    />
    <preconditioner_electrostatic_parameters
        strategy="balanced"
        top_level_divisions="4"
        tree_level_divisions="2"
        expansion_degree="2"
        maximum_tree_depth="2"
        region_expansion_factor="1.1"
        use_region_size_estimation="true"
        world_cube_center_x="0"
        world_cube_center_y="0"
        world_cube_center_z="0"
        world_cube_length="10"
        use_caching="false"
        verbosity="3"
        insertion_ratio="1.33333333333"
    />
</krylov_charge_density_solver_old>

Used as:

  • <krylov_bem_solver>, <krylov_bem_solver_old>, <krylov_charge_density_solver_old> in <electrostatic_field>

More information

Used in example configurations: