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, TSRHSJacobianFn *f, void *ctx)

Logically Collective

Input Parameters#

  • ts - the TS context obtained from TSCreate()

  • Amat - (approximate) location to store Jacobian matrix entries computed by f

  • Pmat - matrix from which preconditioner is to be constructed (usually the same as Amat)

  • f - the Jacobian evaluation routine

  • ctx - [optional] user-defined context for private data for the Jacobian evaluation routine (may be NULL)

Notes#

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

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

See Also#

TS: Scalable ODE and DAE Solvers, TS, TSRHSJacobianFn, SNESComputeJacobianDefaultColor(), TSSetRHSFunction(), TSRHSJacobianSetReuse(), TSSetIJacobian(), TSRHSFunctionFn, TSIFunctionFn

Level#

beginner

Location#

src/ts/interface/ts.c

Examples#

src/ts/tutorials/ex13.c
src/ts/tutorials/ex16fwd.c
src/ts/tutorials/ex5.c
src/ts/tutorials/ex41.c
src/ts/tutorials/ex20td.c
src/ts/tutorials/ex50.c
src/ts/tutorials/ex40.c
src/ts/tutorials/ex21.c
src/ts/tutorials/ex20opt_ic.c
src/ts/tutorials/extchem.c


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