SNESGetNPC#
Gets a nonlinear preconditioning solver SNES` to be used to precondition the original nonlinear solver.
Synopsis#
#include "petscsnes.h"
PetscErrorCode SNESGetNPC(SNES snes, SNES *pc)
Not Collective; but any changes to the obtained the pc object must be applied collectively
Input Parameter#
snes - iterative context obtained from
SNESCreate()
Output Parameter#
pc - the
SNESpreconditioner context
Options Database Key#
-npc_snes_type
- set the type of theSNESto use as the nonlinear preconditioner
Notes#
If a SNES was previously set with SNESSetNPC() then that value is returned, otherwise a new SNES object is created that will
be used as the nonlinear preconditioner for the current SNES.
The (preconditioner) SNES returned automatically inherits the same nonlinear function and Jacobian supplied to the original
SNES. These may be overwritten if needed.
Use the options database prefixes -npc_snes, -npc_ksp, etc., to control the configuration of the nonlinear preconditioner
See Also#
SNES: Nonlinear Solvers, SNESSetNPC(), SNESHasNPC(), SNES, SNESCreate()
Level#
advanced
Location#
Examples#
Index of all SNES routines
Table of Contents for all manual pages
Index of all manual pages