petsc-3.14.6 2021-03-30

DMSNESSetFunction

set SNES residual evaluation function

Synopsis

#include "petscsnes.h" 
#include "petscdm.h" 
PetscErrorCode DMSNESSetFunction(DM dm,PetscErrorCode (*f)(SNES,Vec,Vec,void*),void *ctx)

Not Collective

Input Arguments

	dm	- DM to be used with SNES
	f	- residual evaluation function; see SNESFunction for details
	ctx	- context for residual evaluation

Note

SNESSetFunction() is normally used, but it calls this function internally because the user context is actually associated with the DM. This makes the interface consistent regardless of whether the user interacts with a DM or not. If DM took a more central role at some later date, this could become the primary method of setting the residual.

Level

advanced

Location