KSPSetErrorIfNotConverged

Causes KSPSolve() to generate an error if the solver has not converged as soon as the error is detected.

Synopsis

#include "petscksp.h" 
#include "petscmat.h" 
PetscErrorCode KSPSetErrorIfNotConverged(KSP ksp, PetscBool flg)

Logically Collective

Input Parameters

• ksp - iterative context obtained from KSPCreate()

• flg - PETSC_TRUE indicates you want the error generated

Options Database Key

• -ksp_error_if_not_converged <true,false> - generate an error and stop the program

Notes

Normally PETSc continues if a linear solver fails to converge, you can call KSPGetConvergedReason() after a KSPSolve() to determine if it has converged.

A KSP_DIVERGED_ITS will not generate an error in a KSPSolve() inside a nested linear solver

See Also

KSP: Linear System Solvers, KSPGetErrorIfNotConverged(), KSP

Level

intermediate

Location

src/ksp/ksp/interface/itfunc.c

---

Index of all KSP routines
Table of Contents for all manual pages
Index of all manual pages