DMDASNESSetObjectiveLocalVec — PETSc 3.22.5 documentation

Skip to main content
`Ctrl`+`K`

# DMDASNESSetObjectiveLocalVec

set a local residual evaluation function that operates on a local vector with `DMDA`

## Synopsis

    #include "petscdmda.h"
    #include "petscsnes.h"
    PetscErrorCode DMDASNESSetObjectiveLocalVec(DM dm, PetscErrorCode (*func)(DMDALocalInfo *info, Vec x, PetscReal *obj, void *), void *ctx)

Logically Collective

## Input Parameters

- dm - `DM` to associate callback with

- func - local objective evaluation, see `DMDASNESSetObjectiveLocalVec` for the calling sequence

- ctx - optional context for local residual evaluation

## Calling sequence of `func`

- info - `DMDALocalInfo` defining the subdomain to evaluate the Jacobian at

- x - state vector at which to evaluate the objective

- obj - returned objective value for the local subdomain

- ctx - optional context passed above

## See Also

SNES: Nonlinear Solvers, `DMDA`, `DMDASNESSetObjectiveLocal()`, `DMSNESSetFunction()`, `DMDASNESSetJacobianLocalVec()`, `DMDACreate1d()`, `DMDACreate2d()`, `DMDACreate3d()`, `DMDASNESObjectiveVecFn`

## Level

beginner

## Location

src/snes/utils/dmdasnes.c

## Examples

src/snes/tutorials/ex55.c

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