petsc-3.7.1 2016-05-15
Report Typos and Errors

# TSSetRHSJacobian

Sets the function to compute the Jacobian of G, where U_t = G(U,t), as well as the location to store the matrix.

### Synopsis

    #include "petscts.h"
    PetscErrorCode  TSSetRHSJacobian(TS ts,Mat Amat,Mat Pmat,TSRHSJacobian f,void *ctx)

Logically Collective on TS Many br

### Input Parameters

| ts | - the TS context obtained from TSCreate() Many br
| Amat | - (approximate) Jacobian matrix Many br
| Pmat | - matrix from which preconditioner is to be constructed (usually the same as Amat) Many br
| f | - the Jacobian evaluation routine Many br
| ctx | - [optional] user-defined context for private data for the Many brJacobian evaluation routine (may be NULL) Many br

### Calling sequence of f

        func (TS ts,PetscReal t,Vec u,Mat A,Mat B,void *ctx);

| t | - current timestep Many br
| u | - input vector Many br
| Amat | - (approximate) Jacobian matrix Many br
| Pmat | - matrix from which preconditioner is to be constructed (usually the same as Amat) Many br
| ctx | - [optional] user-defined context for matrix evaluation routine Many br

### Notes

You must set all the diagonal entries of the matrices, if they are zero you must still set them with a zero value Many br

The TS solver may modify the nonzero structure and the entries of the matrices Amat and Pmat between the calls to f() Many brYou should not assume the values are the same in the next call to f() as you set them in the previous call. Many br

Many br

### Keywords

TS, timestep, set, right-hand-side, Jacobian

### See Also

SNESComputeJacobianDefaultColor(), TSSetRHSFunction(), TSRHSJacobianSetReuse(), TSSetIJacobian()

Level:beginner
Location:src/ts/interface/ts.c
Index of all TS routines
Table of Contents for all manual pages
Index of all manual pages

### Examples

src/ts/examples/tutorials/ex1.c.html
src/ts/examples/tutorials/ex2.c.html
src/ts/examples/tutorials/ex3.c.html
src/ts/examples/tutorials/ex4.c.html
src/ts/examples/tutorials/ex5.c.html
src/ts/examples/tutorials/ex6.c.html
src/ts/examples/tutorials/ex13.c.html
src/ts/examples/tutorials/ex21.c.html
src/ts/examples/tutorials/extchem.c.html
src/ts/examples/tutorials/ex16adj.c.html
src/ts/examples/tutorials/ex16opt_p.c.html