SNESDefaultComputeJacobianColor
Computes the Jacobian using finite differences and coloring to exploit matrix sparsity.
Synopsis
#include "petscmat.h"
#include "petscsnes.h"
int SNESDefaultComputeJacobianColor(SNES snes,Vec x1,Mat *J,Mat *B,MatStructure *flag,void *ctx)
Collective on SNES
Input Parameters
| snes | - nonlinear solver object
|
| x1 | - location at which to evaluate Jacobian
|
| ctx | - coloring context, where ctx must have type MatFDColoring,
as created via MatFDColoringCreate()
|
Output Parameters
| J | - Jacobian matrix (not altered in this routine)
|
| B | - newly computed Jacobian matrix to use with preconditioner (generally the same as J)
|
| flag | - flag indicating whether the matrix sparsity structure has changed
|
Options Database Keys
-mat_fd_coloring_freq <freq> -Activates SNESDefaultComputeJacobianColor()
Keywords
SNES, finite differences, Jacobian, coloring, sparse
See Also
SNESSetJacobian(), SNESTestJacobian(), SNESDefaultComputeJacobian()
TSDefaultComputeJacobianColor(), MatFDColoringCreate(),
MatFDColoringSetFunction()
Level:intermediate
Location:src/snes/interface/snesj2.c
Index of all SNES routines
Table of Contents for all manual pages
Index of all manual pages
Examples
src/snes/examples/tutorials/ex4.c
src/snes/examples/tutorials/ex5c.c
src/snes/examples/tutorials/ex7.c
src/snes/examples/tutorials/ex8.c
src/snes/examples/tutorials/ex5s.c
src/snes/examples/tutorials/ex9.c
src/snes/examples/tutorials/ex4f.F