#include "petscsnes.h" int SNESSetJacobian(SNES snes,Mat A,Mat B,int (*func)(SNES,Vec,Mat*,Mat*,MatStructure*,void*),void *ctx)Collective on SNES and Mat
| snes | - the SNES context | |
| A | - Jacobian matrix | |
| B | - preconditioner matrix (usually same as the Jacobian) | |
| func | - Jacobian evaluation routine | |
| ctx | - [optional] user-defined context for private data for the Jacobian evaluation routine (may be PETSC_NULL) |
func (SNES snes,Vec x,Mat *A,Mat *B,int *flag,void *ctx);
| x | - input vector | |
| A | - Jacobian matrix | |
| B | - preconditioner matrix, usually the same as A | |
| flag | - flag indicating information about the preconditioner matrix structure (same as flag in SLESSetOperators()) | |
| ctx | - [optional] user-defined Jacobian context |
The routine func() takes Mat * as the matrix arguments rather than Mat. This allows the Jacobian evaluation routine to replace A and/or B with a completely new new matrix structure (not just different matrix elements) when appropriate, for instance, if the nonzero structure is changing throughout the global iterations.
Level:beginner
Location:src/snes/interface/snes.c
Index of all SNES routines
Table of Contents for all manual pages
Index of all manual pages