DMDASNESSetObjectiveLocal#
set a local residual evaluation function to used with a DMDA
Synopsis#
#include "petscdmda.h"
#include "petscsnes.h"
PetscErrorCode DMDASNESSetObjectiveLocal(DM dm, PetscErrorCode (*func)(DMDALocalInfo *info, void *x, PetscReal *obj, void *), void *ctx)
Logically Collective
Input Parameters#
dm -
DMto associate callback withfunc - local objective evaluation, see
DMDASNESSetObjectiveLocalfor the calling sequencectx - optional context for local residual evaluation
Calling sequence of func#
info -
DMDALocalInfodefining the subdomain to evaluate the Jacobian atx - dimensional pointer to state at which to evaluate the objective (e.g. PetscScalar *x or **x or ***x)
obj - returned objective value for the local subdomain
ctx - optional context passed above
See Also#
SNES: Nonlinear Solvers, DMDA, DMSNESSetFunction(), DMDASNESSetJacobianLocal(), DMDACreate1d(), DMDACreate2d(), DMDACreate3d(), DMDASNESObjectiveFn
Level#
beginner
Location#
Examples#
src/snes/tutorials/ex55.c
src/snes/tutorials/ex4.c
src/snes/tutorials/ex5.c
Index of all SNES routines
Table of Contents for all manual pages
Index of all manual pages