xref: /petsc/src/snes/interface/snesj2.c (revision dff777c9cab7a89ed3d59de96f6d397d06c0fa5a)
1a5eb4965SSatish Balay #ifdef PETSC_RCS_HEADER
2*dff777c9SBarry Smith static char vcid[] = "$Id: snesj2.c,v 1.10 1997/10/12 21:40:52 bsmith Exp bsmith $";
391627157SBarry Smith #endif
491627157SBarry Smith 
5639f9d9dSBarry Smith #include "src/mat/matimpl.h"      /*I  "mat.h"  I*/
6639f9d9dSBarry Smith #include "src/snes/snesimpl.h"    /*I  "snes.h"  I*/
791627157SBarry Smith 
85615d1e5SSatish Balay #undef __FUNC__
95615d1e5SSatish Balay #define __FUNC__ "SNESDefaultComputeJacobianWithColoring"
1091627157SBarry Smith /*@C
11b4fc646aSLois Curfman McInnes     SNESDefaultComputeJacobianWithColoring - Computes the Jacobian using
12b4fc646aSLois Curfman McInnes     finite differences and coloring to exploit matrix sparsity.
1391627157SBarry Smith 
1491627157SBarry Smith     Input Parameters:
1591627157SBarry Smith .   snes - nonlinear solver object
1691627157SBarry Smith .   x1 - location at which to evaluate Jacobian
17ff0cfa39SBarry Smith .   ctx - coloring context, where
18ff0cfa39SBarry Smith $      ctx must have type MatFDColoring,
19ff0cfa39SBarry Smith $      as created via MatFDColoringCreate()
2091627157SBarry Smith 
2191627157SBarry Smith     Output Parameters:
22b4fc646aSLois Curfman McInnes .   J - Jacobian matrix (not altered in this routine)
23b4fc646aSLois Curfman McInnes .   B - newly computed Jacobian matrix to use with preconditioner (generally the same as J)
24b4fc646aSLois Curfman McInnes .   flag - flag indicating whether the matrix sparsity structure has changed
2591627157SBarry Smith 
26*dff777c9SBarry Smith    Options Database Keys:
27*dff777c9SBarry Smith $  -mat_fd_coloring_freq <freq>
28*dff777c9SBarry Smith 
29b4fc646aSLois Curfman McInnes .keywords: SNES, finite differences, Jacobian, coloring, sparse
3091627157SBarry Smith 
31b4fc646aSLois Curfman McInnes .seealso: SNESSetJacobian(), SNESTestJacobian(), SNESDefaultComputeJacobian()
3291627157SBarry Smith @*/
33b4fc646aSLois Curfman McInnes int SNESDefaultComputeJacobianWithColoring(SNES snes,Vec x1,Mat *J,Mat *B,MatStructure *flag,void *ctx)
3491627157SBarry Smith {
3591627157SBarry Smith   MatFDColoring color = (MatFDColoring) ctx;
36*dff777c9SBarry Smith   int           ierr,freq,it;
37*dff777c9SBarry Smith 
38*dff777c9SBarry Smith   ierr = MatFDColoringGetFrequency(color,&freq);CHKERRQ(ierr);
39*dff777c9SBarry Smith   ierr = SNESGetIterationNumber(snes,&it); CHKERRQ(ierr);
40*dff777c9SBarry Smith 
41*dff777c9SBarry Smith   if ((freq > 1) && ((it % freq) != 1)) {
42*dff777c9SBarry Smith     PLogInfo(color,"SNESDefaultComputeJacobianWithColoring:Skipping Jacobian, it %d, freq %d\n",it,freq);
43*dff777c9SBarry Smith     *flag = SAME_PRECONDITIONER;
44*dff777c9SBarry Smith     return 0;
45*dff777c9SBarry Smith   } else {
46*dff777c9SBarry Smith     PLogInfo(color,"SNESDefaultComputeJacobianWithColoring:Computing Jacobian, it %d, freq %d\n",it,freq);
47*dff777c9SBarry Smith     *flag = SAME_NONZERO_PATTERN;
48*dff777c9SBarry Smith   }
4988389382SBarry Smith 
50005c665bSBarry Smith   ierr = MatFDColoringApply(*B,color,x1,flag,snes); CHKERRQ(ierr);
5191627157SBarry Smith   return 0;
5291627157SBarry Smith }
5391627157SBarry Smith 
5491627157SBarry Smith 
5591627157SBarry Smith 
56