DMDASNESSetJacobianLocal#

set a local Jacobian evaluation function for use with DMDA

Synopsis#

#include "petscdmda.h" 
#include "petscsnes.h" 
PetscErrorCode DMDASNESSetJacobianLocal(DM dm, PetscErrorCode (*func)(DMDALocalInfo *, void *, Mat, Mat, void *), void *ctx)

Logically Collective

Input Parameters#

dm - DM to associate callback with
func - local Jacobian evaluation
ctx - optional context for local Jacobian evaluation

Calling sequence of `func`#

PetscErrorCode func(DMDALocalInfo *info, void *x, Mat J, Mat M, void *ctx),

info - DMDALocalInfo defining the subdomain to evaluate the Jacobian at
x - dimensional pointer to state at which to evaluate Jacobian (e.g. PetscScalar *x or **x or ***x)
J - Mat object for the Jacobian
M - Mat object for the Jacobian preconditioner matrix, often J
ctx - optional context passed above

See Also#

DMDA, DMDASNESSetFunctionLocal(), DMSNESSetJacobian(), DMDACreate1d(), DMDACreate2d(), DMDACreate3d()

Level#

beginner

Location#

src/snes/utils/dmdasnes.c

Examples#

src/snes/tutorials/ex15.c
src/snes/tutorials/ex16.c
src/snes/tutorials/ex48.c
src/snes/tutorials/ex5.c
src/snes/tutorials/ex55.c
src/snes/tutorials/ex5f.F90
src/snes/tutorials/ex9.c

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