# DMDASNESSetFunctionLocal
set a local residual evaluation function for use with `DMDA` 
## Synopsis
```
#include "petscdmda.h" 
#include "petscsnes.h" 
PetscErrorCode DMDASNESSetFunctionLocal(DM dm, InsertMode imode, PetscErrorCode (*func)(DMDALocalInfo *, void *, void *, void *), void *ctx)
```
Logically Collective


## Input Parameters

- ***dm -*** `DM` to associate callback with
- ***imode -*** `INSERT_VALUES` if local function computes owned part, `ADD_VALUES` if it contributes to ghosted part
- ***func -*** local residual evaluation
- ***ctx -*** optional context for local residual evaluation



## Calling sequence
For PetscErrorCode (*func)(DMDALocalInfo *info,void *x, void *f, void *ctx),

- ***info -*** `DMDALocalInfo` defining the subdomain to evaluate the residual on
- ***x -*** dimensional pointer to state at which to evaluate residual (e.g. PetscScalar *x or **x or ***x)
- ***f -*** dimensional pointer to residual, write the residual here (e.g. PetscScalar *f or **f or ***f)
- ***ctx -*** optional context passed above





## See Also
 `DMDA`, `DMDASNESSetJacobianLocal()`, `DMSNESSetFunction()`, `DMDACreate1d()`, `DMDACreate2d()`, `DMDACreate3d()`

## Level
beginner

## Location
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/snes/utils/dmdasnes.c.html#DMDASNESSetFunctionLocal">src/snes/utils/dmdasnes.c</A>

## Examples
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/snes/tutorials/ex15.c.html">src/snes/tutorials/ex15.c.html</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/snes/tutorials/ex16.c.html">src/snes/tutorials/ex16.c.html</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/snes/tutorials/ex19.c.html">src/snes/tutorials/ex19.c.html</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/snes/tutorials/ex25.c.html">src/snes/tutorials/ex25.c.html</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/snes/tutorials/ex30.c.html">src/snes/tutorials/ex30.c.html</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/snes/tutorials/ex33.c.html">src/snes/tutorials/ex33.c.html</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/snes/tutorials/ex40f90.F90.html">src/snes/tutorials/ex40f90.F90.html</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/snes/tutorials/ex46.c.html">src/snes/tutorials/ex46.c.html</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/snes/tutorials/ex48.c.html">src/snes/tutorials/ex48.c.html</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/snes/tutorials/ex5.c.html">src/snes/tutorials/ex5.c.html</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/snes/tutorials/ex55.c.html">src/snes/tutorials/ex55.c.html</A><BR>


---
[Edit on GitLab](https://gitlab.com/petsc/petsc/-/edit/release/src/snes/utils/dmdasnes.c)


[Index of all SNES routines](index.md)  
[Table of Contents for all manual pages](/docs/manualpages/index.md)  
[Index of all manual pages](/docs/manualpages/singleindex.md)  
