petsc-3.7.1 2016-05-15
Report Typos and Errors

KSPSetNormType

Sets the norm that is used for convergence testing.

Synopsis

#include "petscksp.h" 
PetscErrorCode  KSPSetNormType(KSP ksp,KSPNormType normtype)
Logically Collective on KSP Many br

Input Parameter

ksp - Krylov solver context Many br
normtype - one of Many br
  KSP_NORM_NONE - skips computing the norm, this should only be used if you are using
                the Krylov method as a smoother with a fixed small number of iterations.
                Implicitly sets KSPConvergedSkip as KSP convergence test.
  KSP_NORM_PRECONDITIONED - the default for left preconditioned solves, uses the l2 norm
                of the preconditioned residual P^{-1}(b - A x)
  KSP_NORM_UNPRECONDITIONED - uses the l2 norm of the true b - Ax residual.
  KSP_NORM_NATURAL - supported  by KSPCG, KSPCR, KSPCGNE, KSPCGS

Options Database Key

-ksp_norm_type <none,preconditioned,unpreconditioned,natural> - Many brNotes: Many brNot all combinations of preconditioner side (see KSPSetPCSide()) and norm type are supported by all Krylov methods. Many brIf only one is set, PETSc tries to automatically change the other to find a compatible pair. If no such combination Many bris supported, PETSc will generate an error. Many br

Developer Notes

Supported combinations of norm and preconditioner side are set using KSPSetSupportedNorm(). Many br

Many br

Keywords

KSP, create, context, norms

See Also

KSPSetUp(), KSPSolve(), KSPDestroy(), KSPConvergedSkip(), KSPSetCheckNormIteration(), KSPSetPCSide(), KSPGetPCSide()

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