petsc-3.3-p7 2013-05-11

KSPSetFromOptions

Sets KSP options from the options database. This routine must be called before KSPSetUp() if the user is to be allowed to set the Krylov type.

Synopsis

#include "petscksp.h" 
PetscErrorCode  KSPSetFromOptions(KSP ksp)
Collective on KSP

Input Parameters

ksp -the Krylov space context

Options Database Keys

                      convergence test (say you always want to run with 5 iterations) to 
                      save on communication overhead
                   preconditioned - default for left preconditioning 
                   unpreconditioned - see KSPSetNormType()
                   natural - see KSPSetNormType()
      works only for PCBCGS, PCIBCGS and and PCCG
-ksp_lag_norm - compute the norm of the residual for the ith iteration on the i+1 iteration; this means that one can use
      the norm of the residual for convergence test WITHOUT an extra MPI_Allreduce() limiting global synchronizations.
      This will require 1 more iteration of the solver than usual.
-ksp_max_it - maximum number of linear iterations
-ksp_rtol rtol - relative tolerance used in default determination of convergence, i.e. if residual norm decreases by this factor than convergence is declared
-ksp_atol abstol - absolute tolerance used in default convergence test, i.e. if residual norm is less than this then convergence is declared
-ksp_divtol tol - if residual norm increases by this factor than divergence is declared
-ksp_converged_use_initial_residual_norm - see KSPDefaultConvergedSetUIRNorm()
-ksp_converged_use_min_initial_residual_norm - see KSPDefaultConvergedSetUMIRNorm()
-ksp_norm_type - none - skip norms used in convergence tests (useful only when not using
-ksp_check_norm_iteration it - do not compute residual norm until iteration number it (does compute at 0th iteration)
-ksp_fischer_guess <model,size> - uses the Fischer initial guess generator for repeated linear solves
-ksp_constant_null_space - assume the operator (matrix) has the constant vector in its null space
-ksp_test_null_space - tests the null space set with KSPSetNullSpace() to see if it truly is a null space
-ksp_knoll - compute initial guess by applying the preconditioner to the right hand side
-ksp_monitor_cancel - cancel all previous convergene monitor routines set
-ksp_monitor <optional filename> - print residual norm at each iteration
-ksp_monitor_draw - plot residual norm at each iteration
-ksp_monitor_solution - plot solution at each iteration
-ksp_monitor_singular_value - monitor extremem singular values at each iteration

Notes

To see all options, run your program with the -help option or consult <A href="../../docs/manual.pdf#nameddest=Chapter 4 KSP: Linear Equations Solvers">KSP chapter of the users manual</A>.

Keywords

KSP, set, from, options, database

See Also

KSPSetUseFischerInitialGuess()

Level:beginner
Location:
src/ksp/ksp/interface/itcl.c
Index of all KSP routines
Table of Contents for all manual pages
Index of all manual pages

Examples

src/ksp/pc/examples/tutorials/ex1.c.html
src/ksp/pc/examples/tutorials/ex2.c.html
src/ksp/ksp/examples/tutorials/ex1.c.html
src/ksp/ksp/examples/tutorials/ex2.c.html
src/ksp/ksp/examples/tutorials/ex3.c.html
src/ksp/ksp/examples/tutorials/ex4.c.html
src/ksp/ksp/examples/tutorials/ex5.c.html
src/ksp/ksp/examples/tutorials/ex7.c.html
src/ksp/ksp/examples/tutorials/ex8.c.html
src/ksp/ksp/examples/tutorials/ex8g.c.html
src/ksp/ksp/examples/tutorials/ex9.c.html