:orphan:
# DMTSSetForcingFunction
set `TS` forcing function evaluation function 
## Synopsis
```
#include "petscts.h" 
PetscErrorCode DMTSSetForcingFunction(DM dm, TSForcingFunction func, void *ctx)
```
Not Collective


## Input Parameters

- ***dm -*** `DM` to be used with `TS`
- ***func -*** forcing function evaluation routine
- ***ctx -*** context for solution evaluation



## Calling sequence of `func`
```none
PetscErrorCode func (TS ts, PetscReal t, Vec f,void *ctx)
```

- ***ts -*** timestep context
- ***t -*** current timestep
- ***f -*** output vector
- ***ctx -*** [optional] user-defined function context





## Note
`TSSetForcingFunction()` 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.


## See Also
 [](ch_ts), `DM`, `TS`, `DMTSSetContext()`, `TSSetFunction()`, `DMTSSetJacobian()`, `TSSetForcingFunction()`, `DMTSGetForcingFunction()`

## Level
advanced

## Location
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/ts/utils/dmts.c.html#DMTSSetForcingFunction">src/ts/utils/dmts.c</A>


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


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