KSPSetCheckNormIteration#
Sets the first iteration at which the norm of the residual will be computed and used in the convergence test of KSPSolve()
for the given KSP
context
Synopsis#
#include "petscksp.h"
PetscErrorCode KSPSetCheckNormIteration(KSP ksp, PetscInt it)
Logically Collective
Input Parameters#
ksp - Krylov solver context
it - use -1 to check at all iterations
Notes#
Currently only works with KSPCG
, KSPBCGS
and KSPIBCGS
Use KSPSetNormType
(ksp,KSP_NORM_NONE
) to never check the norm
On steps where the norm is not computed, the previous norm is still in the variable, so if you run with, for example,
-ksp_monitor
the residual norm will appear to be unchanged for several iterations (though it is not really unchanged).
Certain methods such as KSPGMRES
always compute the residual norm, this routine will not change that computation, but it will
prevent the computed norm from being checked.
See Also#
KSP: Linear System Solvers, KSP
, KSPSetUp()
, KSPSolve()
, KSPDestroy()
, KSPConvergedSkip()
, KSPSetNormType()
, KSPSetLagNorm()
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