#include /*I "petscsnes.h" I*/ #include #include #include #include #include PetscBool SNESRegisterAllCalled = PETSC_FALSE; PetscFunctionList SNESList = NULL; /* Logging support */ PetscClassId SNES_CLASSID, DMSNES_CLASSID; PetscLogEvent SNES_Solve, SNES_Setup, SNES_FunctionEval, SNES_JacobianEval, SNES_NGSEval, SNES_NGSFuncEval, SNES_NPCSolve, SNES_ObjectiveEval; /*@ SNESSetErrorIfNotConverged - Causes SNESSolve() to generate an error if the solver has not converged. Logically Collective on SNES Input Parameters: + snes - iterative context obtained from SNESCreate() - flg - PETSC_TRUE indicates you want the error generated Options database keys: . -snes_error_if_not_converged : this takes an optional truth value (0/1/no/yes/true/false) Level: intermediate Notes: Normally PETSc continues if a linear solver fails to converge, you can call SNESGetConvergedReason() after a SNESSolve() to determine if it has converged. .seealso: SNESGetErrorIfNotConverged(), KSPGetErrorIfNotConverged(), KSPSetErrorIFNotConverged() @*/ PetscErrorCode SNESSetErrorIfNotConverged(SNES snes,PetscBool flg) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidLogicalCollectiveBool(snes,flg,2); snes->errorifnotconverged = flg; PetscFunctionReturn(0); } /*@ SNESGetErrorIfNotConverged - Will SNESSolve() generate an error if the solver does not converge? Not Collective Input Parameter: . snes - iterative context obtained from SNESCreate() Output Parameter: . flag - PETSC_TRUE if it will generate an error, else PETSC_FALSE Level: intermediate .seealso: SNESSetErrorIfNotConverged(), KSPGetErrorIfNotConverged(), KSPSetErrorIFNotConverged() @*/ PetscErrorCode SNESGetErrorIfNotConverged(SNES snes,PetscBool *flag) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidBoolPointer(flag,2); *flag = snes->errorifnotconverged; PetscFunctionReturn(0); } /*@ SNESSetAlwaysComputesFinalResidual - does the SNES always compute the residual at the final solution? Logically Collective on SNES Input Parameters: + snes - the shell SNES - flg - is the residual computed? Level: advanced .seealso: SNESGetAlwaysComputesFinalResidual() @*/ PetscErrorCode SNESSetAlwaysComputesFinalResidual(SNES snes, PetscBool flg) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); snes->alwayscomputesfinalresidual = flg; PetscFunctionReturn(0); } /*@ SNESGetAlwaysComputesFinalResidual - does the SNES always compute the residual at the final solution? Logically Collective on SNES Input Parameter: . snes - the shell SNES Output Parameter: . flg - is the residual computed? Level: advanced .seealso: SNESSetAlwaysComputesFinalResidual() @*/ PetscErrorCode SNESGetAlwaysComputesFinalResidual(SNES snes, PetscBool *flg) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); *flg = snes->alwayscomputesfinalresidual; PetscFunctionReturn(0); } /*@ SNESSetFunctionDomainError - tells SNES that the input vector to your SNESFunction is not in the functions domain. For example, negative pressure. Logically Collective on SNES Input Parameters: . snes - the SNES context Level: advanced .seealso: SNESCreate(), SNESSetFunction(), SNESFunction @*/ PetscErrorCode SNESSetFunctionDomainError(SNES snes) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); if (snes->errorifnotconverged) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"User code indicates input vector is not in the function domain"); snes->domainerror = PETSC_TRUE; PetscFunctionReturn(0); } /*@ SNESSetJacobianDomainError - tells SNES that computeJacobian does not make sense any more. For example there is a negative element transformation. Logically Collective on SNES Input Parameters: . snes - the SNES context Level: advanced .seealso: SNESCreate(), SNESSetFunction(), SNESFunction(), SNESSetFunctionDomainError() @*/ PetscErrorCode SNESSetJacobianDomainError(SNES snes) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); if (snes->errorifnotconverged) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"User code indicates computeJacobian does not make sense"); snes->jacobiandomainerror = PETSC_TRUE; PetscFunctionReturn(0); } /*@ SNESSetCheckJacobianDomainError - if or not to check jacobian domain error after each Jacobian evaluation. By default, we check Jacobian domain error in the debug mode, and do not check it in the optimized mode. Logically Collective on SNES Input Parameters: + snes - the SNES context - flg - indicates if or not to check jacobian domain error after each Jacobian evaluation Level: advanced .seealso: SNESCreate(), SNESSetFunction(), SNESFunction(), SNESSetFunctionDomainError(), SNESGetCheckJacobianDomainError() @*/ PetscErrorCode SNESSetCheckJacobianDomainError(SNES snes, PetscBool flg) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); snes->checkjacdomainerror = flg; PetscFunctionReturn(0); } /*@ SNESGetCheckJacobianDomainError - Get an indicator whether or not we are checking Jacobian domain errors after each Jacobian evaluation. Logically Collective on SNES Input Parameters: . snes - the SNES context Output Parameters: . flg - PETSC_FALSE indicates that we don't check jacobian domain errors after each Jacobian evaluation Level: advanced .seealso: SNESCreate(), SNESSetFunction(), SNESFunction(), SNESSetFunctionDomainError(), SNESSetCheckJacobianDomainError() @*/ PetscErrorCode SNESGetCheckJacobianDomainError(SNES snes, PetscBool *flg) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidBoolPointer(flg,2); *flg = snes->checkjacdomainerror; PetscFunctionReturn(0); } /*@ SNESGetFunctionDomainError - Gets the status of the domain error after a call to SNESComputeFunction; Logically Collective on SNES Input Parameters: . snes - the SNES context Output Parameters: . domainerror - Set to PETSC_TRUE if there's a domain error; PETSC_FALSE otherwise. Level: advanced .seealso: SNESSetFunctionDomainError(), SNESComputeFunction() @*/ PetscErrorCode SNESGetFunctionDomainError(SNES snes, PetscBool *domainerror) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidBoolPointer(domainerror,2); *domainerror = snes->domainerror; PetscFunctionReturn(0); } /*@ SNESGetJacobianDomainError - Gets the status of the Jacobian domain error after a call to SNESComputeJacobian; Logically Collective on SNES Input Parameters: . snes - the SNES context Output Parameters: . domainerror - Set to PETSC_TRUE if there's a jacobian domain error; PETSC_FALSE otherwise. Level: advanced .seealso: SNESSetFunctionDomainError(), SNESComputeFunction(),SNESGetFunctionDomainError() @*/ PetscErrorCode SNESGetJacobianDomainError(SNES snes, PetscBool *domainerror) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidBoolPointer(domainerror,2); *domainerror = snes->jacobiandomainerror; PetscFunctionReturn(0); } /*@C SNESLoad - Loads a SNES that has been stored in binary with SNESView(). Collective on PetscViewer Input Parameters: + newdm - the newly loaded SNES, this needs to have been created with SNESCreate() or some related function before a call to SNESLoad(). - viewer - binary file viewer, obtained from PetscViewerBinaryOpen() Level: intermediate Notes: The type is determined by the data in the file, any type set into the SNES before this call is ignored. Notes for advanced users: Most users should not need to know the details of the binary storage format, since SNESLoad() and TSView() completely hide these details. But for anyone who's interested, the standard binary matrix storage format is .vb has not yet been determined .ve .seealso: PetscViewerBinaryOpen(), SNESView(), MatLoad(), VecLoad() @*/ PetscErrorCode SNESLoad(SNES snes, PetscViewer viewer) { PetscErrorCode ierr; PetscBool isbinary; PetscInt classid; char type[256]; KSP ksp; DM dm; DMSNES dmsnes; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidHeaderSpecific(viewer,PETSC_VIEWER_CLASSID,2); ierr = PetscObjectTypeCompare((PetscObject)viewer,PETSCVIEWERBINARY,&isbinary);CHKERRQ(ierr); if (!isbinary) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_WRONG,"Invalid viewer; open viewer with PetscViewerBinaryOpen()"); ierr = PetscViewerBinaryRead(viewer,&classid,1,NULL,PETSC_INT);CHKERRQ(ierr); if (classid != SNES_FILE_CLASSID) SETERRQ(PetscObjectComm((PetscObject)snes),PETSC_ERR_ARG_WRONG,"Not SNES next in file"); ierr = PetscViewerBinaryRead(viewer,type,256,NULL,PETSC_CHAR);CHKERRQ(ierr); ierr = SNESSetType(snes, type);CHKERRQ(ierr); if (snes->ops->load) { ierr = (*snes->ops->load)(snes,viewer);CHKERRQ(ierr); } ierr = SNESGetDM(snes,&dm);CHKERRQ(ierr); ierr = DMGetDMSNES(dm,&dmsnes);CHKERRQ(ierr); ierr = DMSNESLoad(dmsnes,viewer);CHKERRQ(ierr); ierr = SNESGetKSP(snes,&ksp);CHKERRQ(ierr); ierr = KSPLoad(ksp,viewer);CHKERRQ(ierr); PetscFunctionReturn(0); } #include #if defined(PETSC_HAVE_SAWS) #include #endif /*@C SNESViewFromOptions - View from Options Collective on SNES Input Parameters: + A - the application ordering context . obj - Optional object - name - command line option Level: intermediate .seealso: SNES, SNESView, PetscObjectViewFromOptions(), SNESCreate() @*/ PetscErrorCode SNESViewFromOptions(SNES A,PetscObject obj,const char name[]) { PetscErrorCode ierr; PetscFunctionBegin; PetscValidHeaderSpecific(A,SNES_CLASSID,1); ierr = PetscObjectViewFromOptions((PetscObject)A,obj,name);CHKERRQ(ierr); PetscFunctionReturn(0); } PETSC_EXTERN PetscErrorCode SNESComputeJacobian_DMDA(SNES,Vec,Mat,Mat,void*); /*@C SNESView - Prints the SNES data structure. Collective on SNES Input Parameters: + SNES - the SNES context - viewer - visualization context Options Database Key: . -snes_view - Calls SNESView() at end of SNESSolve() Notes: The available visualization contexts include + PETSC_VIEWER_STDOUT_SELF - standard output (default) - PETSC_VIEWER_STDOUT_WORLD - synchronized standard output where only the first processor opens the file. All other processors send their data to the first processor to print. The user can open an alternative visualization context with PetscViewerASCIIOpen() - output to a specified file. Level: beginner .seealso: PetscViewerASCIIOpen() @*/ PetscErrorCode SNESView(SNES snes,PetscViewer viewer) { SNESKSPEW *kctx; PetscErrorCode ierr; KSP ksp; SNESLineSearch linesearch; PetscBool iascii,isstring,isbinary,isdraw; DMSNES dmsnes; #if defined(PETSC_HAVE_SAWS) PetscBool issaws; #endif PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); if (!viewer) { ierr = PetscViewerASCIIGetStdout(PetscObjectComm((PetscObject)snes),&viewer);CHKERRQ(ierr); } PetscValidHeaderSpecific(viewer,PETSC_VIEWER_CLASSID,2); PetscCheckSameComm(snes,1,viewer,2); ierr = PetscObjectTypeCompare((PetscObject)viewer,PETSCVIEWERASCII,&iascii);CHKERRQ(ierr); ierr = PetscObjectTypeCompare((PetscObject)viewer,PETSCVIEWERSTRING,&isstring);CHKERRQ(ierr); ierr = PetscObjectTypeCompare((PetscObject)viewer,PETSCVIEWERBINARY,&isbinary);CHKERRQ(ierr); ierr = PetscObjectTypeCompare((PetscObject)viewer,PETSCVIEWERDRAW,&isdraw);CHKERRQ(ierr); #if defined(PETSC_HAVE_SAWS) ierr = PetscObjectTypeCompare((PetscObject)viewer,PETSCVIEWERSAWS,&issaws);CHKERRQ(ierr); #endif if (iascii) { SNESNormSchedule normschedule; DM dm; PetscErrorCode (*cJ)(SNES,Vec,Mat,Mat,void*); void *ctx; const char *pre = ""; ierr = PetscObjectPrintClassNamePrefixType((PetscObject)snes,viewer);CHKERRQ(ierr); if (!snes->setupcalled) { ierr = PetscViewerASCIIPrintf(viewer," SNES has not been set up so information may be incomplete\n");CHKERRQ(ierr); } if (snes->ops->view) { ierr = PetscViewerASCIIPushTab(viewer);CHKERRQ(ierr); ierr = (*snes->ops->view)(snes,viewer);CHKERRQ(ierr); ierr = PetscViewerASCIIPopTab(viewer);CHKERRQ(ierr); } ierr = PetscViewerASCIIPrintf(viewer," maximum iterations=%D, maximum function evaluations=%D\n",snes->max_its,snes->max_funcs);CHKERRQ(ierr); ierr = PetscViewerASCIIPrintf(viewer," tolerances: relative=%g, absolute=%g, solution=%g\n",(double)snes->rtol,(double)snes->abstol,(double)snes->stol);CHKERRQ(ierr); if (snes->usesksp) { ierr = PetscViewerASCIIPrintf(viewer," total number of linear solver iterations=%D\n",snes->linear_its);CHKERRQ(ierr); } ierr = PetscViewerASCIIPrintf(viewer," total number of function evaluations=%D\n",snes->nfuncs);CHKERRQ(ierr); ierr = SNESGetNormSchedule(snes, &normschedule);CHKERRQ(ierr); if (normschedule > 0) {ierr = PetscViewerASCIIPrintf(viewer," norm schedule %s\n",SNESNormSchedules[normschedule]);CHKERRQ(ierr);} if (snes->gridsequence) { ierr = PetscViewerASCIIPrintf(viewer," total number of grid sequence refinements=%D\n",snes->gridsequence);CHKERRQ(ierr); } if (snes->ksp_ewconv) { kctx = (SNESKSPEW*)snes->kspconvctx; if (kctx) { ierr = PetscViewerASCIIPrintf(viewer," Eisenstat-Walker computation of KSP relative tolerance (version %D)\n",kctx->version);CHKERRQ(ierr); ierr = PetscViewerASCIIPrintf(viewer," rtol_0=%g, rtol_max=%g, threshold=%g\n",(double)kctx->rtol_0,(double)kctx->rtol_max,(double)kctx->threshold);CHKERRQ(ierr); ierr = PetscViewerASCIIPrintf(viewer," gamma=%g, alpha=%g, alpha2=%g\n",(double)kctx->gamma,(double)kctx->alpha,(double)kctx->alpha2);CHKERRQ(ierr); } } if (snes->lagpreconditioner == -1) { ierr = PetscViewerASCIIPrintf(viewer," Preconditioned is never rebuilt\n");CHKERRQ(ierr); } else if (snes->lagpreconditioner > 1) { ierr = PetscViewerASCIIPrintf(viewer," Preconditioned is rebuilt every %D new Jacobians\n",snes->lagpreconditioner);CHKERRQ(ierr); } if (snes->lagjacobian == -1) { ierr = PetscViewerASCIIPrintf(viewer," Jacobian is never rebuilt\n");CHKERRQ(ierr); } else if (snes->lagjacobian > 1) { ierr = PetscViewerASCIIPrintf(viewer," Jacobian is rebuilt every %D SNES iterations\n",snes->lagjacobian);CHKERRQ(ierr); } ierr = SNESGetDM(snes,&dm);CHKERRQ(ierr); ierr = DMSNESGetJacobian(dm,&cJ,&ctx);CHKERRQ(ierr); if (snes->mf_operator) { ierr = PetscViewerASCIIPrintf(viewer," Jacobian is applied matrix-free with differencing\n");CHKERRQ(ierr); pre = "Preconditioning "; } if (cJ == SNESComputeJacobianDefault) { ierr = PetscViewerASCIIPrintf(viewer," %sJacobian is built using finite differences one column at a time\n",pre);CHKERRQ(ierr); } else if (cJ == SNESComputeJacobianDefaultColor) { ierr = PetscViewerASCIIPrintf(viewer," %sJacobian is built using finite differences with coloring\n",pre);CHKERRQ(ierr); /* it slightly breaks data encapsulation for access the DMDA information directly */ } else if (cJ == SNESComputeJacobian_DMDA) { MatFDColoring fdcoloring; ierr = PetscObjectQuery((PetscObject)dm,"DMDASNES_FDCOLORING",(PetscObject*)&fdcoloring);CHKERRQ(ierr); if (fdcoloring) { ierr = PetscViewerASCIIPrintf(viewer," %sJacobian is built using colored finite differences on a DMDA\n",pre);CHKERRQ(ierr); } else { ierr = PetscViewerASCIIPrintf(viewer," %sJacobian is built using a DMDA local Jacobian\n",pre);CHKERRQ(ierr); } } else if (snes->mf) { ierr = PetscViewerASCIIPrintf(viewer," Jacobian is applied matrix-free with differencing, no explict Jacobian\n");CHKERRQ(ierr); } } else if (isstring) { const char *type; ierr = SNESGetType(snes,&type);CHKERRQ(ierr); ierr = PetscViewerStringSPrintf(viewer," SNESType: %-7.7s",type);CHKERRQ(ierr); if (snes->ops->view) {ierr = (*snes->ops->view)(snes,viewer);CHKERRQ(ierr);} } else if (isbinary) { PetscInt classid = SNES_FILE_CLASSID; MPI_Comm comm; PetscMPIInt rank; char type[256]; ierr = PetscObjectGetComm((PetscObject)snes,&comm);CHKERRQ(ierr); ierr = MPI_Comm_rank(comm,&rank);CHKERRQ(ierr); if (!rank) { ierr = PetscViewerBinaryWrite(viewer,&classid,1,PETSC_INT,PETSC_FALSE);CHKERRQ(ierr); ierr = PetscStrncpy(type,((PetscObject)snes)->type_name,sizeof(type));CHKERRQ(ierr); ierr = PetscViewerBinaryWrite(viewer,type,sizeof(type),PETSC_CHAR,PETSC_FALSE);CHKERRQ(ierr); } if (snes->ops->view) { ierr = (*snes->ops->view)(snes,viewer);CHKERRQ(ierr); } } else if (isdraw) { PetscDraw draw; char str[36]; PetscReal x,y,bottom,h; ierr = PetscViewerDrawGetDraw(viewer,0,&draw);CHKERRQ(ierr); ierr = PetscDrawGetCurrentPoint(draw,&x,&y);CHKERRQ(ierr); ierr = PetscStrncpy(str,"SNES: ",sizeof(str));CHKERRQ(ierr); ierr = PetscStrlcat(str,((PetscObject)snes)->type_name,sizeof(str));CHKERRQ(ierr); ierr = PetscDrawStringBoxed(draw,x,y,PETSC_DRAW_BLUE,PETSC_DRAW_BLACK,str,NULL,&h);CHKERRQ(ierr); bottom = y - h; ierr = PetscDrawPushCurrentPoint(draw,x,bottom);CHKERRQ(ierr); if (snes->ops->view) { ierr = (*snes->ops->view)(snes,viewer);CHKERRQ(ierr); } #if defined(PETSC_HAVE_SAWS) } else if (issaws) { PetscMPIInt rank; const char *name; ierr = PetscObjectGetName((PetscObject)snes,&name);CHKERRQ(ierr); ierr = MPI_Comm_rank(PETSC_COMM_WORLD,&rank);CHKERRQ(ierr); if (!((PetscObject)snes)->amsmem && !rank) { char dir[1024]; ierr = PetscObjectViewSAWs((PetscObject)snes,viewer);CHKERRQ(ierr); ierr = PetscSNPrintf(dir,1024,"/PETSc/Objects/%s/its",name);CHKERRQ(ierr); PetscStackCallSAWs(SAWs_Register,(dir,&snes->iter,1,SAWs_READ,SAWs_INT)); if (!snes->conv_hist) { ierr = SNESSetConvergenceHistory(snes,NULL,NULL,PETSC_DECIDE,PETSC_TRUE);CHKERRQ(ierr); } ierr = PetscSNPrintf(dir,1024,"/PETSc/Objects/%s/conv_hist",name);CHKERRQ(ierr); PetscStackCallSAWs(SAWs_Register,(dir,snes->conv_hist,10,SAWs_READ,SAWs_DOUBLE)); } #endif } if (snes->linesearch) { ierr = SNESGetLineSearch(snes, &linesearch);CHKERRQ(ierr); ierr = PetscViewerASCIIPushTab(viewer);CHKERRQ(ierr); ierr = SNESLineSearchView(linesearch, viewer);CHKERRQ(ierr); ierr = PetscViewerASCIIPopTab(viewer);CHKERRQ(ierr); } if (snes->npc && snes->usesnpc) { ierr = PetscViewerASCIIPushTab(viewer);CHKERRQ(ierr); ierr = SNESView(snes->npc, viewer);CHKERRQ(ierr); ierr = PetscViewerASCIIPopTab(viewer);CHKERRQ(ierr); } ierr = PetscViewerASCIIPushTab(viewer);CHKERRQ(ierr); ierr = DMGetDMSNES(snes->dm,&dmsnes);CHKERRQ(ierr); ierr = DMSNESView(dmsnes, viewer);CHKERRQ(ierr); ierr = PetscViewerASCIIPopTab(viewer);CHKERRQ(ierr); if (snes->usesksp) { ierr = SNESGetKSP(snes,&ksp);CHKERRQ(ierr); ierr = PetscViewerASCIIPushTab(viewer);CHKERRQ(ierr); ierr = KSPView(ksp,viewer);CHKERRQ(ierr); ierr = PetscViewerASCIIPopTab(viewer);CHKERRQ(ierr); } if (isdraw) { PetscDraw draw; ierr = PetscViewerDrawGetDraw(viewer,0,&draw);CHKERRQ(ierr); ierr = PetscDrawPopCurrentPoint(draw);CHKERRQ(ierr); } PetscFunctionReturn(0); } /* We retain a list of functions that also take SNES command line options. These are called at the end SNESSetFromOptions() */ #define MAXSETFROMOPTIONS 5 static PetscInt numberofsetfromoptions; static PetscErrorCode (*othersetfromoptions[MAXSETFROMOPTIONS])(SNES); /*@C SNESAddOptionsChecker - Adds an additional function to check for SNES options. Not Collective Input Parameter: . snescheck - function that checks for options Level: developer .seealso: SNESSetFromOptions() @*/ PetscErrorCode SNESAddOptionsChecker(PetscErrorCode (*snescheck)(SNES)) { PetscFunctionBegin; if (numberofsetfromoptions >= MAXSETFROMOPTIONS) SETERRQ1(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE, "Too many options checkers, only %D allowed", MAXSETFROMOPTIONS); othersetfromoptions[numberofsetfromoptions++] = snescheck; PetscFunctionReturn(0); } PETSC_INTERN PetscErrorCode SNESDefaultMatrixFreeCreate2(SNES,Vec,Mat*); static PetscErrorCode SNESSetUpMatrixFree_Private(SNES snes, PetscBool hasOperator, PetscInt version) { Mat J; PetscErrorCode ierr; MatNullSpace nullsp; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); if (!snes->vec_func && (snes->jacobian || snes->jacobian_pre)) { Mat A = snes->jacobian, B = snes->jacobian_pre; ierr = MatCreateVecs(A ? A : B, NULL,&snes->vec_func);CHKERRQ(ierr); } if (version == 1) { ierr = MatCreateSNESMF(snes,&J);CHKERRQ(ierr); ierr = MatMFFDSetOptionsPrefix(J,((PetscObject)snes)->prefix);CHKERRQ(ierr); ierr = MatSetFromOptions(J);CHKERRQ(ierr); } else if (version == 2) { if (!snes->vec_func) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_WRONGSTATE,"SNESSetFunction() must be called first"); #if !defined(PETSC_USE_COMPLEX) && !defined(PETSC_USE_REAL_SINGLE) && !defined(PETSC_USE_REAL___FLOAT128) && !defined(PETSC_USE_REAL___FP16) ierr = SNESDefaultMatrixFreeCreate2(snes,snes->vec_func,&J);CHKERRQ(ierr); #else SETERRQ(PETSC_COMM_SELF,PETSC_ERR_SUP, "matrix-free operator rutines (version 2)"); #endif } else SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE, "matrix-free operator rutines, only version 1 and 2"); /* attach any user provided null space that was on Amat to the newly created matrix free matrix */ if (snes->jacobian) { ierr = MatGetNullSpace(snes->jacobian,&nullsp);CHKERRQ(ierr); if (nullsp) { ierr = MatSetNullSpace(J,nullsp);CHKERRQ(ierr); } } ierr = PetscInfo1(snes,"Setting default matrix-free operator routines (version %D)\n", version);CHKERRQ(ierr); if (hasOperator) { /* This version replaces the user provided Jacobian matrix with a matrix-free version but still employs the user-provided preconditioner matrix. */ ierr = SNESSetJacobian(snes,J,0,0,0);CHKERRQ(ierr); } else { /* This version replaces both the user-provided Jacobian and the user- provided preconditioner Jacobian with the default matrix free version. */ if ((snes->npcside== PC_LEFT) && snes->npc) { if (!snes->jacobian){ierr = SNESSetJacobian(snes,J,0,0,0);CHKERRQ(ierr);} } else { KSP ksp; PC pc; PetscBool match; ierr = SNESSetJacobian(snes,J,J,MatMFFDComputeJacobian,0);CHKERRQ(ierr); /* Force no preconditioner */ ierr = SNESGetKSP(snes,&ksp);CHKERRQ(ierr); ierr = KSPGetPC(ksp,&pc);CHKERRQ(ierr); ierr = PetscObjectTypeCompare((PetscObject)pc,PCSHELL,&match);CHKERRQ(ierr); if (!match) { ierr = PetscInfo(snes,"Setting default matrix-free preconditioner routines\nThat is no preconditioner is being used\n");CHKERRQ(ierr); ierr = PCSetType(pc,PCNONE);CHKERRQ(ierr); } } } ierr = MatDestroy(&J);CHKERRQ(ierr); PetscFunctionReturn(0); } static PetscErrorCode DMRestrictHook_SNESVecSol(DM dmfine,Mat Restrict,Vec Rscale,Mat Inject,DM dmcoarse,void *ctx) { SNES snes = (SNES)ctx; PetscErrorCode ierr; Vec Xfine,Xfine_named = NULL,Xcoarse; PetscFunctionBegin; if (PetscLogPrintInfo) { PetscInt finelevel,coarselevel,fineclevel,coarseclevel; ierr = DMGetRefineLevel(dmfine,&finelevel);CHKERRQ(ierr); ierr = DMGetCoarsenLevel(dmfine,&fineclevel);CHKERRQ(ierr); ierr = DMGetRefineLevel(dmcoarse,&coarselevel);CHKERRQ(ierr); ierr = DMGetCoarsenLevel(dmcoarse,&coarseclevel);CHKERRQ(ierr); ierr = PetscInfo4(dmfine,"Restricting SNES solution vector from level %D-%D to level %D-%D\n",finelevel,fineclevel,coarselevel,coarseclevel);CHKERRQ(ierr); } if (dmfine == snes->dm) Xfine = snes->vec_sol; else { ierr = DMGetNamedGlobalVector(dmfine,"SNESVecSol",&Xfine_named);CHKERRQ(ierr); Xfine = Xfine_named; } ierr = DMGetNamedGlobalVector(dmcoarse,"SNESVecSol",&Xcoarse);CHKERRQ(ierr); if (Inject) { ierr = MatRestrict(Inject,Xfine,Xcoarse);CHKERRQ(ierr); } else { ierr = MatRestrict(Restrict,Xfine,Xcoarse);CHKERRQ(ierr); ierr = VecPointwiseMult(Xcoarse,Xcoarse,Rscale);CHKERRQ(ierr); } ierr = DMRestoreNamedGlobalVector(dmcoarse,"SNESVecSol",&Xcoarse);CHKERRQ(ierr); if (Xfine_named) {ierr = DMRestoreNamedGlobalVector(dmfine,"SNESVecSol",&Xfine_named);CHKERRQ(ierr);} PetscFunctionReturn(0); } static PetscErrorCode DMCoarsenHook_SNESVecSol(DM dm,DM dmc,void *ctx) { PetscErrorCode ierr; PetscFunctionBegin; ierr = DMCoarsenHookAdd(dmc,DMCoarsenHook_SNESVecSol,DMRestrictHook_SNESVecSol,ctx);CHKERRQ(ierr); PetscFunctionReturn(0); } /* This may be called to rediscretize the operator on levels of linear multigrid. The DM shuffle is so the user can * safely call SNESGetDM() in their residual evaluation routine. */ static PetscErrorCode KSPComputeOperators_SNES(KSP ksp,Mat A,Mat B,void *ctx) { SNES snes = (SNES)ctx; PetscErrorCode ierr; Vec X,Xnamed = NULL; DM dmsave; void *ctxsave; PetscErrorCode (*jac)(SNES,Vec,Mat,Mat,void*) = NULL; PetscFunctionBegin; dmsave = snes->dm; ierr = KSPGetDM(ksp,&snes->dm);CHKERRQ(ierr); if (dmsave == snes->dm) X = snes->vec_sol; /* We are on the finest level */ else { /* We are on a coarser level, this vec was initialized using a DM restrict hook */ ierr = DMGetNamedGlobalVector(snes->dm,"SNESVecSol",&Xnamed);CHKERRQ(ierr); X = Xnamed; ierr = SNESGetJacobian(snes,NULL,NULL,&jac,&ctxsave);CHKERRQ(ierr); /* If the DM's don't match up, the MatFDColoring context needed for the jacobian won't match up either -- fixit. */ if (jac == SNESComputeJacobianDefaultColor) { ierr = SNESSetJacobian(snes,NULL,NULL,SNESComputeJacobianDefaultColor,0);CHKERRQ(ierr); } } /* Make sure KSP DM has the Jacobian computation routine */ { DMSNES sdm; ierr = DMGetDMSNES(snes->dm, &sdm);CHKERRQ(ierr); if (!sdm->ops->computejacobian) { ierr = DMCopyDMSNES(dmsave, snes->dm);CHKERRQ(ierr); } } /* Compute the operators */ ierr = SNESComputeJacobian(snes,X,A,B);CHKERRQ(ierr); /* Put the previous context back */ if (snes->dm != dmsave && jac == SNESComputeJacobianDefaultColor) { ierr = SNESSetJacobian(snes,NULL,NULL,jac,ctxsave);CHKERRQ(ierr); } if (Xnamed) {ierr = DMRestoreNamedGlobalVector(snes->dm,"SNESVecSol",&Xnamed);CHKERRQ(ierr);} snes->dm = dmsave; PetscFunctionReturn(0); } /*@ SNESSetUpMatrices - ensures that matrices are available for SNES, to be called by SNESSetUp_XXX() Collective Input Arguments: . snes - snes to configure Level: developer .seealso: SNESSetUp() @*/ PetscErrorCode SNESSetUpMatrices(SNES snes) { PetscErrorCode ierr; DM dm; DMSNES sdm; PetscFunctionBegin; ierr = SNESGetDM(snes,&dm);CHKERRQ(ierr); ierr = DMGetDMSNES(dm,&sdm);CHKERRQ(ierr); if (!sdm->ops->computejacobian) SETERRQ(PetscObjectComm((PetscObject)snes),PETSC_ERR_PLIB,"DMSNES not properly configured"); else if (!snes->jacobian && snes->mf) { Mat J; void *functx; ierr = MatCreateSNESMF(snes,&J);CHKERRQ(ierr); ierr = MatMFFDSetOptionsPrefix(J,((PetscObject)snes)->prefix);CHKERRQ(ierr); ierr = MatSetFromOptions(J);CHKERRQ(ierr); ierr = SNESGetFunction(snes,NULL,NULL,&functx);CHKERRQ(ierr); ierr = SNESSetJacobian(snes,J,J,0,0);CHKERRQ(ierr); ierr = MatDestroy(&J);CHKERRQ(ierr); } else if (snes->mf_operator && !snes->jacobian_pre && !snes->jacobian) { Mat J,B; ierr = MatCreateSNESMF(snes,&J);CHKERRQ(ierr); ierr = MatMFFDSetOptionsPrefix(J,((PetscObject)snes)->prefix);CHKERRQ(ierr); ierr = MatSetFromOptions(J);CHKERRQ(ierr); ierr = DMCreateMatrix(snes->dm,&B);CHKERRQ(ierr); /* sdm->computejacobian was already set to reach here */ ierr = SNESSetJacobian(snes,J,B,NULL,NULL);CHKERRQ(ierr); ierr = MatDestroy(&J);CHKERRQ(ierr); ierr = MatDestroy(&B);CHKERRQ(ierr); } else if (!snes->jacobian_pre) { PetscErrorCode (*nspconstr)(DM, PetscInt, MatNullSpace *); PetscDS prob; Mat J, B; MatNullSpace nullspace = NULL; PetscBool hasPrec = PETSC_FALSE; PetscInt Nf; J = snes->jacobian; ierr = DMGetDS(dm, &prob);CHKERRQ(ierr); if (prob) {ierr = PetscDSHasJacobianPreconditioner(prob, &hasPrec);CHKERRQ(ierr);} if (J) {ierr = PetscObjectReference((PetscObject) J);CHKERRQ(ierr);} else if (hasPrec) {ierr = DMCreateMatrix(snes->dm, &J);CHKERRQ(ierr);} ierr = DMCreateMatrix(snes->dm, &B);CHKERRQ(ierr); ierr = PetscDSGetNumFields(prob, &Nf);CHKERRQ(ierr); ierr = DMGetNullSpaceConstructor(snes->dm, Nf, &nspconstr);CHKERRQ(ierr); if (nspconstr) (*nspconstr)(snes->dm, -1, &nullspace); ierr = MatSetNullSpace(B, nullspace);CHKERRQ(ierr); ierr = MatNullSpaceDestroy(&nullspace);CHKERRQ(ierr); ierr = SNESSetJacobian(snes, J ? J : B, B, NULL, NULL);CHKERRQ(ierr); ierr = MatDestroy(&J);CHKERRQ(ierr); ierr = MatDestroy(&B);CHKERRQ(ierr); } { KSP ksp; ierr = SNESGetKSP(snes,&ksp);CHKERRQ(ierr); ierr = KSPSetComputeOperators(ksp,KSPComputeOperators_SNES,snes);CHKERRQ(ierr); ierr = DMCoarsenHookAdd(snes->dm,DMCoarsenHook_SNESVecSol,DMRestrictHook_SNESVecSol,snes);CHKERRQ(ierr); } PetscFunctionReturn(0); } /*@C SNESMonitorSetFromOptions - Sets a monitor function and viewer appropriate for the type indicated by the user Collective on SNES Input Parameters: + snes - SNES object you wish to monitor . name - the monitor type one is seeking . help - message indicating what monitoring is done . manual - manual page for the monitor . monitor - the monitor function - monitorsetup - a function that is called once ONLY if the user selected this monitor that may set additional features of the SNES or PetscViewer objects Level: developer .seealso: PetscOptionsGetViewer(), PetscOptionsGetReal(), PetscOptionsHasName(), PetscOptionsGetString(), PetscOptionsGetIntArray(), PetscOptionsGetRealArray(), PetscOptionsBool() PetscOptionsInt(), PetscOptionsString(), PetscOptionsReal(), PetscOptionsBool(), PetscOptionsName(), PetscOptionsBegin(), PetscOptionsEnd(), PetscOptionsHead(), PetscOptionsStringArray(),PetscOptionsRealArray(), PetscOptionsScalar(), PetscOptionsBoolGroupBegin(), PetscOptionsBoolGroup(), PetscOptionsBoolGroupEnd(), PetscOptionsFList(), PetscOptionsEList() @*/ PetscErrorCode SNESMonitorSetFromOptions(SNES snes,const char name[],const char help[], const char manual[],PetscErrorCode (*monitor)(SNES,PetscInt,PetscReal,PetscViewerAndFormat*),PetscErrorCode (*monitorsetup)(SNES,PetscViewerAndFormat*)) { PetscErrorCode ierr; PetscViewer viewer; PetscViewerFormat format; PetscBool flg; PetscFunctionBegin; ierr = PetscOptionsGetViewer(PetscObjectComm((PetscObject)snes),((PetscObject) snes)->options,((PetscObject)snes)->prefix,name,&viewer,&format,&flg);CHKERRQ(ierr); if (flg) { PetscViewerAndFormat *vf; ierr = PetscViewerAndFormatCreate(viewer,format,&vf);CHKERRQ(ierr); ierr = PetscObjectDereference((PetscObject)viewer);CHKERRQ(ierr); if (monitorsetup) { ierr = (*monitorsetup)(snes,vf);CHKERRQ(ierr); } ierr = SNESMonitorSet(snes,(PetscErrorCode (*)(SNES,PetscInt,PetscReal,void*))monitor,vf,(PetscErrorCode (*)(void**))PetscViewerAndFormatDestroy);CHKERRQ(ierr); } PetscFunctionReturn(0); } /*@ SNESSetFromOptions - Sets various SNES and KSP parameters from user options. Collective on SNES Input Parameter: . snes - the SNES context Options Database Keys: + -snes_type - newtonls, newtontr, ngmres, ncg, nrichardson, qn, vi, fas, SNESType for complete list . -snes_stol - convergence tolerance in terms of the norm of the change in the solution between steps . -snes_atol - absolute tolerance of residual norm . -snes_rtol - relative decrease in tolerance norm from initial . -snes_divergence_tolerance - if the residual goes above divtol*rnorm0, exit with divergence . -snes_force_iteration - force SNESSolve() to take at least one iteration . -snes_max_it - maximum number of iterations . -snes_max_funcs - maximum number of function evaluations . -snes_max_fail - maximum number of line search failures allowed before stopping, default is none . -snes_max_linear_solve_fail - number of linear solver failures before SNESSolve() stops . -snes_lag_preconditioner - how often preconditioner is rebuilt (use -1 to never rebuild) . -snes_lag_jacobian - how often Jacobian is rebuilt (use -1 to never rebuild) . -snes_trtol - trust region tolerance . -snes_no_convergence_test - skip convergence test in nonlinear solver; hence iterations will continue until max_it or some other criterion is reached. Saves expense of convergence test . -snes_monitor [ascii][:filename][:viewer format] - prints residual norm at each iteration. if no filename given prints to stdout . -snes_monitor_solution [ascii binary draw][:filename][:viewer format] - plots solution at each iteration . -snes_monitor_residual [ascii binary draw][:filename][:viewer format] - plots residual (not its norm) at each iteration . -snes_monitor_solution_update [ascii binary draw][:filename][:viewer format] - plots update to solution at each iteration . -snes_monitor_lg_residualnorm - plots residual norm at each iteration . -snes_monitor_lg_range - plots residual norm at each iteration . -snes_fd - use finite differences to compute Jacobian; very slow, only for testing . -snes_fd_color - use finite differences with coloring to compute Jacobian . -snes_mf_ksp_monitor - if using matrix-free multiply then print h at each KSP iteration . -snes_converged_reason - print the reason for convergence/divergence after each solve - -npc_snes_type - the SNES type to use as a nonlinear preconditioner Options Database for Eisenstat-Walker method: + -snes_ksp_ew - use Eisenstat-Walker method for determining linear system convergence . -snes_ksp_ew_version ver - version of Eisenstat-Walker method . -snes_ksp_ew_rtol0 - Sets rtol0 . -snes_ksp_ew_rtolmax - Sets rtolmax . -snes_ksp_ew_gamma - Sets gamma . -snes_ksp_ew_alpha - Sets alpha . -snes_ksp_ew_alpha2 - Sets alpha2 - -snes_ksp_ew_threshold - Sets threshold Notes: To see all options, run your program with the -help option or consult Users-Manual: ch_snes Level: beginner .seealso: SNESSetOptionsPrefix(), SNESResetFromOptions() @*/ PetscErrorCode SNESSetFromOptions(SNES snes) { PetscBool flg,pcset,persist,set; PetscInt i,indx,lag,grids; const char *deft = SNESNEWTONLS; const char *convtests[] = {"default","skip"}; SNESKSPEW *kctx = NULL; char type[256], monfilename[PETSC_MAX_PATH_LEN]; PetscErrorCode ierr; PCSide pcside; const char *optionsprefix; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); ierr = SNESRegisterAll();CHKERRQ(ierr); ierr = PetscObjectOptionsBegin((PetscObject)snes);CHKERRQ(ierr); if (((PetscObject)snes)->type_name) deft = ((PetscObject)snes)->type_name; ierr = PetscOptionsFList("-snes_type","Nonlinear solver method","SNESSetType",SNESList,deft,type,256,&flg);CHKERRQ(ierr); if (flg) { ierr = SNESSetType(snes,type);CHKERRQ(ierr); } else if (!((PetscObject)snes)->type_name) { ierr = SNESSetType(snes,deft);CHKERRQ(ierr); } ierr = PetscOptionsReal("-snes_stol","Stop if step length less than","SNESSetTolerances",snes->stol,&snes->stol,NULL);CHKERRQ(ierr); ierr = PetscOptionsReal("-snes_atol","Stop if function norm less than","SNESSetTolerances",snes->abstol,&snes->abstol,NULL);CHKERRQ(ierr); ierr = PetscOptionsReal("-snes_rtol","Stop if decrease in function norm less than","SNESSetTolerances",snes->rtol,&snes->rtol,NULL);CHKERRQ(ierr); ierr = PetscOptionsReal("-snes_divergence_tolerance","Stop if residual norm increases by this factor","SNESSetDivergenceTolerance",snes->divtol,&snes->divtol,NULL);CHKERRQ(ierr); ierr = PetscOptionsInt("-snes_max_it","Maximum iterations","SNESSetTolerances",snes->max_its,&snes->max_its,NULL);CHKERRQ(ierr); ierr = PetscOptionsInt("-snes_max_funcs","Maximum function evaluations","SNESSetTolerances",snes->max_funcs,&snes->max_funcs,NULL);CHKERRQ(ierr); ierr = PetscOptionsInt("-snes_max_fail","Maximum nonlinear step failures","SNESSetMaxNonlinearStepFailures",snes->maxFailures,&snes->maxFailures,NULL);CHKERRQ(ierr); ierr = PetscOptionsInt("-snes_max_linear_solve_fail","Maximum failures in linear solves allowed","SNESSetMaxLinearSolveFailures",snes->maxLinearSolveFailures,&snes->maxLinearSolveFailures,NULL);CHKERRQ(ierr); ierr = PetscOptionsBool("-snes_error_if_not_converged","Generate error if solver does not converge","SNESSetErrorIfNotConverged",snes->errorifnotconverged,&snes->errorifnotconverged,NULL);CHKERRQ(ierr); ierr = PetscOptionsBool("-snes_force_iteration","Force SNESSolve() to take at least one iteration","SNESSetForceIteration",snes->forceiteration,&snes->forceiteration,NULL);CHKERRQ(ierr); ierr = PetscOptionsBool("-snes_check_jacobian_domain_error","Check Jacobian domain error after Jacobian evaluation","SNESCheckJacobianDomainError",snes->checkjacdomainerror,&snes->checkjacdomainerror,NULL);CHKERRQ(ierr); ierr = PetscOptionsInt("-snes_lag_preconditioner","How often to rebuild preconditioner","SNESSetLagPreconditioner",snes->lagpreconditioner,&lag,&flg);CHKERRQ(ierr); if (flg) { ierr = SNESSetLagPreconditioner(snes,lag);CHKERRQ(ierr); } ierr = PetscOptionsBool("-snes_lag_preconditioner_persists","Preconditioner lagging through multiple solves","SNESSetLagPreconditionerPersists",snes->lagjac_persist,&persist,&flg);CHKERRQ(ierr); if (flg) { ierr = SNESSetLagPreconditionerPersists(snes,persist);CHKERRQ(ierr); } ierr = PetscOptionsInt("-snes_lag_jacobian","How often to rebuild Jacobian","SNESSetLagJacobian",snes->lagjacobian,&lag,&flg);CHKERRQ(ierr); if (flg) { ierr = SNESSetLagJacobian(snes,lag);CHKERRQ(ierr); } ierr = PetscOptionsBool("-snes_lag_jacobian_persists","Jacobian lagging through multiple solves","SNESSetLagJacobianPersists",snes->lagjac_persist,&persist,&flg);CHKERRQ(ierr); if (flg) { ierr = SNESSetLagJacobianPersists(snes,persist);CHKERRQ(ierr); } ierr = PetscOptionsInt("-snes_grid_sequence","Use grid sequencing to generate initial guess","SNESSetGridSequence",snes->gridsequence,&grids,&flg);CHKERRQ(ierr); if (flg) { ierr = SNESSetGridSequence(snes,grids);CHKERRQ(ierr); } ierr = PetscOptionsEList("-snes_convergence_test","Convergence test","SNESSetConvergenceTest",convtests,2,"default",&indx,&flg);CHKERRQ(ierr); if (flg) { switch (indx) { case 0: ierr = SNESSetConvergenceTest(snes,SNESConvergedDefault,NULL,NULL);CHKERRQ(ierr); break; case 1: ierr = SNESSetConvergenceTest(snes,SNESConvergedSkip,NULL,NULL);CHKERRQ(ierr); break; } } ierr = PetscOptionsEList("-snes_norm_schedule","SNES Norm schedule","SNESSetNormSchedule",SNESNormSchedules,5,"function",&indx,&flg);CHKERRQ(ierr); if (flg) { ierr = SNESSetNormSchedule(snes,(SNESNormSchedule)indx);CHKERRQ(ierr); } ierr = PetscOptionsEList("-snes_function_type","SNES Norm schedule","SNESSetFunctionType",SNESFunctionTypes,2,"unpreconditioned",&indx,&flg);CHKERRQ(ierr); if (flg) { ierr = SNESSetFunctionType(snes,(SNESFunctionType)indx);CHKERRQ(ierr); } kctx = (SNESKSPEW*)snes->kspconvctx; ierr = PetscOptionsBool("-snes_ksp_ew","Use Eisentat-Walker linear system convergence test","SNESKSPSetUseEW",snes->ksp_ewconv,&snes->ksp_ewconv,NULL);CHKERRQ(ierr); ierr = PetscOptionsInt("-snes_ksp_ew_version","Version 1, 2 or 3","SNESKSPSetParametersEW",kctx->version,&kctx->version,NULL);CHKERRQ(ierr); ierr = PetscOptionsReal("-snes_ksp_ew_rtol0","0 <= rtol0 < 1","SNESKSPSetParametersEW",kctx->rtol_0,&kctx->rtol_0,NULL);CHKERRQ(ierr); ierr = PetscOptionsReal("-snes_ksp_ew_rtolmax","0 <= rtolmax < 1","SNESKSPSetParametersEW",kctx->rtol_max,&kctx->rtol_max,NULL);CHKERRQ(ierr); ierr = PetscOptionsReal("-snes_ksp_ew_gamma","0 <= gamma <= 1","SNESKSPSetParametersEW",kctx->gamma,&kctx->gamma,NULL);CHKERRQ(ierr); ierr = PetscOptionsReal("-snes_ksp_ew_alpha","1 < alpha <= 2","SNESKSPSetParametersEW",kctx->alpha,&kctx->alpha,NULL);CHKERRQ(ierr); ierr = PetscOptionsReal("-snes_ksp_ew_alpha2","alpha2","SNESKSPSetParametersEW",kctx->alpha2,&kctx->alpha2,NULL);CHKERRQ(ierr); ierr = PetscOptionsReal("-snes_ksp_ew_threshold","0 < threshold < 1","SNESKSPSetParametersEW",kctx->threshold,&kctx->threshold,NULL);CHKERRQ(ierr); flg = PETSC_FALSE; ierr = PetscOptionsBool("-snes_monitor_cancel","Remove all monitors","SNESMonitorCancel",flg,&flg,&set);CHKERRQ(ierr); if (set && flg) {ierr = SNESMonitorCancel(snes);CHKERRQ(ierr);} ierr = SNESMonitorSetFromOptions(snes,"-snes_monitor","Monitor norm of function","SNESMonitorDefault",SNESMonitorDefault,NULL);CHKERRQ(ierr); ierr = SNESMonitorSetFromOptions(snes,"-snes_monitor_short","Monitor norm of function with fewer digits","SNESMonitorDefaultShort",SNESMonitorDefaultShort,NULL);CHKERRQ(ierr); ierr = SNESMonitorSetFromOptions(snes,"-snes_monitor_range","Monitor range of elements of function","SNESMonitorRange",SNESMonitorRange,NULL);CHKERRQ(ierr); ierr = SNESMonitorSetFromOptions(snes,"-snes_monitor_ratio","Monitor ratios of the norm of function for consecutive steps","SNESMonitorRatio",SNESMonitorRatio,SNESMonitorRatioSetUp);CHKERRQ(ierr); ierr = SNESMonitorSetFromOptions(snes,"-snes_monitor_field","Monitor norm of function (split into fields)","SNESMonitorDefaultField",SNESMonitorDefaultField,NULL);CHKERRQ(ierr); ierr = SNESMonitorSetFromOptions(snes,"-snes_monitor_solution","View solution at each iteration","SNESMonitorSolution",SNESMonitorSolution,NULL);CHKERRQ(ierr); ierr = SNESMonitorSetFromOptions(snes,"-snes_monitor_solution_update","View correction at each iteration","SNESMonitorSolutionUpdate",SNESMonitorSolutionUpdate,NULL);CHKERRQ(ierr); ierr = SNESMonitorSetFromOptions(snes,"-snes_monitor_residual","View residual at each iteration","SNESMonitorResidual",SNESMonitorResidual,NULL);CHKERRQ(ierr); ierr = SNESMonitorSetFromOptions(snes,"-snes_monitor_jacupdate_spectrum","Print the change in the spectrum of the Jacobian","SNESMonitorJacUpdateSpectrum",SNESMonitorJacUpdateSpectrum,NULL);CHKERRQ(ierr); ierr = SNESMonitorSetFromOptions(snes,"-snes_monitor_fields","Monitor norm of function per field","SNESMonitorSet",SNESMonitorFields,NULL);CHKERRQ(ierr); ierr = PetscOptionsString("-snes_monitor_python","Use Python function","SNESMonitorSet",0,monfilename,PETSC_MAX_PATH_LEN,&flg);CHKERRQ(ierr); if (flg) {ierr = PetscPythonMonitorSet((PetscObject)snes,monfilename);CHKERRQ(ierr);} flg = PETSC_FALSE; ierr = PetscOptionsBool("-snes_monitor_lg_residualnorm","Plot function norm at each iteration","SNESMonitorLGResidualNorm",flg,&flg,NULL);CHKERRQ(ierr); if (flg) { PetscDrawLG ctx; ierr = SNESMonitorLGCreate(PetscObjectComm((PetscObject)snes),NULL,NULL,PETSC_DECIDE,PETSC_DECIDE,400,300,&ctx);CHKERRQ(ierr); ierr = SNESMonitorSet(snes,SNESMonitorLGResidualNorm,ctx,(PetscErrorCode (*)(void**))PetscDrawLGDestroy);CHKERRQ(ierr); } flg = PETSC_FALSE; ierr = PetscOptionsBool("-snes_monitor_lg_range","Plot function range at each iteration","SNESMonitorLGRange",flg,&flg,NULL);CHKERRQ(ierr); if (flg) { PetscViewer ctx; ierr = PetscViewerDrawOpen(PetscObjectComm((PetscObject)snes),NULL,NULL,PETSC_DECIDE,PETSC_DECIDE,400,300,&ctx);CHKERRQ(ierr); ierr = SNESMonitorSet(snes,SNESMonitorLGRange,ctx,(PetscErrorCode (*)(void**))PetscViewerDestroy);CHKERRQ(ierr); } flg = PETSC_FALSE; ierr = PetscOptionsBool("-snes_fd","Use finite differences (slow) to compute Jacobian","SNESComputeJacobianDefault",flg,&flg,NULL);CHKERRQ(ierr); if (flg) { void *functx; DM dm; DMSNES sdm; ierr = SNESGetDM(snes,&dm);CHKERRQ(ierr); ierr = DMGetDMSNES(dm,&sdm);CHKERRQ(ierr); sdm->jacobianctx = NULL; ierr = SNESGetFunction(snes,NULL,NULL,&functx);CHKERRQ(ierr); ierr = SNESSetJacobian(snes,snes->jacobian,snes->jacobian_pre,SNESComputeJacobianDefault,functx);CHKERRQ(ierr); ierr = PetscInfo(snes,"Setting default finite difference Jacobian matrix\n");CHKERRQ(ierr); } flg = PETSC_FALSE; ierr = PetscOptionsBool("-snes_fd_function","Use finite differences (slow) to compute function from user objective","SNESObjectiveComputeFunctionDefaultFD",flg,&flg,NULL);CHKERRQ(ierr); if (flg) { ierr = SNESSetFunction(snes,NULL,SNESObjectiveComputeFunctionDefaultFD,NULL);CHKERRQ(ierr); } flg = PETSC_FALSE; ierr = PetscOptionsBool("-snes_fd_color","Use finite differences with coloring to compute Jacobian","SNESComputeJacobianDefaultColor",flg,&flg,NULL);CHKERRQ(ierr); if (flg) { DM dm; DMSNES sdm; ierr = SNESGetDM(snes,&dm);CHKERRQ(ierr); ierr = DMGetDMSNES(dm,&sdm);CHKERRQ(ierr); sdm->jacobianctx = NULL; ierr = SNESSetJacobian(snes,snes->jacobian,snes->jacobian_pre,SNESComputeJacobianDefaultColor,0);CHKERRQ(ierr); ierr = PetscInfo(snes,"Setting default finite difference coloring Jacobian matrix\n");CHKERRQ(ierr); } flg = PETSC_FALSE; ierr = PetscOptionsBool("-snes_mf_operator","Use a Matrix-Free Jacobian with user-provided preconditioner matrix","SNESSetUseMatrixFree",PETSC_FALSE,&snes->mf_operator,&flg);CHKERRQ(ierr); if (flg && snes->mf_operator) { snes->mf_operator = PETSC_TRUE; snes->mf = PETSC_TRUE; } flg = PETSC_FALSE; ierr = PetscOptionsBool("-snes_mf","Use a Matrix-Free Jacobian with no preconditioner matrix","SNESSetUseMatrixFree",PETSC_FALSE,&snes->mf,&flg);CHKERRQ(ierr); if (!flg && snes->mf_operator) snes->mf = PETSC_TRUE; ierr = PetscOptionsInt("-snes_mf_version","Matrix-Free routines version 1 or 2","None",snes->mf_version,&snes->mf_version,0);CHKERRQ(ierr); flg = PETSC_FALSE; ierr = SNESGetNPCSide(snes,&pcside);CHKERRQ(ierr); ierr = PetscOptionsEnum("-snes_npc_side","SNES nonlinear preconditioner side","SNESSetNPCSide",PCSides,(PetscEnum)pcside,(PetscEnum*)&pcside,&flg);CHKERRQ(ierr); if (flg) {ierr = SNESSetNPCSide(snes,pcside);CHKERRQ(ierr);} #if defined(PETSC_HAVE_SAWS) /* Publish convergence information using SAWs */ flg = PETSC_FALSE; ierr = PetscOptionsBool("-snes_monitor_saws","Publish SNES progress using SAWs","SNESMonitorSet",flg,&flg,NULL);CHKERRQ(ierr); if (flg) { void *ctx; ierr = SNESMonitorSAWsCreate(snes,&ctx);CHKERRQ(ierr); ierr = SNESMonitorSet(snes,SNESMonitorSAWs,ctx,SNESMonitorSAWsDestroy);CHKERRQ(ierr); } #endif #if defined(PETSC_HAVE_SAWS) { PetscBool set; flg = PETSC_FALSE; ierr = PetscOptionsBool("-snes_saws_block","Block for SAWs at end of SNESSolve","PetscObjectSAWsBlock",((PetscObject)snes)->amspublishblock,&flg,&set);CHKERRQ(ierr); if (set) { ierr = PetscObjectSAWsSetBlock((PetscObject)snes,flg);CHKERRQ(ierr); } } #endif for (i = 0; i < numberofsetfromoptions; i++) { ierr = (*othersetfromoptions[i])(snes);CHKERRQ(ierr); } if (snes->ops->setfromoptions) { ierr = (*snes->ops->setfromoptions)(PetscOptionsObject,snes);CHKERRQ(ierr); } /* process any options handlers added with PetscObjectAddOptionsHandler() */ ierr = PetscObjectProcessOptionsHandlers(PetscOptionsObject,(PetscObject)snes);CHKERRQ(ierr); ierr = PetscOptionsEnd();CHKERRQ(ierr); if (snes->linesearch) { ierr = SNESGetLineSearch(snes, &snes->linesearch);CHKERRQ(ierr); ierr = SNESLineSearchSetFromOptions(snes->linesearch);CHKERRQ(ierr); } if (snes->usesksp) { if (!snes->ksp) {ierr = SNESGetKSP(snes,&snes->ksp);CHKERRQ(ierr);} ierr = KSPSetOperators(snes->ksp,snes->jacobian,snes->jacobian_pre);CHKERRQ(ierr); ierr = KSPSetFromOptions(snes->ksp);CHKERRQ(ierr); } /* if user has set the SNES NPC type via options database, create it. */ ierr = SNESGetOptionsPrefix(snes, &optionsprefix);CHKERRQ(ierr); ierr = PetscOptionsHasName(((PetscObject)snes)->options,optionsprefix, "-npc_snes_type", &pcset);CHKERRQ(ierr); if (pcset && (!snes->npc)) { ierr = SNESGetNPC(snes, &snes->npc);CHKERRQ(ierr); } if (snes->npc) { ierr = SNESSetFromOptions(snes->npc);CHKERRQ(ierr); } snes->setfromoptionscalled++; PetscFunctionReturn(0); } /*@ SNESResetFromOptions - Sets various SNES and KSP parameters from user options ONLY if the SNES was previously set from options Collective on SNES Input Parameter: . snes - the SNES context Level: beginner .seealso: SNESSetFromOptions(), SNESSetOptionsPrefix() @*/ PetscErrorCode SNESResetFromOptions(SNES snes) { PetscErrorCode ierr; PetscFunctionBegin; if (snes->setfromoptionscalled) {ierr = SNESSetFromOptions(snes);CHKERRQ(ierr);} PetscFunctionReturn(0); } /*@C SNESSetComputeApplicationContext - Sets an optional function to compute a user-defined context for the nonlinear solvers. Logically Collective on SNES Input Parameters: + snes - the SNES context . compute - function to compute the context - destroy - function to destroy the context Level: intermediate Notes: This function is currently not available from Fortran. .seealso: SNESGetApplicationContext(), SNESSetComputeApplicationContext(), SNESGetApplicationContext() @*/ PetscErrorCode SNESSetComputeApplicationContext(SNES snes,PetscErrorCode (*compute)(SNES,void**),PetscErrorCode (*destroy)(void**)) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); snes->ops->usercompute = compute; snes->ops->userdestroy = destroy; PetscFunctionReturn(0); } /*@ SNESSetApplicationContext - Sets the optional user-defined context for the nonlinear solvers. Logically Collective on SNES Input Parameters: + snes - the SNES context - usrP - optional user context Level: intermediate Fortran Notes: To use this from Fortran you must write a Fortran interface definition for this function that tells Fortran the Fortran derived data type that you are passing in as the ctx argument. .seealso: SNESGetApplicationContext() @*/ PetscErrorCode SNESSetApplicationContext(SNES snes,void *usrP) { PetscErrorCode ierr; KSP ksp; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); ierr = SNESGetKSP(snes,&ksp);CHKERRQ(ierr); ierr = KSPSetApplicationContext(ksp,usrP);CHKERRQ(ierr); snes->user = usrP; PetscFunctionReturn(0); } /*@ SNESGetApplicationContext - Gets the user-defined context for the nonlinear solvers. Not Collective Input Parameter: . snes - SNES context Output Parameter: . usrP - user context Fortran Notes: To use this from Fortran you must write a Fortran interface definition for this function that tells Fortran the Fortran derived data type that you are passing in as the ctx argument. Level: intermediate .seealso: SNESSetApplicationContext() @*/ PetscErrorCode SNESGetApplicationContext(SNES snes,void *usrP) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); *(void**)usrP = snes->user; PetscFunctionReturn(0); } /*@ SNESSetUseMatrixFree - indicates that SNES should use matrix free finite difference matrix vector products internally to apply the Jacobian. Collective on SNES Input Parameters: + snes - SNES context . mf - use matrix-free for both the Amat and Pmat used by SNESSetJacobian(), both the Amat and Pmat set in SNESSetJacobian() will be ignored - mf_operator - use matrix-free only for the Amat used by SNESSetJacobian(), this means the user provided Pmat will continue to be used Options Database: + -snes_mf - use matrix free for both the mat and pmat operator - -snes_mf_operator - use matrix free only for the mat operator Level: intermediate .seealso: SNESGetUseMatrixFree(), MatCreateSNESMF() @*/ PetscErrorCode SNESSetUseMatrixFree(SNES snes,PetscBool mf_operator,PetscBool mf) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidLogicalCollectiveBool(snes,mf_operator,2); PetscValidLogicalCollectiveBool(snes,mf,3); if (mf && !mf_operator) SETERRQ(PetscObjectComm((PetscObject)snes),PETSC_ERR_ARG_INCOMP,"If using mf must also use mf_operator"); snes->mf = mf; snes->mf_operator = mf_operator; PetscFunctionReturn(0); } /*@ SNESGetUseMatrixFree - indicates if the SNES uses matrix free finite difference matrix vector products to apply the Jacobian. Collective on SNES Input Parameter: . snes - SNES context Output Parameters: + mf - use matrix-free for both the Amat and Pmat used by SNESSetJacobian(), both the Amat and Pmat set in SNESSetJacobian() will be ignored - mf_operator - use matrix-free only for the Amat used by SNESSetJacobian(), this means the user provided Pmat will continue to be used Options Database: + -snes_mf - use matrix free for both the mat and pmat operator - -snes_mf_operator - use matrix free only for the mat operator Level: intermediate .seealso: SNESSetUseMatrixFree(), MatCreateSNESMF() @*/ PetscErrorCode SNESGetUseMatrixFree(SNES snes,PetscBool *mf_operator,PetscBool *mf) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); if (mf) *mf = snes->mf; if (mf_operator) *mf_operator = snes->mf_operator; PetscFunctionReturn(0); } /*@ SNESGetIterationNumber - Gets the number of nonlinear iterations completed at this time. Not Collective Input Parameter: . snes - SNES context Output Parameter: . iter - iteration number Notes: For example, during the computation of iteration 2 this would return 1. This is useful for using lagged Jacobians (where one does not recompute the Jacobian at each SNES iteration). For example, the code .vb ierr = SNESGetIterationNumber(snes,&it); if (!(it % 2)) { [compute Jacobian here] } .ve can be used in your ComputeJacobian() function to cause the Jacobian to be recomputed every second SNES iteration. After the SNES solve is complete this will return the number of nonlinear iterations used. Level: intermediate .seealso: SNESGetLinearSolveIterations() @*/ PetscErrorCode SNESGetIterationNumber(SNES snes,PetscInt *iter) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidIntPointer(iter,2); *iter = snes->iter; PetscFunctionReturn(0); } /*@ SNESSetIterationNumber - Sets the current iteration number. Not Collective Input Parameter: + snes - SNES context - iter - iteration number Level: developer .seealso: SNESGetLinearSolveIterations() @*/ PetscErrorCode SNESSetIterationNumber(SNES snes,PetscInt iter) { PetscErrorCode ierr; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); ierr = PetscObjectSAWsTakeAccess((PetscObject)snes);CHKERRQ(ierr); snes->iter = iter; ierr = PetscObjectSAWsGrantAccess((PetscObject)snes);CHKERRQ(ierr); PetscFunctionReturn(0); } /*@ SNESGetNonlinearStepFailures - Gets the number of unsuccessful steps attempted by the nonlinear solver. Not Collective Input Parameter: . snes - SNES context Output Parameter: . nfails - number of unsuccessful steps attempted Notes: This counter is reset to zero for each successive call to SNESSolve(). Level: intermediate .seealso: SNESGetMaxLinearSolveFailures(), SNESGetLinearSolveIterations(), SNESSetMaxLinearSolveFailures(), SNESGetLinearSolveFailures(), SNESSetMaxNonlinearStepFailures(), SNESGetMaxNonlinearStepFailures() @*/ PetscErrorCode SNESGetNonlinearStepFailures(SNES snes,PetscInt *nfails) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidIntPointer(nfails,2); *nfails = snes->numFailures; PetscFunctionReturn(0); } /*@ SNESSetMaxNonlinearStepFailures - Sets the maximum number of unsuccessful steps attempted by the nonlinear solver before it gives up. Not Collective Input Parameters: + snes - SNES context - maxFails - maximum of unsuccessful steps Level: intermediate .seealso: SNESGetMaxLinearSolveFailures(), SNESGetLinearSolveIterations(), SNESSetMaxLinearSolveFailures(), SNESGetLinearSolveFailures(), SNESGetMaxNonlinearStepFailures(), SNESGetNonlinearStepFailures() @*/ PetscErrorCode SNESSetMaxNonlinearStepFailures(SNES snes, PetscInt maxFails) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); snes->maxFailures = maxFails; PetscFunctionReturn(0); } /*@ SNESGetMaxNonlinearStepFailures - Gets the maximum number of unsuccessful steps attempted by the nonlinear solver before it gives up. Not Collective Input Parameter: . snes - SNES context Output Parameter: . maxFails - maximum of unsuccessful steps Level: intermediate .seealso: SNESGetMaxLinearSolveFailures(), SNESGetLinearSolveIterations(), SNESSetMaxLinearSolveFailures(), SNESGetLinearSolveFailures(), SNESSetMaxNonlinearStepFailures(), SNESGetNonlinearStepFailures() @*/ PetscErrorCode SNESGetMaxNonlinearStepFailures(SNES snes, PetscInt *maxFails) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidIntPointer(maxFails,2); *maxFails = snes->maxFailures; PetscFunctionReturn(0); } /*@ SNESGetNumberFunctionEvals - Gets the number of user provided function evaluations done by SNES. Not Collective Input Parameter: . snes - SNES context Output Parameter: . nfuncs - number of evaluations Level: intermediate Notes: Reset every time SNESSolve is called unless SNESSetCountersReset() is used. .seealso: SNESGetMaxLinearSolveFailures(), SNESGetLinearSolveIterations(), SNESSetMaxLinearSolveFailures(), SNESGetLinearSolveFailures(), SNESSetCountersReset() @*/ PetscErrorCode SNESGetNumberFunctionEvals(SNES snes, PetscInt *nfuncs) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidIntPointer(nfuncs,2); *nfuncs = snes->nfuncs; PetscFunctionReturn(0); } /*@ SNESGetLinearSolveFailures - Gets the number of failed (non-converged) linear solvers. Not Collective Input Parameter: . snes - SNES context Output Parameter: . nfails - number of failed solves Level: intermediate Options Database Keys: . -snes_max_linear_solve_fail - The number of failures before the solve is terminated Notes: This counter is reset to zero for each successive call to SNESSolve(). .seealso: SNESGetMaxLinearSolveFailures(), SNESGetLinearSolveIterations(), SNESSetMaxLinearSolveFailures() @*/ PetscErrorCode SNESGetLinearSolveFailures(SNES snes,PetscInt *nfails) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidIntPointer(nfails,2); *nfails = snes->numLinearSolveFailures; PetscFunctionReturn(0); } /*@ SNESSetMaxLinearSolveFailures - the number of failed linear solve attempts allowed before SNES returns with a diverged reason of SNES_DIVERGED_LINEAR_SOLVE Logically Collective on SNES Input Parameters: + snes - SNES context - maxFails - maximum allowed linear solve failures Level: intermediate Options Database Keys: . -snes_max_linear_solve_fail - The number of failures before the solve is terminated Notes: By default this is 0; that is SNES returns on the first failed linear solve .seealso: SNESGetLinearSolveFailures(), SNESGetMaxLinearSolveFailures(), SNESGetLinearSolveIterations() @*/ PetscErrorCode SNESSetMaxLinearSolveFailures(SNES snes, PetscInt maxFails) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidLogicalCollectiveInt(snes,maxFails,2); snes->maxLinearSolveFailures = maxFails; PetscFunctionReturn(0); } /*@ SNESGetMaxLinearSolveFailures - gets the maximum number of linear solve failures that are allowed before SNES terminates Not Collective Input Parameter: . snes - SNES context Output Parameter: . maxFails - maximum of unsuccessful solves allowed Level: intermediate Notes: By default this is 1; that is SNES returns on the first failed linear solve .seealso: SNESGetLinearSolveFailures(), SNESGetLinearSolveIterations(), SNESSetMaxLinearSolveFailures(), @*/ PetscErrorCode SNESGetMaxLinearSolveFailures(SNES snes, PetscInt *maxFails) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidIntPointer(maxFails,2); *maxFails = snes->maxLinearSolveFailures; PetscFunctionReturn(0); } /*@ SNESGetLinearSolveIterations - Gets the total number of linear iterations used by the nonlinear solver. Not Collective Input Parameter: . snes - SNES context Output Parameter: . lits - number of linear iterations Notes: This counter is reset to zero for each successive call to SNESSolve() unless SNESSetCountersReset() is used. If the linear solver fails inside the SNESSolve() the iterations for that call to the linear solver are not included. If you wish to count them then call KSPGetIterationNumber() after the failed solve. Level: intermediate .seealso: SNESGetIterationNumber(), SNESGetLinearSolveFailures(), SNESGetMaxLinearSolveFailures(), SNESSetCountersReset() @*/ PetscErrorCode SNESGetLinearSolveIterations(SNES snes,PetscInt *lits) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidIntPointer(lits,2); *lits = snes->linear_its; PetscFunctionReturn(0); } /*@ SNESSetCountersReset - Sets whether or not the counters for linear iterations and function evaluations are reset every time SNESSolve() is called. Logically Collective on SNES Input Parameter: + snes - SNES context - reset - whether to reset the counters or not Notes: This defaults to PETSC_TRUE Level: developer .seealso: SNESGetNumberFunctionEvals(), SNESGetLinearSolveIterations(), SNESGetNPC() @*/ PetscErrorCode SNESSetCountersReset(SNES snes,PetscBool reset) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidLogicalCollectiveBool(snes,reset,2); snes->counters_reset = reset; PetscFunctionReturn(0); } /*@ SNESSetKSP - Sets a KSP context for the SNES object to use Not Collective, but the SNES and KSP objects must live on the same MPI_Comm Input Parameters: + snes - the SNES context - ksp - the KSP context Notes: The SNES object already has its KSP object, you can obtain with SNESGetKSP() so this routine is rarely needed. The KSP object that is already in the SNES object has its reference count decreased by one. Level: developer .seealso: KSPGetPC(), SNESCreate(), KSPCreate(), SNESSetKSP() @*/ PetscErrorCode SNESSetKSP(SNES snes,KSP ksp) { PetscErrorCode ierr; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidHeaderSpecific(ksp,KSP_CLASSID,2); PetscCheckSameComm(snes,1,ksp,2); ierr = PetscObjectReference((PetscObject)ksp);CHKERRQ(ierr); if (snes->ksp) {ierr = PetscObjectDereference((PetscObject)snes->ksp);CHKERRQ(ierr);} snes->ksp = ksp; PetscFunctionReturn(0); } /* -----------------------------------------------------------*/ /*@ SNESCreate - Creates a nonlinear solver context. Collective Input Parameters: . comm - MPI communicator Output Parameter: . outsnes - the new SNES context Options Database Keys: + -snes_mf - Activates default matrix-free Jacobian-vector products, and no preconditioning matrix . -snes_mf_operator - Activates default matrix-free Jacobian-vector products, and a user-provided preconditioning matrix as set by SNESSetJacobian() - -snes_fd - Uses (slow!) finite differences to compute Jacobian Level: beginner Developer Notes: SNES always creates a KSP object even though many SNES methods do not use it. This is unfortunate and should be fixed at some point. The flag snes->usesksp indicates if the particular method does use KSP and regulates if the information about the KSP is printed in SNESView(). TSSetFromOptions() does call SNESSetFromOptions() which can lead to users being confused by help messages about meaningless SNES options. SNES always creates the snes->kspconvctx even though it is used by only one type. This should be fixed. .seealso: SNESSolve(), SNESDestroy(), SNES, SNESSetLagPreconditioner() @*/ PetscErrorCode SNESCreate(MPI_Comm comm,SNES *outsnes) { PetscErrorCode ierr; SNES snes; SNESKSPEW *kctx; PetscFunctionBegin; PetscValidPointer(outsnes,2); *outsnes = NULL; ierr = SNESInitializePackage();CHKERRQ(ierr); ierr = PetscHeaderCreate(snes,SNES_CLASSID,"SNES","Nonlinear solver","SNES",comm,SNESDestroy,SNESView);CHKERRQ(ierr); snes->ops->converged = SNESConvergedDefault; snes->usesksp = PETSC_TRUE; snes->tolerancesset = PETSC_FALSE; snes->max_its = 50; snes->max_funcs = 10000; snes->norm = 0.0; snes->xnorm = 0.0; snes->ynorm = 0.0; snes->normschedule = SNES_NORM_ALWAYS; snes->functype = SNES_FUNCTION_DEFAULT; #if defined(PETSC_USE_REAL_SINGLE) snes->rtol = 1.e-5; #else snes->rtol = 1.e-8; #endif snes->ttol = 0.0; #if defined(PETSC_USE_REAL_SINGLE) snes->abstol = 1.e-25; #else snes->abstol = 1.e-50; #endif #if defined(PETSC_USE_REAL_SINGLE) snes->stol = 1.e-5; #else snes->stol = 1.e-8; #endif #if defined(PETSC_USE_REAL_SINGLE) snes->deltatol = 1.e-6; #else snes->deltatol = 1.e-12; #endif snes->divtol = 1.e4; snes->rnorm0 = 0; snes->nfuncs = 0; snes->numFailures = 0; snes->maxFailures = 1; snes->linear_its = 0; snes->lagjacobian = 1; snes->jac_iter = 0; snes->lagjac_persist = PETSC_FALSE; snes->lagpreconditioner = 1; snes->pre_iter = 0; snes->lagpre_persist = PETSC_FALSE; snes->numbermonitors = 0; snes->data = 0; snes->setupcalled = PETSC_FALSE; snes->ksp_ewconv = PETSC_FALSE; snes->nwork = 0; snes->work = 0; snes->nvwork = 0; snes->vwork = 0; snes->conv_hist_len = 0; snes->conv_hist_max = 0; snes->conv_hist = NULL; snes->conv_hist_its = NULL; snes->conv_hist_reset = PETSC_TRUE; snes->counters_reset = PETSC_TRUE; snes->vec_func_init_set = PETSC_FALSE; snes->reason = SNES_CONVERGED_ITERATING; snes->npcside = PC_RIGHT; snes->setfromoptionscalled = 0; snes->mf = PETSC_FALSE; snes->mf_operator = PETSC_FALSE; snes->mf_version = 1; snes->numLinearSolveFailures = 0; snes->maxLinearSolveFailures = 1; snes->vizerotolerance = 1.e-8; #if defined(PETSC_USE_DEBUG) snes->checkjacdomainerror = PETSC_TRUE; #else snes->checkjacdomainerror = PETSC_FALSE; #endif /* Set this to true if the implementation of SNESSolve_XXX does compute the residual at the final solution. */ snes->alwayscomputesfinalresidual = PETSC_FALSE; /* Create context to compute Eisenstat-Walker relative tolerance for KSP */ ierr = PetscNewLog(snes,&kctx);CHKERRQ(ierr); snes->kspconvctx = (void*)kctx; kctx->version = 2; kctx->rtol_0 = .3; /* Eisenstat and Walker suggest rtol_0=.5, but this was too large for some test cases */ kctx->rtol_last = 0.0; kctx->rtol_max = .9; kctx->gamma = 1.0; kctx->alpha = .5*(1.0 + PetscSqrtReal(5.0)); kctx->alpha2 = kctx->alpha; kctx->threshold = .1; kctx->lresid_last = 0.0; kctx->norm_last = 0.0; *outsnes = snes; PetscFunctionReturn(0); } /*MC SNESFunction - Functional form used to convey the nonlinear function to be solved by SNES Synopsis: #include "petscsnes.h" PetscErrorCode SNESFunction(SNES snes,Vec x,Vec f,void *ctx); Input Parameters: + snes - the SNES context . x - state at which to evaluate residual - ctx - optional user-defined function context, passed in with SNESSetFunction() Output Parameter: . f - vector to put residual (function value) Level: intermediate .seealso: SNESSetFunction(), SNESGetFunction() M*/ /*@C SNESSetFunction - Sets the function evaluation routine and function vector for use by the SNES routines in solving systems of nonlinear equations. Logically Collective on SNES Input Parameters: + snes - the SNES context . r - vector to store function value . f - function evaluation routine; see SNESFunction for calling sequence details - ctx - [optional] user-defined context for private data for the function evaluation routine (may be NULL) Notes: The Newton-like methods typically solve linear systems of the form $ f'(x) x = -f(x), where f'(x) denotes the Jacobian matrix and f(x) is the function. Level: beginner .seealso: SNESGetFunction(), SNESComputeFunction(), SNESSetJacobian(), SNESSetPicard(), SNESFunction @*/ PetscErrorCode SNESSetFunction(SNES snes,Vec r,PetscErrorCode (*f)(SNES,Vec,Vec,void*),void *ctx) { PetscErrorCode ierr; DM dm; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); if (r) { PetscValidHeaderSpecific(r,VEC_CLASSID,2); PetscCheckSameComm(snes,1,r,2); ierr = PetscObjectReference((PetscObject)r);CHKERRQ(ierr); ierr = VecDestroy(&snes->vec_func);CHKERRQ(ierr); snes->vec_func = r; } ierr = SNESGetDM(snes,&dm);CHKERRQ(ierr); ierr = DMSNESSetFunction(dm,f,ctx);CHKERRQ(ierr); PetscFunctionReturn(0); } /*@C SNESSetInitialFunction - Sets the function vector to be used as the function norm at the initialization of the method. In some instances, the user has precomputed the function before calling SNESSolve. This function allows one to avoid a redundant call to SNESComputeFunction in that case. Logically Collective on SNES Input Parameters: + snes - the SNES context - f - vector to store function value Notes: This should not be modified during the solution procedure. This is used extensively in the SNESFAS hierarchy and in nonlinear preconditioning. Level: developer .seealso: SNESSetFunction(), SNESComputeFunction(), SNESSetInitialFunctionNorm() @*/ PetscErrorCode SNESSetInitialFunction(SNES snes, Vec f) { PetscErrorCode ierr; Vec vec_func; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidHeaderSpecific(f,VEC_CLASSID,2); PetscCheckSameComm(snes,1,f,2); if (snes->npcside== PC_LEFT && snes->functype == SNES_FUNCTION_PRECONDITIONED) { snes->vec_func_init_set = PETSC_FALSE; PetscFunctionReturn(0); } ierr = SNESGetFunction(snes,&vec_func,NULL,NULL);CHKERRQ(ierr); ierr = VecCopy(f, vec_func);CHKERRQ(ierr); snes->vec_func_init_set = PETSC_TRUE; PetscFunctionReturn(0); } /*@ SNESSetNormSchedule - Sets the SNESNormSchedule used in covergence and monitoring of the SNES method. Logically Collective on SNES Input Parameters: + snes - the SNES context - normschedule - the frequency of norm computation Options Database Key: . -snes_norm_schedule Notes: Only certain SNES methods support certain SNESNormSchedules. Most require evaluation of the nonlinear function and the taking of its norm at every iteration to even ensure convergence at all. However, methods such as custom Gauss-Seidel methods (SNESNGS) and the like do not require the norm of the function to be computed, and therfore may either be monitored for convergence or not. As these are often used as nonlinear preconditioners, monitoring the norm of their error is not a useful enterprise within their solution. Level: developer .seealso: SNESGetNormSchedule(), SNESComputeFunction(), VecNorm(), SNESSetFunction(), SNESSetInitialFunction(), SNESNormSchedule @*/ PetscErrorCode SNESSetNormSchedule(SNES snes, SNESNormSchedule normschedule) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); snes->normschedule = normschedule; PetscFunctionReturn(0); } /*@ SNESGetNormSchedule - Gets the SNESNormSchedule used in covergence and monitoring of the SNES method. Logically Collective on SNES Input Parameters: + snes - the SNES context - normschedule - the type of the norm used Level: advanced .seealso: SNESSetNormSchedule(), SNESComputeFunction(), VecNorm(), SNESSetFunction(), SNESSetInitialFunction(), SNESNormSchedule @*/ PetscErrorCode SNESGetNormSchedule(SNES snes, SNESNormSchedule *normschedule) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); *normschedule = snes->normschedule; PetscFunctionReturn(0); } /*@ SNESSetFunctionNorm - Sets the last computed residual norm. Logically Collective on SNES Input Parameters: + snes - the SNES context - normschedule - the frequency of norm computation Level: developer .seealso: SNESGetNormSchedule(), SNESComputeFunction(), VecNorm(), SNESSetFunction(), SNESSetInitialFunction(), SNESNormSchedule @*/ PetscErrorCode SNESSetFunctionNorm(SNES snes, PetscReal norm) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); snes->norm = norm; PetscFunctionReturn(0); } /*@ SNESGetFunctionNorm - Gets the last computed norm of the residual Not Collective Input Parameter: . snes - the SNES context Output Parameter: . norm - the last computed residual norm Level: developer .seealso: SNESSetNormSchedule(), SNESComputeFunction(), VecNorm(), SNESSetFunction(), SNESSetInitialFunction(), SNESNormSchedule @*/ PetscErrorCode SNESGetFunctionNorm(SNES snes, PetscReal *norm) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidPointer(norm, 2); *norm = snes->norm; PetscFunctionReturn(0); } /*@ SNESGetUpdateNorm - Gets the last computed norm of the Newton update Not Collective Input Parameter: . snes - the SNES context Output Parameter: . ynorm - the last computed update norm Level: developer .seealso: SNESSetNormSchedule(), SNESComputeFunction(), SNESGetFunctionNorm() @*/ PetscErrorCode SNESGetUpdateNorm(SNES snes, PetscReal *ynorm) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidPointer(ynorm, 2); *ynorm = snes->ynorm; PetscFunctionReturn(0); } /*@ SNESGetSolutionNorm - Gets the last computed norm of the solution Not Collective Input Parameter: . snes - the SNES context Output Parameter: . xnorm - the last computed solution norm Level: developer .seealso: SNESSetNormSchedule(), SNESComputeFunction(), SNESGetFunctionNorm(), SNESGetUpdateNorm() @*/ PetscErrorCode SNESGetSolutionNorm(SNES snes, PetscReal *xnorm) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidPointer(xnorm, 2); *xnorm = snes->xnorm; PetscFunctionReturn(0); } /*@C SNESSetFunctionType - Sets the SNESNormSchedule used in covergence and monitoring of the SNES method. Logically Collective on SNES Input Parameters: + snes - the SNES context - normschedule - the frequency of norm computation Notes: Only certain SNES methods support certain SNESNormSchedules. Most require evaluation of the nonlinear function and the taking of its norm at every iteration to even ensure convergence at all. However, methods such as custom Gauss-Seidel methods (SNESNGS) and the like do not require the norm of the function to be computed, and therfore may either be monitored for convergence or not. As these are often used as nonlinear preconditioners, monitoring the norm of their error is not a useful enterprise within their solution. Level: developer .seealso: SNESGetNormSchedule(), SNESComputeFunction(), VecNorm(), SNESSetFunction(), SNESSetInitialFunction(), SNESNormSchedule @*/ PetscErrorCode SNESSetFunctionType(SNES snes, SNESFunctionType type) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); snes->functype = type; PetscFunctionReturn(0); } /*@C SNESGetFunctionType - Gets the SNESNormSchedule used in covergence and monitoring of the SNES method. Logically Collective on SNES Input Parameters: + snes - the SNES context - normschedule - the type of the norm used Level: advanced .seealso: SNESSetNormSchedule(), SNESComputeFunction(), VecNorm(), SNESSetFunction(), SNESSetInitialFunction(), SNESNormSchedule @*/ PetscErrorCode SNESGetFunctionType(SNES snes, SNESFunctionType *type) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); *type = snes->functype; PetscFunctionReturn(0); } /*MC SNESNGSFunction - function used to convey a Gauss-Seidel sweep on the nonlinear function Synopsis: #include $ SNESNGSFunction(SNES snes,Vec x,Vec b,void *ctx); + X - solution vector . B - RHS vector - ctx - optional user-defined Gauss-Seidel context Level: intermediate .seealso: SNESSetNGS(), SNESGetNGS() M*/ /*@C SNESSetNGS - Sets the user nonlinear Gauss-Seidel routine for use with composed nonlinear solvers. Input Parameters: + snes - the SNES context . f - function evaluation routine to apply Gauss-Seidel see SNESNGSFunction - ctx - [optional] user-defined context for private data for the smoother evaluation routine (may be NULL) Notes: The NGS routines are used by the composed nonlinear solver to generate a problem appropriate update to the solution, particularly FAS. Level: intermediate .seealso: SNESGetFunction(), SNESComputeNGS() @*/ PetscErrorCode SNESSetNGS(SNES snes,PetscErrorCode (*f)(SNES,Vec,Vec,void*),void *ctx) { PetscErrorCode ierr; DM dm; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); ierr = SNESGetDM(snes,&dm);CHKERRQ(ierr); ierr = DMSNESSetNGS(dm,f,ctx);CHKERRQ(ierr); PetscFunctionReturn(0); } PetscErrorCode SNESPicardComputeFunction(SNES snes,Vec x,Vec f,void *ctx) { PetscErrorCode ierr; DM dm; DMSNES sdm; PetscFunctionBegin; ierr = SNESGetDM(snes,&dm);CHKERRQ(ierr); ierr = DMGetDMSNES(dm,&sdm);CHKERRQ(ierr); if (!sdm->ops->computepfunction) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_WRONGSTATE, "Must call SNESSetPicard() to provide Picard function."); if (!sdm->ops->computepjacobian) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_WRONGSTATE, "Must call SNESSetPicard() to provide Picard Jacobian."); /* A(x)*x - b(x) */ PetscStackPush("SNES Picard user function"); ierr = (*sdm->ops->computepfunction)(snes,x,f,sdm->pctx);CHKERRQ(ierr); PetscStackPop; PetscStackPush("SNES Picard user Jacobian"); ierr = (*sdm->ops->computepjacobian)(snes,x,snes->jacobian,snes->jacobian_pre,sdm->pctx);CHKERRQ(ierr); PetscStackPop; ierr = VecScale(f,-1.0);CHKERRQ(ierr); ierr = MatMultAdd(snes->jacobian,x,f,f);CHKERRQ(ierr); PetscFunctionReturn(0); } PetscErrorCode SNESPicardComputeJacobian(SNES snes,Vec x1,Mat J,Mat B,void *ctx) { PetscFunctionBegin; /* the jacobian matrix should be pre-filled in SNESPicardComputeFunction */ PetscFunctionReturn(0); } /*@C SNESSetPicard - Use SNES to solve the semilinear-system A(x) x = b(x) via a Picard type iteration (Picard linearization) Logically Collective on SNES Input Parameters: + snes - the SNES context . r - vector to store function value . b - function evaluation routine . Amat - matrix with which A(x) x - b(x) is to be computed . Pmat - matrix from which preconditioner is computed (usually the same as Amat) . J - function to compute matrix value, see SNESJacobianFunction for details on its calling sequence - ctx - [optional] user-defined context for private data for the function evaluation routine (may be NULL) Notes: We do not recomemend using this routine. It is far better to provide the nonlinear function F() and some approximation to the Jacobian and use an approximate Newton solver. This interface is provided to allow porting/testing a previous Picard based code in PETSc before converting it to approximate Newton. One can call SNESSetPicard() or SNESSetFunction() (and possibly SNESSetJacobian()) but cannot call both $ Solves the equation A(x) x = b(x) via the defect correction algorithm A(x^{n}) (x^{n+1} - x^{n}) = b(x^{n}) - A(x^{n})x^{n} $ Note that when an exact solver is used this corresponds to the "classic" Picard A(x^{n}) x^{n+1} = b(x^{n}) iteration. Run with -snes_mf_operator to solve the system with Newton's method using A(x^{n}) to construct the preconditioner. We implement the defect correction form of the Picard iteration because it converges much more generally when inexact linear solvers are used then the direct Picard iteration A(x^n) x^{n+1} = b(x^n) There is some controversity over the definition of a Picard iteration for nonlinear systems but almost everyone agrees that it involves a linear solve and some believe it is the iteration A(x^{n}) x^{n+1} = b(x^{n}) hence we use the name Picard. If anyone has an authoritative reference that defines the Picard iteration different please contact us at petsc-dev@mcs.anl.gov and we'll have an entirely new argument :-). Level: intermediate .seealso: SNESGetFunction(), SNESSetFunction(), SNESComputeFunction(), SNESSetJacobian(), SNESGetPicard(), SNESLineSearchPreCheckPicard(), SNESJacobianFunction @*/ PetscErrorCode SNESSetPicard(SNES snes,Vec r,PetscErrorCode (*b)(SNES,Vec,Vec,void*),Mat Amat, Mat Pmat, PetscErrorCode (*J)(SNES,Vec,Mat,Mat,void*),void *ctx) { PetscErrorCode ierr; DM dm; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); ierr = SNESGetDM(snes, &dm);CHKERRQ(ierr); ierr = DMSNESSetPicard(dm,b,J,ctx);CHKERRQ(ierr); ierr = SNESSetFunction(snes,r,SNESPicardComputeFunction,ctx);CHKERRQ(ierr); ierr = SNESSetJacobian(snes,Amat,Pmat,SNESPicardComputeJacobian,ctx);CHKERRQ(ierr); PetscFunctionReturn(0); } /*@C SNESGetPicard - Returns the context for the Picard iteration Not Collective, but Vec is parallel if SNES is parallel. Collective if Vec is requested, but has not been created yet. Input Parameter: . snes - the SNES context Output Parameter: + r - the function (or NULL) . f - the function (or NULL); see SNESFunction for calling sequence details . Amat - the matrix used to defined the operation A(x) x - b(x) (or NULL) . Pmat - the matrix from which the preconditioner will be constructed (or NULL) . J - the function for matrix evaluation (or NULL); see SNESJacobianFunction for calling sequence details - ctx - the function context (or NULL) Level: advanced .seealso: SNESSetPicard(), SNESGetFunction(), SNESGetJacobian(), SNESGetDM(), SNESFunction, SNESJacobianFunction @*/ PetscErrorCode SNESGetPicard(SNES snes,Vec *r,PetscErrorCode (**f)(SNES,Vec,Vec,void*),Mat *Amat, Mat *Pmat, PetscErrorCode (**J)(SNES,Vec,Mat,Mat,void*),void **ctx) { PetscErrorCode ierr; DM dm; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); ierr = SNESGetFunction(snes,r,NULL,NULL);CHKERRQ(ierr); ierr = SNESGetJacobian(snes,Amat,Pmat,NULL,NULL);CHKERRQ(ierr); ierr = SNESGetDM(snes,&dm);CHKERRQ(ierr); ierr = DMSNESGetPicard(dm,f,J,ctx);CHKERRQ(ierr); PetscFunctionReturn(0); } /*@C SNESSetComputeInitialGuess - Sets a routine used to compute an initial guess for the problem Logically Collective on SNES Input Parameters: + snes - the SNES context . func - function evaluation routine - ctx - [optional] user-defined context for private data for the function evaluation routine (may be NULL) Calling sequence of func: $ func (SNES snes,Vec x,void *ctx); . f - function vector - ctx - optional user-defined function context Level: intermediate .seealso: SNESGetFunction(), SNESComputeFunction(), SNESSetJacobian() @*/ PetscErrorCode SNESSetComputeInitialGuess(SNES snes,PetscErrorCode (*func)(SNES,Vec,void*),void *ctx) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); if (func) snes->ops->computeinitialguess = func; if (ctx) snes->initialguessP = ctx; PetscFunctionReturn(0); } /* --------------------------------------------------------------- */ /*@C SNESGetRhs - Gets the vector for solving F(x) = rhs. If rhs is not set it assumes a zero right hand side. Logically Collective on SNES Input Parameter: . snes - the SNES context Output Parameter: . rhs - the right hand side vector or NULL if the right hand side vector is null Level: intermediate .seealso: SNESGetSolution(), SNESGetFunction(), SNESComputeFunction(), SNESSetJacobian(), SNESSetFunction() @*/ PetscErrorCode SNESGetRhs(SNES snes,Vec *rhs) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidPointer(rhs,2); *rhs = snes->vec_rhs; PetscFunctionReturn(0); } /*@ SNESComputeFunction - Calls the function that has been set with SNESSetFunction(). Collective on SNES Input Parameters: + snes - the SNES context - x - input vector Output Parameter: . y - function vector, as set by SNESSetFunction() Notes: SNESComputeFunction() is typically used within nonlinear solvers implementations, so most users would not generally call this routine themselves. Level: developer .seealso: SNESSetFunction(), SNESGetFunction() @*/ PetscErrorCode SNESComputeFunction(SNES snes,Vec x,Vec y) { PetscErrorCode ierr; DM dm; DMSNES sdm; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidHeaderSpecific(x,VEC_CLASSID,2); PetscValidHeaderSpecific(y,VEC_CLASSID,3); PetscCheckSameComm(snes,1,x,2); PetscCheckSameComm(snes,1,y,3); ierr = VecValidValues(x,2,PETSC_TRUE);CHKERRQ(ierr); ierr = SNESGetDM(snes,&dm);CHKERRQ(ierr); ierr = DMGetDMSNES(dm,&sdm);CHKERRQ(ierr); if (sdm->ops->computefunction) { if (sdm->ops->computefunction != SNESObjectiveComputeFunctionDefaultFD) { ierr = PetscLogEventBegin(SNES_FunctionEval,snes,x,y,0);CHKERRQ(ierr); } ierr = VecLockReadPush(x);CHKERRQ(ierr); PetscStackPush("SNES user function"); /* ensure domainerror is false prior to computefunction evaluation (may not have been reset) */ snes->domainerror = PETSC_FALSE; ierr = (*sdm->ops->computefunction)(snes,x,y,sdm->functionctx);CHKERRQ(ierr); PetscStackPop; ierr = VecLockReadPop(x);CHKERRQ(ierr); if (sdm->ops->computefunction != SNESObjectiveComputeFunctionDefaultFD) { ierr = PetscLogEventEnd(SNES_FunctionEval,snes,x,y,0);CHKERRQ(ierr); } } else if (snes->vec_rhs) { ierr = MatMult(snes->jacobian, x, y);CHKERRQ(ierr); } else SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_WRONGSTATE, "Must call SNESSetFunction() or SNESSetDM() before SNESComputeFunction(), likely called from SNESSolve()."); if (snes->vec_rhs) { ierr = VecAXPY(y,-1.0,snes->vec_rhs);CHKERRQ(ierr); } snes->nfuncs++; /* domainerror might not be set on all processes; so we tag vector locally with Inf and the next inner product or norm will propagate the value to all processes */ if (snes->domainerror) { ierr = VecSetInf(y);CHKERRQ(ierr); } PetscFunctionReturn(0); } /*@ SNESComputeNGS - Calls the Gauss-Seidel function that has been set with SNESSetNGS(). Collective on SNES Input Parameters: + snes - the SNES context . x - input vector - b - rhs vector Output Parameter: . x - new solution vector Notes: SNESComputeNGS() is typically used within composed nonlinear solver implementations, so most users would not generally call this routine themselves. Level: developer .seealso: SNESSetNGS(), SNESComputeFunction() @*/ PetscErrorCode SNESComputeNGS(SNES snes,Vec b,Vec x) { PetscErrorCode ierr; DM dm; DMSNES sdm; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidHeaderSpecific(x,VEC_CLASSID,2); if (b) PetscValidHeaderSpecific(b,VEC_CLASSID,3); PetscCheckSameComm(snes,1,x,2); if (b) PetscCheckSameComm(snes,1,b,3); if (b) {ierr = VecValidValues(b,2,PETSC_TRUE);CHKERRQ(ierr);} ierr = PetscLogEventBegin(SNES_NGSEval,snes,x,b,0);CHKERRQ(ierr); ierr = SNESGetDM(snes,&dm);CHKERRQ(ierr); ierr = DMGetDMSNES(dm,&sdm);CHKERRQ(ierr); if (sdm->ops->computegs) { if (b) {ierr = VecLockReadPush(b);CHKERRQ(ierr);} PetscStackPush("SNES user NGS"); ierr = (*sdm->ops->computegs)(snes,x,b,sdm->gsctx);CHKERRQ(ierr); PetscStackPop; if (b) {ierr = VecLockReadPop(b);CHKERRQ(ierr);} } else SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_WRONGSTATE, "Must call SNESSetNGS() before SNESComputeNGS(), likely called from SNESSolve()."); ierr = PetscLogEventEnd(SNES_NGSEval,snes,x,b,0);CHKERRQ(ierr); PetscFunctionReturn(0); } PetscErrorCode SNESTestJacobian(SNES snes) { Mat A,B,C,D,jacobian; Vec x = snes->vec_sol,f = snes->vec_func; PetscErrorCode ierr; PetscReal nrm,gnorm; PetscReal threshold = 1.e-5; MatType mattype; PetscInt m,n,M,N; void *functx; PetscBool complete_print = PETSC_FALSE,threshold_print = PETSC_FALSE,test = PETSC_FALSE,flg; PetscViewer viewer,mviewer; MPI_Comm comm; PetscInt tabs; static PetscBool directionsprinted = PETSC_FALSE; PetscViewerFormat format; PetscFunctionBegin; ierr = PetscObjectOptionsBegin((PetscObject)snes);CHKERRQ(ierr); ierr = PetscOptionsName("-snes_test_jacobian","Compare hand-coded and finite difference Jacobians","None",&test);CHKERRQ(ierr); ierr = PetscOptionsReal("-snes_test_jacobian", "Threshold for element difference between hand-coded and finite difference being meaningful", "None", threshold, &threshold,NULL);CHKERRQ(ierr); ierr = PetscOptionsViewer("-snes_test_jacobian_view","View difference between hand-coded and finite difference Jacobians element entries","None",&mviewer,&format,&complete_print);CHKERRQ(ierr); if (!complete_print) { ierr = PetscOptionsViewer("-snes_test_jacobian_display","Display difference between hand-coded and finite difference Jacobians","None",&mviewer,&format,&complete_print);CHKERRQ(ierr); } /* for compatibility with PETSc 3.9 and older. */ ierr = PetscOptionsReal("-snes_test_jacobian_display_threshold", "Display difference between hand-coded and finite difference Jacobians which exceed input threshold", "None", threshold, &threshold, &threshold_print);CHKERRQ(ierr); ierr = PetscOptionsEnd();CHKERRQ(ierr); if (!test) PetscFunctionReturn(0); ierr = PetscObjectGetComm((PetscObject)snes,&comm);CHKERRQ(ierr); ierr = PetscViewerASCIIGetStdout(comm,&viewer);CHKERRQ(ierr); ierr = PetscViewerASCIIGetTab(viewer, &tabs);CHKERRQ(ierr); ierr = PetscViewerASCIISetTab(viewer, ((PetscObject)snes)->tablevel);CHKERRQ(ierr); ierr = PetscViewerASCIIPrintf(viewer," ---------- Testing Jacobian -------------\n");CHKERRQ(ierr); if (!complete_print && !directionsprinted) { ierr = PetscViewerASCIIPrintf(viewer," Run with -snes_test_jacobian_view and optionally -snes_test_jacobian to show difference\n");CHKERRQ(ierr); ierr = PetscViewerASCIIPrintf(viewer," of hand-coded and finite difference Jacobian entries greater than .\n");CHKERRQ(ierr); } if (!directionsprinted) { ierr = PetscViewerASCIIPrintf(viewer," Testing hand-coded Jacobian, if (for double precision runs) ||J - Jfd||_F/||J||_F is\n");CHKERRQ(ierr); ierr = PetscViewerASCIIPrintf(viewer," O(1.e-8), the hand-coded Jacobian is probably correct.\n");CHKERRQ(ierr); directionsprinted = PETSC_TRUE; } if (complete_print) { ierr = PetscViewerPushFormat(mviewer,format);CHKERRQ(ierr); } ierr = PetscObjectTypeCompare((PetscObject)snes->jacobian,MATMFFD,&flg);CHKERRQ(ierr); if (!flg) jacobian = snes->jacobian; else jacobian = snes->jacobian_pre; if (!x) { ierr = MatCreateVecs(jacobian, &x, NULL);CHKERRQ(ierr); } else { ierr = PetscObjectReference((PetscObject) x);CHKERRQ(ierr); } if (!f) { ierr = VecDuplicate(x, &f);CHKERRQ(ierr); } else { ierr = PetscObjectReference((PetscObject) f);CHKERRQ(ierr); } /* evaluate the function at this point because SNESComputeJacobianDefault() assumes that the function has been evaluated and put into snes->vec_func */ ierr = SNESComputeFunction(snes,x,f);CHKERRQ(ierr); ierr = VecDestroy(&f);CHKERRQ(ierr); while (jacobian) { ierr = PetscObjectBaseTypeCompareAny((PetscObject)jacobian,&flg,MATSEQAIJ,MATMPIAIJ,MATSEQDENSE,MATMPIDENSE,MATSEQBAIJ,MATMPIBAIJ,MATSEQSBAIJ,MATMPISBAIJ,"");CHKERRQ(ierr); if (flg) { A = jacobian; ierr = PetscObjectReference((PetscObject)A);CHKERRQ(ierr); } else { ierr = MatComputeOperator(jacobian,MATAIJ,&A);CHKERRQ(ierr); } ierr = MatGetType(A,&mattype);CHKERRQ(ierr); ierr = MatGetSize(A,&M,&N);CHKERRQ(ierr); ierr = MatGetLocalSize(A,&m,&n);CHKERRQ(ierr); ierr = MatCreate(PetscObjectComm((PetscObject)A),&B);CHKERRQ(ierr); ierr = MatSetType(B,mattype);CHKERRQ(ierr); ierr = MatSetSizes(B,m,n,M,N);CHKERRQ(ierr); ierr = MatSetBlockSizesFromMats(B,A,A);CHKERRQ(ierr); ierr = MatSetUp(B);CHKERRQ(ierr); ierr = MatSetOption(B,MAT_NEW_NONZERO_ALLOCATION_ERR,PETSC_FALSE);CHKERRQ(ierr); ierr = SNESGetFunction(snes,NULL,NULL,&functx);CHKERRQ(ierr); ierr = SNESComputeJacobianDefault(snes,x,B,B,functx);CHKERRQ(ierr); ierr = MatDuplicate(B,MAT_COPY_VALUES,&D);CHKERRQ(ierr); ierr = MatAYPX(D,-1.0,A,DIFFERENT_NONZERO_PATTERN);CHKERRQ(ierr); ierr = MatNorm(D,NORM_FROBENIUS,&nrm);CHKERRQ(ierr); ierr = MatNorm(A,NORM_FROBENIUS,&gnorm);CHKERRQ(ierr); ierr = MatDestroy(&D);CHKERRQ(ierr); if (!gnorm) gnorm = 1; /* just in case */ ierr = PetscViewerASCIIPrintf(viewer," ||J - Jfd||_F/||J||_F = %g, ||J - Jfd||_F = %g\n",(double)(nrm/gnorm),(double)nrm);CHKERRQ(ierr); if (complete_print) { ierr = PetscViewerASCIIPrintf(viewer," Hand-coded Jacobian ----------\n");CHKERRQ(ierr); ierr = MatView(jacobian,mviewer);CHKERRQ(ierr); ierr = PetscViewerASCIIPrintf(viewer," Finite difference Jacobian ----------\n");CHKERRQ(ierr); ierr = MatView(B,mviewer);CHKERRQ(ierr); } if (threshold_print || complete_print) { PetscInt Istart, Iend, *ccols, bncols, cncols, j, row; PetscScalar *cvals; const PetscInt *bcols; const PetscScalar *bvals; ierr = MatCreate(PetscObjectComm((PetscObject)A),&C);CHKERRQ(ierr); ierr = MatSetType(C,mattype);CHKERRQ(ierr); ierr = MatSetSizes(C,m,n,M,N);CHKERRQ(ierr); ierr = MatSetBlockSizesFromMats(C,A,A);CHKERRQ(ierr); ierr = MatSetUp(C);CHKERRQ(ierr); ierr = MatSetOption(C,MAT_NEW_NONZERO_ALLOCATION_ERR,PETSC_FALSE);CHKERRQ(ierr); ierr = MatAYPX(B,-1.0,A,DIFFERENT_NONZERO_PATTERN);CHKERRQ(ierr); ierr = MatGetOwnershipRange(B,&Istart,&Iend);CHKERRQ(ierr); for (row = Istart; row < Iend; row++) { ierr = MatGetRow(B,row,&bncols,&bcols,&bvals);CHKERRQ(ierr); ierr = PetscMalloc2(bncols,&ccols,bncols,&cvals);CHKERRQ(ierr); for (j = 0, cncols = 0; j < bncols; j++) { if (PetscAbsScalar(bvals[j]) > threshold) { ccols[cncols] = bcols[j]; cvals[cncols] = bvals[j]; cncols += 1; } } if (cncols) { ierr = MatSetValues(C,1,&row,cncols,ccols,cvals,INSERT_VALUES);CHKERRQ(ierr); } ierr = MatRestoreRow(B,row,&bncols,&bcols,&bvals);CHKERRQ(ierr); ierr = PetscFree2(ccols,cvals);CHKERRQ(ierr); } ierr = MatAssemblyBegin(C,MAT_FINAL_ASSEMBLY);CHKERRQ(ierr); ierr = MatAssemblyEnd(C,MAT_FINAL_ASSEMBLY);CHKERRQ(ierr); ierr = PetscViewerASCIIPrintf(viewer," Hand-coded minus finite-difference Jacobian with tolerance %g ----------\n",(double)threshold);CHKERRQ(ierr); ierr = MatView(C,complete_print ? mviewer : viewer);CHKERRQ(ierr); ierr = MatDestroy(&C);CHKERRQ(ierr); } ierr = MatDestroy(&A);CHKERRQ(ierr); ierr = MatDestroy(&B);CHKERRQ(ierr); if (jacobian != snes->jacobian_pre) { jacobian = snes->jacobian_pre; ierr = PetscViewerASCIIPrintf(viewer," ---------- Testing Jacobian for preconditioner -------------\n");CHKERRQ(ierr); } else jacobian = NULL; } ierr = VecDestroy(&x);CHKERRQ(ierr); if (complete_print) { ierr = PetscViewerPopFormat(mviewer);CHKERRQ(ierr); } if (mviewer) { ierr = PetscViewerDestroy(&mviewer);CHKERRQ(ierr); } ierr = PetscViewerASCIISetTab(viewer,tabs);CHKERRQ(ierr); PetscFunctionReturn(0); } /*@ SNESComputeJacobian - Computes the Jacobian matrix that has been set with SNESSetJacobian(). Collective on SNES Input Parameters: + snes - the SNES context - x - input vector Output Parameters: + A - Jacobian matrix - B - optional preconditioning matrix Options Database Keys: + -snes_lag_preconditioner . -snes_lag_jacobian . -snes_test_jacobian - compare the user provided Jacobian with one compute via finite differences to check for errors . -snes_test_jacobian_display - display the user provided Jacobian, the finite difference Jacobian and the difference between them to help users detect the location of errors in the user provided Jacobian . -snes_test_jacobian_display_threshold - display entries in the difference between the user provided Jacobian and finite difference Jacobian that are greater than a certain value to help users detect errors . -snes_compare_explicit - Compare the computed Jacobian to the finite difference Jacobian and output the differences . -snes_compare_explicit_draw - Compare the computed Jacobian to the finite difference Jacobian and draw the result . -snes_compare_explicit_contour - Compare the computed Jacobian to the finite difference Jacobian and draw a contour plot with the result . -snes_compare_operator - Make the comparison options above use the operator instead of the preconditioning matrix . -snes_compare_coloring - Compute the finite difference Jacobian using coloring and display norms of difference . -snes_compare_coloring_display - Compute the finite differece Jacobian using coloring and display verbose differences . -snes_compare_coloring_threshold - Display only those matrix entries that differ by more than a given threshold . -snes_compare_coloring_threshold_atol - Absolute tolerance for difference in matrix entries to be displayed by -snes_compare_coloring_threshold . -snes_compare_coloring_threshold_rtol - Relative tolerance for difference in matrix entries to be displayed by -snes_compare_coloring_threshold . -snes_compare_coloring_draw - Compute the finite differece Jacobian using coloring and draw differences - -snes_compare_coloring_draw_contour - Compute the finite differece Jacobian using coloring and show contours of matrices and differences Notes: Most users should not need to explicitly call this routine, as it is used internally within the nonlinear solvers. Developer Notes: This has duplicative ways of checking the accuracy of the user provided Jacobian (see the options above). This is for historical reasons, the routine SNESTestJacobian() use to used for with the SNESType of test that has been removed. Level: developer .seealso: SNESSetJacobian(), KSPSetOperators(), MatStructure, SNESSetLagPreconditioner(), SNESSetLagJacobian() @*/ PetscErrorCode SNESComputeJacobian(SNES snes,Vec X,Mat A,Mat B) { PetscErrorCode ierr; PetscBool flag; DM dm; DMSNES sdm; KSP ksp; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidHeaderSpecific(X,VEC_CLASSID,2); PetscCheckSameComm(snes,1,X,2); ierr = VecValidValues(X,2,PETSC_TRUE);CHKERRQ(ierr); ierr = SNESGetDM(snes,&dm);CHKERRQ(ierr); ierr = DMGetDMSNES(dm,&sdm);CHKERRQ(ierr); if (!sdm->ops->computejacobian) SETERRQ(PetscObjectComm((PetscObject)snes),PETSC_ERR_USER,"Must call SNESSetJacobian(), DMSNESSetJacobian(), DMDASNESSetJacobianLocal(), etc"); /* make sure that MatAssemblyBegin/End() is called on A matrix if it is matrix free */ if (snes->lagjacobian == -2) { snes->lagjacobian = -1; ierr = PetscInfo(snes,"Recomputing Jacobian/preconditioner because lag is -2 (means compute Jacobian, but then never again) \n");CHKERRQ(ierr); } else if (snes->lagjacobian == -1) { ierr = PetscInfo(snes,"Reusing Jacobian/preconditioner because lag is -1\n");CHKERRQ(ierr); ierr = PetscObjectTypeCompare((PetscObject)A,MATMFFD,&flag);CHKERRQ(ierr); if (flag) { ierr = MatAssemblyBegin(A,MAT_FINAL_ASSEMBLY);CHKERRQ(ierr); ierr = MatAssemblyEnd(A,MAT_FINAL_ASSEMBLY);CHKERRQ(ierr); } PetscFunctionReturn(0); } else if (snes->lagjacobian > 1 && (snes->iter + snes->jac_iter) % snes->lagjacobian) { ierr = PetscInfo2(snes,"Reusing Jacobian/preconditioner because lag is %D and SNES iteration is %D\n",snes->lagjacobian,snes->iter);CHKERRQ(ierr); ierr = PetscObjectTypeCompare((PetscObject)A,MATMFFD,&flag);CHKERRQ(ierr); if (flag) { ierr = MatAssemblyBegin(A,MAT_FINAL_ASSEMBLY);CHKERRQ(ierr); ierr = MatAssemblyEnd(A,MAT_FINAL_ASSEMBLY);CHKERRQ(ierr); } PetscFunctionReturn(0); } if (snes->npc && snes->npcside== PC_LEFT) { ierr = MatAssemblyBegin(A,MAT_FINAL_ASSEMBLY);CHKERRQ(ierr); ierr = MatAssemblyEnd(A,MAT_FINAL_ASSEMBLY);CHKERRQ(ierr); PetscFunctionReturn(0); } ierr = PetscLogEventBegin(SNES_JacobianEval,snes,X,A,B);CHKERRQ(ierr); ierr = VecLockReadPush(X);CHKERRQ(ierr); PetscStackPush("SNES user Jacobian function"); ierr = (*sdm->ops->computejacobian)(snes,X,A,B,sdm->jacobianctx);CHKERRQ(ierr); PetscStackPop; ierr = VecLockReadPop(X);CHKERRQ(ierr); ierr = PetscLogEventEnd(SNES_JacobianEval,snes,X,A,B);CHKERRQ(ierr); /* attach latest linearization point to the preconditioning matrix */ ierr = PetscObjectCompose((PetscObject)B,"__SNES_latest_X",(PetscObject)X);CHKERRQ(ierr); /* the next line ensures that snes->ksp exists */ ierr = SNESGetKSP(snes,&ksp);CHKERRQ(ierr); if (snes->lagpreconditioner == -2) { ierr = PetscInfo(snes,"Rebuilding preconditioner exactly once since lag is -2\n");CHKERRQ(ierr); ierr = KSPSetReusePreconditioner(snes->ksp,PETSC_FALSE);CHKERRQ(ierr); snes->lagpreconditioner = -1; } else if (snes->lagpreconditioner == -1) { ierr = PetscInfo(snes,"Reusing preconditioner because lag is -1\n");CHKERRQ(ierr); ierr = KSPSetReusePreconditioner(snes->ksp,PETSC_TRUE);CHKERRQ(ierr); } else if (snes->lagpreconditioner > 1 && (snes->iter + snes->pre_iter) % snes->lagpreconditioner) { ierr = PetscInfo2(snes,"Reusing preconditioner because lag is %D and SNES iteration is %D\n",snes->lagpreconditioner,snes->iter);CHKERRQ(ierr); ierr = KSPSetReusePreconditioner(snes->ksp,PETSC_TRUE);CHKERRQ(ierr); } else { ierr = PetscInfo(snes,"Rebuilding preconditioner\n");CHKERRQ(ierr); ierr = KSPSetReusePreconditioner(snes->ksp,PETSC_FALSE);CHKERRQ(ierr); } ierr = SNESTestJacobian(snes);CHKERRQ(ierr); /* make sure user returned a correct Jacobian and preconditioner */ /* PetscValidHeaderSpecific(A,MAT_CLASSID,3); PetscValidHeaderSpecific(B,MAT_CLASSID,4); */ { PetscBool flag = PETSC_FALSE,flag_draw = PETSC_FALSE,flag_contour = PETSC_FALSE,flag_operator = PETSC_FALSE; ierr = PetscOptionsGetViewer(PetscObjectComm((PetscObject)snes),((PetscObject) snes)->options,((PetscObject)snes)->prefix,"-snes_compare_explicit",NULL,NULL,&flag);CHKERRQ(ierr); ierr = PetscOptionsGetViewer(PetscObjectComm((PetscObject)snes),((PetscObject) snes)->options,((PetscObject)snes)->prefix,"-snes_compare_explicit_draw",NULL,NULL,&flag_draw);CHKERRQ(ierr); ierr = PetscOptionsGetViewer(PetscObjectComm((PetscObject)snes),((PetscObject) snes)->options,((PetscObject)snes)->prefix,"-snes_compare_explicit_draw_contour",NULL,NULL,&flag_contour);CHKERRQ(ierr); ierr = PetscOptionsGetViewer(PetscObjectComm((PetscObject)snes),((PetscObject) snes)->options,((PetscObject)snes)->prefix,"-snes_compare_operator",NULL,NULL,&flag_operator);CHKERRQ(ierr); if (flag || flag_draw || flag_contour) { Mat Bexp_mine = NULL,Bexp,FDexp; PetscViewer vdraw,vstdout; PetscBool flg; if (flag_operator) { ierr = MatComputeOperator(A,MATAIJ,&Bexp_mine);CHKERRQ(ierr); Bexp = Bexp_mine; } else { /* See if the preconditioning matrix can be viewed and added directly */ ierr = PetscObjectBaseTypeCompareAny((PetscObject)B,&flg,MATSEQAIJ,MATMPIAIJ,MATSEQDENSE,MATMPIDENSE,MATSEQBAIJ,MATMPIBAIJ,MATSEQSBAIJ,MATMPIBAIJ,"");CHKERRQ(ierr); if (flg) Bexp = B; else { /* If the "preconditioning" matrix is itself MATSHELL or some other type without direct support */ ierr = MatComputeOperator(B,MATAIJ,&Bexp_mine);CHKERRQ(ierr); Bexp = Bexp_mine; } } ierr = MatConvert(Bexp,MATSAME,MAT_INITIAL_MATRIX,&FDexp);CHKERRQ(ierr); ierr = SNESComputeJacobianDefault(snes,X,FDexp,FDexp,NULL);CHKERRQ(ierr); ierr = PetscViewerASCIIGetStdout(PetscObjectComm((PetscObject)snes),&vstdout);CHKERRQ(ierr); if (flag_draw || flag_contour) { ierr = PetscViewerDrawOpen(PetscObjectComm((PetscObject)snes),0,"Explicit Jacobians",PETSC_DECIDE,PETSC_DECIDE,300,300,&vdraw);CHKERRQ(ierr); if (flag_contour) {ierr = PetscViewerPushFormat(vdraw,PETSC_VIEWER_DRAW_CONTOUR);CHKERRQ(ierr);} } else vdraw = NULL; ierr = PetscViewerASCIIPrintf(vstdout,"Explicit %s\n",flag_operator ? "Jacobian" : "preconditioning Jacobian");CHKERRQ(ierr); if (flag) {ierr = MatView(Bexp,vstdout);CHKERRQ(ierr);} if (vdraw) {ierr = MatView(Bexp,vdraw);CHKERRQ(ierr);} ierr = PetscViewerASCIIPrintf(vstdout,"Finite difference Jacobian\n");CHKERRQ(ierr); if (flag) {ierr = MatView(FDexp,vstdout);CHKERRQ(ierr);} if (vdraw) {ierr = MatView(FDexp,vdraw);CHKERRQ(ierr);} ierr = MatAYPX(FDexp,-1.0,Bexp,SAME_NONZERO_PATTERN);CHKERRQ(ierr); ierr = PetscViewerASCIIPrintf(vstdout,"User-provided matrix minus finite difference Jacobian\n");CHKERRQ(ierr); if (flag) {ierr = MatView(FDexp,vstdout);CHKERRQ(ierr);} if (vdraw) { /* Always use contour for the difference */ ierr = PetscViewerPushFormat(vdraw,PETSC_VIEWER_DRAW_CONTOUR);CHKERRQ(ierr); ierr = MatView(FDexp,vdraw);CHKERRQ(ierr); ierr = PetscViewerPopFormat(vdraw);CHKERRQ(ierr); } if (flag_contour) {ierr = PetscViewerPopFormat(vdraw);CHKERRQ(ierr);} ierr = PetscViewerDestroy(&vdraw);CHKERRQ(ierr); ierr = MatDestroy(&Bexp_mine);CHKERRQ(ierr); ierr = MatDestroy(&FDexp);CHKERRQ(ierr); } } { PetscBool flag = PETSC_FALSE,flag_display = PETSC_FALSE,flag_draw = PETSC_FALSE,flag_contour = PETSC_FALSE,flag_threshold = PETSC_FALSE; PetscReal threshold_atol = PETSC_SQRT_MACHINE_EPSILON,threshold_rtol = 10*PETSC_SQRT_MACHINE_EPSILON; ierr = PetscOptionsGetViewer(PetscObjectComm((PetscObject)snes),((PetscObject)snes)->options,((PetscObject)snes)->prefix,"-snes_compare_coloring",NULL,NULL,&flag);CHKERRQ(ierr); ierr = PetscOptionsGetViewer(PetscObjectComm((PetscObject)snes),((PetscObject)snes)->options,((PetscObject)snes)->prefix,"-snes_compare_coloring_display",NULL,NULL,&flag_display);CHKERRQ(ierr); ierr = PetscOptionsGetViewer(PetscObjectComm((PetscObject)snes),((PetscObject)snes)->options,((PetscObject)snes)->prefix,"-snes_compare_coloring_draw",NULL,NULL,&flag_draw);CHKERRQ(ierr); ierr = PetscOptionsGetViewer(PetscObjectComm((PetscObject)snes),((PetscObject)snes)->options,((PetscObject)snes)->prefix,"-snes_compare_coloring_draw_contour",NULL,NULL,&flag_contour);CHKERRQ(ierr); ierr = PetscOptionsGetViewer(PetscObjectComm((PetscObject)snes),((PetscObject)snes)->options,((PetscObject)snes)->prefix,"-snes_compare_coloring_threshold",NULL,NULL,&flag_threshold);CHKERRQ(ierr); if (flag_threshold) { ierr = PetscOptionsGetReal(((PetscObject)snes)->options,((PetscObject)snes)->prefix,"-snes_compare_coloring_threshold_rtol",&threshold_rtol,NULL);CHKERRQ(ierr); ierr = PetscOptionsGetReal(((PetscObject)snes)->options,((PetscObject)snes)->prefix,"-snes_compare_coloring_threshold_atol",&threshold_atol,NULL);CHKERRQ(ierr); } if (flag || flag_display || flag_draw || flag_contour || flag_threshold) { Mat Bfd; PetscViewer vdraw,vstdout; MatColoring coloring; ISColoring iscoloring; MatFDColoring matfdcoloring; PetscErrorCode (*func)(SNES,Vec,Vec,void*); void *funcctx; PetscReal norm1,norm2,normmax; ierr = MatDuplicate(B,MAT_DO_NOT_COPY_VALUES,&Bfd);CHKERRQ(ierr); ierr = MatColoringCreate(Bfd,&coloring);CHKERRQ(ierr); ierr = MatColoringSetType(coloring,MATCOLORINGSL);CHKERRQ(ierr); ierr = MatColoringSetFromOptions(coloring);CHKERRQ(ierr); ierr = MatColoringApply(coloring,&iscoloring);CHKERRQ(ierr); ierr = MatColoringDestroy(&coloring);CHKERRQ(ierr); ierr = MatFDColoringCreate(Bfd,iscoloring,&matfdcoloring);CHKERRQ(ierr); ierr = MatFDColoringSetFromOptions(matfdcoloring);CHKERRQ(ierr); ierr = MatFDColoringSetUp(Bfd,iscoloring,matfdcoloring);CHKERRQ(ierr); ierr = ISColoringDestroy(&iscoloring);CHKERRQ(ierr); /* This method of getting the function is currently unreliable since it doesn't work for DM local functions. */ ierr = SNESGetFunction(snes,NULL,&func,&funcctx);CHKERRQ(ierr); ierr = MatFDColoringSetFunction(matfdcoloring,(PetscErrorCode (*)(void))func,funcctx);CHKERRQ(ierr); ierr = PetscObjectSetOptionsPrefix((PetscObject)matfdcoloring,((PetscObject)snes)->prefix);CHKERRQ(ierr); ierr = PetscObjectAppendOptionsPrefix((PetscObject)matfdcoloring,"coloring_");CHKERRQ(ierr); ierr = MatFDColoringSetFromOptions(matfdcoloring);CHKERRQ(ierr); ierr = MatFDColoringApply(Bfd,matfdcoloring,X,snes);CHKERRQ(ierr); ierr = MatFDColoringDestroy(&matfdcoloring);CHKERRQ(ierr); ierr = PetscViewerASCIIGetStdout(PetscObjectComm((PetscObject)snes),&vstdout);CHKERRQ(ierr); if (flag_draw || flag_contour) { ierr = PetscViewerDrawOpen(PetscObjectComm((PetscObject)snes),0,"Colored Jacobians",PETSC_DECIDE,PETSC_DECIDE,300,300,&vdraw);CHKERRQ(ierr); if (flag_contour) {ierr = PetscViewerPushFormat(vdraw,PETSC_VIEWER_DRAW_CONTOUR);CHKERRQ(ierr);} } else vdraw = NULL; ierr = PetscViewerASCIIPrintf(vstdout,"Explicit preconditioning Jacobian\n");CHKERRQ(ierr); if (flag_display) {ierr = MatView(B,vstdout);CHKERRQ(ierr);} if (vdraw) {ierr = MatView(B,vdraw);CHKERRQ(ierr);} ierr = PetscViewerASCIIPrintf(vstdout,"Colored Finite difference Jacobian\n");CHKERRQ(ierr); if (flag_display) {ierr = MatView(Bfd,vstdout);CHKERRQ(ierr);} if (vdraw) {ierr = MatView(Bfd,vdraw);CHKERRQ(ierr);} ierr = MatAYPX(Bfd,-1.0,B,SAME_NONZERO_PATTERN);CHKERRQ(ierr); ierr = MatNorm(Bfd,NORM_1,&norm1);CHKERRQ(ierr); ierr = MatNorm(Bfd,NORM_FROBENIUS,&norm2);CHKERRQ(ierr); ierr = MatNorm(Bfd,NORM_MAX,&normmax);CHKERRQ(ierr); ierr = PetscViewerASCIIPrintf(vstdout,"User-provided matrix minus finite difference Jacobian, norm1=%g normFrob=%g normmax=%g\n",(double)norm1,(double)norm2,(double)normmax);CHKERRQ(ierr); if (flag_display) {ierr = MatView(Bfd,vstdout);CHKERRQ(ierr);} if (vdraw) { /* Always use contour for the difference */ ierr = PetscViewerPushFormat(vdraw,PETSC_VIEWER_DRAW_CONTOUR);CHKERRQ(ierr); ierr = MatView(Bfd,vdraw);CHKERRQ(ierr); ierr = PetscViewerPopFormat(vdraw);CHKERRQ(ierr); } if (flag_contour) {ierr = PetscViewerPopFormat(vdraw);CHKERRQ(ierr);} if (flag_threshold) { PetscInt bs,rstart,rend,i; ierr = MatGetBlockSize(B,&bs);CHKERRQ(ierr); ierr = MatGetOwnershipRange(B,&rstart,&rend);CHKERRQ(ierr); for (i=rstart; icomm,PETSC_ERR_PLIB,"Unexpected different nonzero pattern in -snes_compare_coloring_threshold"); for (j=0; j PetscAbs(maxentry)) { maxentrycol = bj[j]; maxentry = PetscRealPart(ba[j]); } if (PetscAbsScalar(ca[j]) > PetscAbs(maxdiff)) { maxdiffcol = bj[j]; maxdiff = PetscRealPart(ca[j]); } if (rdiff > maxrdiff) { maxrdiffcol = bj[j]; maxrdiff = rdiff; } } if (maxrdiff > 1) { ierr = PetscViewerASCIIPrintf(vstdout,"row %D (maxentry=%g at %D, maxdiff=%g at %D, maxrdiff=%g at %D):",i,(double)maxentry,maxentrycol,(double)maxdiff,maxdiffcol,(double)maxrdiff,maxrdiffcol);CHKERRQ(ierr); for (j=0; j 1) { ierr = PetscViewerASCIIPrintf(vstdout," (%D,%g:%g)",bj[j],(double)PetscRealPart(ba[j]),(double)PetscRealPart(ca[j]));CHKERRQ(ierr); } } ierr = PetscViewerASCIIPrintf(vstdout,"\n",i,maxentry,maxdiff,maxrdiff);CHKERRQ(ierr); } ierr = MatRestoreRow(B,i,&bn,&bj,&ba);CHKERRQ(ierr); ierr = MatRestoreRow(Bfd,i,&cn,&cj,&ca);CHKERRQ(ierr); } } ierr = PetscViewerDestroy(&vdraw);CHKERRQ(ierr); ierr = MatDestroy(&Bfd);CHKERRQ(ierr); } } PetscFunctionReturn(0); } /*MC SNESJacobianFunction - Function used to convey the nonlinear Jacobian of the function to be solved by SNES Synopsis: #include "petscsnes.h" PetscErrorCode SNESJacobianFunction(SNES snes,Vec x,Mat Amat,Mat Pmat,void *ctx); + x - input vector . Amat - the matrix that defines the (approximate) Jacobian . Pmat - the matrix to be used in constructing the preconditioner, usually the same as Amat. - ctx - [optional] user-defined Jacobian context Level: intermediate .seealso: SNESSetFunction(), SNESGetFunction(), SNESSetJacobian(), SNESGetJacobian() M*/ /*@C SNESSetJacobian - Sets the function to compute Jacobian as well as the location to store the matrix. Logically Collective on SNES Input Parameters: + snes - the SNES context . Amat - the matrix that defines the (approximate) Jacobian . Pmat - the matrix to be used in constructing the preconditioner, usually the same as Amat. . J - Jacobian evaluation routine (if NULL then SNES retains any previously set value), see SNESJacobianFunction for details - ctx - [optional] user-defined context for private data for the Jacobian evaluation routine (may be NULL) (if NULL then SNES retains any previously set value) Notes: If the Amat matrix and Pmat matrix are different you must call MatAssemblyBegin/End() on each matrix. If you know the operator Amat has a null space you can use MatSetNullSpace() and MatSetTransposeNullSpace() to supply the null space to Amat and the KSP solvers will automatically use that null space as needed during the solution process. If using SNESComputeJacobianDefaultColor() to assemble a Jacobian, the ctx argument must be a MatFDColoring. Other defect-correction schemes can be used by computing a different matrix in place of the Jacobian. One common example is to use the "Picard linearization" which only differentiates through the highest order parts of each term. Level: beginner .seealso: KSPSetOperators(), SNESSetFunction(), MatMFFDComputeJacobian(), SNESComputeJacobianDefaultColor(), MatStructure, J, SNESSetPicard(), SNESJacobianFunction @*/ PetscErrorCode SNESSetJacobian(SNES snes,Mat Amat,Mat Pmat,PetscErrorCode (*J)(SNES,Vec,Mat,Mat,void*),void *ctx) { PetscErrorCode ierr; DM dm; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); if (Amat) PetscValidHeaderSpecific(Amat,MAT_CLASSID,2); if (Pmat) PetscValidHeaderSpecific(Pmat,MAT_CLASSID,3); if (Amat) PetscCheckSameComm(snes,1,Amat,2); if (Pmat) PetscCheckSameComm(snes,1,Pmat,3); ierr = SNESGetDM(snes,&dm);CHKERRQ(ierr); ierr = DMSNESSetJacobian(dm,J,ctx);CHKERRQ(ierr); if (Amat) { ierr = PetscObjectReference((PetscObject)Amat);CHKERRQ(ierr); ierr = MatDestroy(&snes->jacobian);CHKERRQ(ierr); snes->jacobian = Amat; } if (Pmat) { ierr = PetscObjectReference((PetscObject)Pmat);CHKERRQ(ierr); ierr = MatDestroy(&snes->jacobian_pre);CHKERRQ(ierr); snes->jacobian_pre = Pmat; } PetscFunctionReturn(0); } /*@C SNESGetJacobian - Returns the Jacobian matrix and optionally the user provided context for evaluating the Jacobian. Not Collective, but Mat object will be parallel if SNES object is Input Parameter: . snes - the nonlinear solver context Output Parameters: + Amat - location to stash (approximate) Jacobian matrix (or NULL) . Pmat - location to stash matrix used to compute the preconditioner (or NULL) . J - location to put Jacobian function (or NULL), see SNESJacobianFunction for details on its calling sequence - ctx - location to stash Jacobian ctx (or NULL) Level: advanced .seealso: SNESSetJacobian(), SNESComputeJacobian(), SNESJacobianFunction, SNESGetFunction() @*/ PetscErrorCode SNESGetJacobian(SNES snes,Mat *Amat,Mat *Pmat,PetscErrorCode (**J)(SNES,Vec,Mat,Mat,void*),void **ctx) { PetscErrorCode ierr; DM dm; DMSNES sdm; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); if (Amat) *Amat = snes->jacobian; if (Pmat) *Pmat = snes->jacobian_pre; ierr = SNESGetDM(snes,&dm);CHKERRQ(ierr); ierr = DMGetDMSNES(dm,&sdm);CHKERRQ(ierr); if (J) *J = sdm->ops->computejacobian; if (ctx) *ctx = sdm->jacobianctx; PetscFunctionReturn(0); } /*@ SNESSetUp - Sets up the internal data structures for the later use of a nonlinear solver. Collective on SNES Input Parameters: . snes - the SNES context Notes: For basic use of the SNES solvers the user need not explicitly call SNESSetUp(), since these actions will automatically occur during the call to SNESSolve(). However, if one wishes to control this phase separately, SNESSetUp() should be called after SNESCreate() and optional routines of the form SNESSetXXX(), but before SNESSolve(). Level: advanced .seealso: SNESCreate(), SNESSolve(), SNESDestroy() @*/ PetscErrorCode SNESSetUp(SNES snes) { PetscErrorCode ierr; DM dm; DMSNES sdm; SNESLineSearch linesearch, pclinesearch; void *lsprectx,*lspostctx; PetscErrorCode (*precheck)(SNESLineSearch,Vec,Vec,PetscBool*,void*); PetscErrorCode (*postcheck)(SNESLineSearch,Vec,Vec,Vec,PetscBool*,PetscBool*,void*); PetscErrorCode (*func)(SNES,Vec,Vec,void*); Vec f,fpc; void *funcctx; PetscErrorCode (*jac)(SNES,Vec,Mat,Mat,void*); void *jacctx,*appctx; Mat j,jpre; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); if (snes->setupcalled) PetscFunctionReturn(0); ierr = PetscLogEventBegin(SNES_Setup,snes,0,0,0);CHKERRQ(ierr); if (!((PetscObject)snes)->type_name) { ierr = SNESSetType(snes,SNESNEWTONLS);CHKERRQ(ierr); } ierr = SNESGetFunction(snes,&snes->vec_func,NULL,NULL);CHKERRQ(ierr); ierr = SNESGetDM(snes,&dm);CHKERRQ(ierr); ierr = DMGetDMSNES(dm,&sdm);CHKERRQ(ierr); if (!sdm->ops->computefunction) SETERRQ(PetscObjectComm((PetscObject)dm),PETSC_ERR_ARG_WRONGSTATE,"Function never provided to SNES object"); if (!sdm->ops->computejacobian) { ierr = DMSNESSetJacobian(dm,SNESComputeJacobianDefaultColor,NULL);CHKERRQ(ierr); } if (!snes->vec_func) { ierr = DMCreateGlobalVector(dm,&snes->vec_func);CHKERRQ(ierr); } if (!snes->ksp) { ierr = SNESGetKSP(snes, &snes->ksp);CHKERRQ(ierr); } if (snes->linesearch) { ierr = SNESGetLineSearch(snes, &snes->linesearch);CHKERRQ(ierr); ierr = SNESLineSearchSetFunction(snes->linesearch,SNESComputeFunction);CHKERRQ(ierr); } if (snes->npc && (snes->npcside== PC_LEFT)) { snes->mf = PETSC_TRUE; snes->mf_operator = PETSC_FALSE; } if (snes->npc) { /* copy the DM over */ ierr = SNESGetDM(snes,&dm);CHKERRQ(ierr); ierr = SNESSetDM(snes->npc,dm);CHKERRQ(ierr); ierr = SNESGetFunction(snes,&f,&func,&funcctx);CHKERRQ(ierr); ierr = VecDuplicate(f,&fpc);CHKERRQ(ierr); ierr = SNESSetFunction(snes->npc,fpc,func,funcctx);CHKERRQ(ierr); ierr = SNESGetJacobian(snes,&j,&jpre,&jac,&jacctx);CHKERRQ(ierr); ierr = SNESSetJacobian(snes->npc,j,jpre,jac,jacctx);CHKERRQ(ierr); ierr = SNESGetApplicationContext(snes,&appctx);CHKERRQ(ierr); ierr = SNESSetApplicationContext(snes->npc,appctx);CHKERRQ(ierr); ierr = VecDestroy(&fpc);CHKERRQ(ierr); /* copy the function pointers over */ ierr = PetscObjectCopyFortranFunctionPointers((PetscObject)snes,(PetscObject)snes->npc);CHKERRQ(ierr); /* default to 1 iteration */ ierr = SNESSetTolerances(snes->npc,0.0,0.0,0.0,1,snes->npc->max_funcs);CHKERRQ(ierr); if (snes->npcside==PC_RIGHT) { ierr = SNESSetNormSchedule(snes->npc,SNES_NORM_FINAL_ONLY);CHKERRQ(ierr); } else { ierr = SNESSetNormSchedule(snes->npc,SNES_NORM_NONE);CHKERRQ(ierr); } ierr = SNESSetFromOptions(snes->npc);CHKERRQ(ierr); /* copy the line search context over */ if (snes->linesearch && snes->npc->linesearch) { ierr = SNESGetLineSearch(snes,&linesearch);CHKERRQ(ierr); ierr = SNESGetLineSearch(snes->npc,&pclinesearch);CHKERRQ(ierr); ierr = SNESLineSearchGetPreCheck(linesearch,&precheck,&lsprectx);CHKERRQ(ierr); ierr = SNESLineSearchGetPostCheck(linesearch,&postcheck,&lspostctx);CHKERRQ(ierr); ierr = SNESLineSearchSetPreCheck(pclinesearch,precheck,lsprectx);CHKERRQ(ierr); ierr = SNESLineSearchSetPostCheck(pclinesearch,postcheck,lspostctx);CHKERRQ(ierr); ierr = PetscObjectCopyFortranFunctionPointers((PetscObject)linesearch, (PetscObject)pclinesearch);CHKERRQ(ierr); } } if (snes->mf) { ierr = SNESSetUpMatrixFree_Private(snes, snes->mf_operator, snes->mf_version);CHKERRQ(ierr); } if (snes->ops->usercompute && !snes->user) { ierr = (*snes->ops->usercompute)(snes,(void**)&snes->user);CHKERRQ(ierr); } snes->jac_iter = 0; snes->pre_iter = 0; if (snes->ops->setup) { ierr = (*snes->ops->setup)(snes);CHKERRQ(ierr); } if (snes->npc && (snes->npcside== PC_LEFT)) { if (snes->functype == SNES_FUNCTION_PRECONDITIONED) { if (snes->linesearch){ ierr = SNESGetLineSearch(snes,&linesearch);CHKERRQ(ierr); ierr = SNESLineSearchSetFunction(linesearch,SNESComputeFunctionDefaultNPC);CHKERRQ(ierr); } } } ierr = PetscLogEventEnd(SNES_Setup,snes,0,0,0);CHKERRQ(ierr); snes->setupcalled = PETSC_TRUE; PetscFunctionReturn(0); } /*@ SNESReset - Resets a SNES context to the snessetupcalled = 0 state and removes any allocated Vecs and Mats Collective on SNES Input Parameter: . snes - iterative context obtained from SNESCreate() Level: intermediate Notes: Also calls the application context destroy routine set with SNESSetComputeApplicationContext() .seealso: SNESCreate(), SNESSetUp(), SNESSolve() @*/ PetscErrorCode SNESReset(SNES snes) { PetscErrorCode ierr; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); if (snes->ops->userdestroy && snes->user) { ierr = (*snes->ops->userdestroy)((void**)&snes->user);CHKERRQ(ierr); snes->user = NULL; } if (snes->npc) { ierr = SNESReset(snes->npc);CHKERRQ(ierr); } if (snes->ops->reset) { ierr = (*snes->ops->reset)(snes);CHKERRQ(ierr); } if (snes->ksp) { ierr = KSPReset(snes->ksp);CHKERRQ(ierr); } if (snes->linesearch) { ierr = SNESLineSearchReset(snes->linesearch);CHKERRQ(ierr); } ierr = VecDestroy(&snes->vec_rhs);CHKERRQ(ierr); ierr = VecDestroy(&snes->vec_sol);CHKERRQ(ierr); ierr = VecDestroy(&snes->vec_sol_update);CHKERRQ(ierr); ierr = VecDestroy(&snes->vec_func);CHKERRQ(ierr); ierr = MatDestroy(&snes->jacobian);CHKERRQ(ierr); ierr = MatDestroy(&snes->jacobian_pre);CHKERRQ(ierr); ierr = VecDestroyVecs(snes->nwork,&snes->work);CHKERRQ(ierr); ierr = VecDestroyVecs(snes->nvwork,&snes->vwork);CHKERRQ(ierr); snes->alwayscomputesfinalresidual = PETSC_FALSE; snes->nwork = snes->nvwork = 0; snes->setupcalled = PETSC_FALSE; PetscFunctionReturn(0); } /*@ SNESDestroy - Destroys the nonlinear solver context that was created with SNESCreate(). Collective on SNES Input Parameter: . snes - the SNES context Level: beginner .seealso: SNESCreate(), SNESSolve() @*/ PetscErrorCode SNESDestroy(SNES *snes) { PetscErrorCode ierr; PetscFunctionBegin; if (!*snes) PetscFunctionReturn(0); PetscValidHeaderSpecific((*snes),SNES_CLASSID,1); if (--((PetscObject)(*snes))->refct > 0) {*snes = 0; PetscFunctionReturn(0);} ierr = SNESReset((*snes));CHKERRQ(ierr); ierr = SNESDestroy(&(*snes)->npc);CHKERRQ(ierr); /* if memory was published with SAWs then destroy it */ ierr = PetscObjectSAWsViewOff((PetscObject)*snes);CHKERRQ(ierr); if ((*snes)->ops->destroy) {ierr = (*((*snes))->ops->destroy)((*snes));CHKERRQ(ierr);} if ((*snes)->dm) {ierr = DMCoarsenHookRemove((*snes)->dm,DMCoarsenHook_SNESVecSol,DMRestrictHook_SNESVecSol,*snes);CHKERRQ(ierr);} ierr = DMDestroy(&(*snes)->dm);CHKERRQ(ierr); ierr = KSPDestroy(&(*snes)->ksp);CHKERRQ(ierr); ierr = SNESLineSearchDestroy(&(*snes)->linesearch);CHKERRQ(ierr); ierr = PetscFree((*snes)->kspconvctx);CHKERRQ(ierr); if ((*snes)->ops->convergeddestroy) { ierr = (*(*snes)->ops->convergeddestroy)((*snes)->cnvP);CHKERRQ(ierr); } if ((*snes)->conv_hist_alloc) { ierr = PetscFree2((*snes)->conv_hist,(*snes)->conv_hist_its);CHKERRQ(ierr); } ierr = SNESMonitorCancel((*snes));CHKERRQ(ierr); ierr = PetscHeaderDestroy(snes);CHKERRQ(ierr); PetscFunctionReturn(0); } /* ----------- Routines to set solver parameters ---------- */ /*@ SNESSetLagPreconditioner - Determines when the preconditioner is rebuilt in the nonlinear solve. Logically Collective on SNES Input Parameters: + snes - the SNES context - lag - -1 indicates NEVER rebuild, 1 means rebuild every time the Jacobian is computed within a single nonlinear solve, 2 means every second time the Jacobian is built etc. -2 indicates rebuild preconditioner at next chance but then never rebuild after that Options Database Keys: . -snes_lag_preconditioner Notes: The default is 1 The preconditioner is ALWAYS built in the first iteration of a nonlinear solve unless lag is -1 If -1 is used before the very first nonlinear solve the preconditioner is still built because there is no previous preconditioner to use Level: intermediate .seealso: SNESSetTrustRegionTolerance(), SNESGetLagPreconditioner(), SNESSetLagJacobian(), SNESGetLagJacobian() @*/ PetscErrorCode SNESSetLagPreconditioner(SNES snes,PetscInt lag) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); if (lag < -2) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"Lag must be -2, -1, 1 or greater"); if (!lag) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"Lag cannot be 0"); PetscValidLogicalCollectiveInt(snes,lag,2); snes->lagpreconditioner = lag; PetscFunctionReturn(0); } /*@ SNESSetGridSequence - sets the number of steps of grid sequencing that SNES does Logically Collective on SNES Input Parameters: + snes - the SNES context - steps - the number of refinements to do, defaults to 0 Options Database Keys: . -snes_grid_sequence Level: intermediate Notes: Use SNESGetSolution() to extract the fine grid solution after grid sequencing. .seealso: SNESSetTrustRegionTolerance(), SNESGetLagPreconditioner(), SNESSetLagJacobian(), SNESGetLagJacobian(), SNESGetGridSequence() @*/ PetscErrorCode SNESSetGridSequence(SNES snes,PetscInt steps) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidLogicalCollectiveInt(snes,steps,2); snes->gridsequence = steps; PetscFunctionReturn(0); } /*@ SNESGetGridSequence - gets the number of steps of grid sequencing that SNES does Logically Collective on SNES Input Parameter: . snes - the SNES context Output Parameter: . steps - the number of refinements to do, defaults to 0 Options Database Keys: . -snes_grid_sequence Level: intermediate Notes: Use SNESGetSolution() to extract the fine grid solution after grid sequencing. .seealso: SNESSetTrustRegionTolerance(), SNESGetLagPreconditioner(), SNESSetLagJacobian(), SNESGetLagJacobian(), SNESSetGridSequence() @*/ PetscErrorCode SNESGetGridSequence(SNES snes,PetscInt *steps) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); *steps = snes->gridsequence; PetscFunctionReturn(0); } /*@ SNESGetLagPreconditioner - Indicates how often the preconditioner is rebuilt Not Collective Input Parameter: . snes - the SNES context Output Parameter: . lag - -1 indicates NEVER rebuild, 1 means rebuild every time the Jacobian is computed within a single nonlinear solve, 2 means every second time the Jacobian is built etc. -2 indicates rebuild preconditioner at next chance but then never rebuild after that Options Database Keys: . -snes_lag_preconditioner Notes: The default is 1 The preconditioner is ALWAYS built in the first iteration of a nonlinear solve unless lag is -1 Level: intermediate .seealso: SNESSetTrustRegionTolerance(), SNESSetLagPreconditioner() @*/ PetscErrorCode SNESGetLagPreconditioner(SNES snes,PetscInt *lag) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); *lag = snes->lagpreconditioner; PetscFunctionReturn(0); } /*@ SNESSetLagJacobian - Determines when the Jacobian is rebuilt in the nonlinear solve. See SNESSetLagPreconditioner() for determining how often the preconditioner is rebuilt. Logically Collective on SNES Input Parameters: + snes - the SNES context - lag - -1 indicates NEVER rebuild, 1 means rebuild every time the Jacobian is computed within a single nonlinear solve, 2 means every second time the Jacobian is built etc. -2 means rebuild at next chance but then never again Options Database Keys: . -snes_lag_jacobian Notes: The default is 1 The Jacobian is ALWAYS built in the first iteration of a nonlinear solve unless lag is -1 If -1 is used before the very first nonlinear solve the CODE WILL FAIL! because no Jacobian is used, use -2 to indicate you want it recomputed at the next Newton step but never again (unless it is reset to another value) Level: intermediate .seealso: SNESSetTrustRegionTolerance(), SNESGetLagPreconditioner(), SNESSetLagPreconditioner(), SNESGetLagJacobian() @*/ PetscErrorCode SNESSetLagJacobian(SNES snes,PetscInt lag) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); if (lag < -2) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"Lag must be -2, -1, 1 or greater"); if (!lag) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"Lag cannot be 0"); PetscValidLogicalCollectiveInt(snes,lag,2); snes->lagjacobian = lag; PetscFunctionReturn(0); } /*@ SNESGetLagJacobian - Indicates how often the Jacobian is rebuilt. See SNESGetLagPreconditioner() to determine when the preconditioner is rebuilt Not Collective Input Parameter: . snes - the SNES context Output Parameter: . lag - -1 indicates NEVER rebuild, 1 means rebuild every time the Jacobian is computed within a single nonlinear solve, 2 means every second time the Jacobian is built etc. Options Database Keys: . -snes_lag_jacobian Notes: The default is 1 The jacobian is ALWAYS built in the first iteration of a nonlinear solve unless lag is -1 Level: intermediate .seealso: SNESSetTrustRegionTolerance(), SNESSetLagJacobian(), SNESSetLagPreconditioner(), SNESGetLagPreconditioner() @*/ PetscErrorCode SNESGetLagJacobian(SNES snes,PetscInt *lag) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); *lag = snes->lagjacobian; PetscFunctionReturn(0); } /*@ SNESSetLagJacobianPersists - Set whether or not the Jacobian lagging persists through multiple solves Logically collective on SNES Input Parameter: + snes - the SNES context - flg - jacobian lagging persists if true Options Database Keys: . -snes_lag_jacobian_persists Notes: This is useful both for nonlinear preconditioning, where it's appropriate to have the Jacobian be stale by several solves, and for implicit time-stepping, where Jacobian lagging in the inner nonlinear solve over several timesteps may present huge efficiency gains. Level: developer .seealso: SNESSetLagPreconditionerPersists(), SNESSetLagJacobian(), SNESGetLagJacobian(), SNESGetNPC() @*/ PetscErrorCode SNESSetLagJacobianPersists(SNES snes,PetscBool flg) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidLogicalCollectiveBool(snes,flg,2); snes->lagjac_persist = flg; PetscFunctionReturn(0); } /*@ SNESSetLagPreconditionerPersists - Set whether or not the preconditioner lagging persists through multiple solves Logically Collective on SNES Input Parameter: + snes - the SNES context - flg - preconditioner lagging persists if true Options Database Keys: . -snes_lag_jacobian_persists Notes: This is useful both for nonlinear preconditioning, where it's appropriate to have the preconditioner be stale by several solves, and for implicit time-stepping, where preconditioner lagging in the inner nonlinear solve over several timesteps may present huge efficiency gains. Level: developer .seealso: SNESSetLagJacobianPersists(), SNESSetLagJacobian(), SNESGetLagJacobian(), SNESGetNPC() @*/ PetscErrorCode SNESSetLagPreconditionerPersists(SNES snes,PetscBool flg) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidLogicalCollectiveBool(snes,flg,2); snes->lagpre_persist = flg; PetscFunctionReturn(0); } /*@ SNESSetForceIteration - force SNESSolve() to take at least one iteration regardless of the initial residual norm Logically Collective on SNES Input Parameters: + snes - the SNES context - force - PETSC_TRUE require at least one iteration Options Database Keys: . -snes_force_iteration - Sets forcing an iteration Notes: This is used sometimes with TS to prevent TS from detecting a false steady state solution Level: intermediate .seealso: SNESSetTrustRegionTolerance(), SNESSetDivergenceTolerance() @*/ PetscErrorCode SNESSetForceIteration(SNES snes,PetscBool force) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); snes->forceiteration = force; PetscFunctionReturn(0); } /*@ SNESGetForceIteration - Whether or not to force SNESSolve() take at least one iteration regardless of the initial residual norm Logically Collective on SNES Input Parameters: . snes - the SNES context Output Parameter: . force - PETSC_TRUE requires at least one iteration. Level: intermediate .seealso: SNESSetForceIteration(), SNESSetTrustRegionTolerance(), SNESSetDivergenceTolerance() @*/ PetscErrorCode SNESGetForceIteration(SNES snes,PetscBool *force) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); *force = snes->forceiteration; PetscFunctionReturn(0); } /*@ SNESSetTolerances - Sets various parameters used in convergence tests. Logically Collective on SNES Input Parameters: + snes - the SNES context . abstol - absolute convergence tolerance . rtol - relative convergence tolerance . stol - convergence tolerance in terms of the norm of the change in the solution between steps, || delta x || < stol*|| x || . maxit - maximum number of iterations - maxf - maximum number of function evaluations (-1 indicates no limit) Options Database Keys: + -snes_atol - Sets abstol . -snes_rtol - Sets rtol . -snes_stol - Sets stol . -snes_max_it - Sets maxit - -snes_max_funcs - Sets maxf Notes: The default maximum number of iterations is 50. The default maximum number of function evaluations is 1000. Level: intermediate .seealso: SNESSetTrustRegionTolerance(), SNESSetDivergenceTolerance(), SNESSetForceIteration() @*/ PetscErrorCode SNESSetTolerances(SNES snes,PetscReal abstol,PetscReal rtol,PetscReal stol,PetscInt maxit,PetscInt maxf) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidLogicalCollectiveReal(snes,abstol,2); PetscValidLogicalCollectiveReal(snes,rtol,3); PetscValidLogicalCollectiveReal(snes,stol,4); PetscValidLogicalCollectiveInt(snes,maxit,5); PetscValidLogicalCollectiveInt(snes,maxf,6); if (abstol != PETSC_DEFAULT) { if (abstol < 0.0) SETERRQ1(PetscObjectComm((PetscObject)snes),PETSC_ERR_ARG_OUTOFRANGE,"Absolute tolerance %g must be non-negative",(double)abstol); snes->abstol = abstol; } if (rtol != PETSC_DEFAULT) { if (rtol < 0.0 || 1.0 <= rtol) SETERRQ1(PetscObjectComm((PetscObject)snes),PETSC_ERR_ARG_OUTOFRANGE,"Relative tolerance %g must be non-negative and less than 1.0",(double)rtol); snes->rtol = rtol; } if (stol != PETSC_DEFAULT) { if (stol < 0.0) SETERRQ1(PetscObjectComm((PetscObject)snes),PETSC_ERR_ARG_OUTOFRANGE,"Step tolerance %g must be non-negative",(double)stol); snes->stol = stol; } if (maxit != PETSC_DEFAULT) { if (maxit < 0) SETERRQ1(PetscObjectComm((PetscObject)snes),PETSC_ERR_ARG_OUTOFRANGE,"Maximum number of iterations %D must be non-negative",maxit); snes->max_its = maxit; } if (maxf != PETSC_DEFAULT) { if (maxf < -1) SETERRQ1(PetscObjectComm((PetscObject)snes),PETSC_ERR_ARG_OUTOFRANGE,"Maximum number of function evaluations %D must be -1 or nonnegative",maxf); snes->max_funcs = maxf; } snes->tolerancesset = PETSC_TRUE; PetscFunctionReturn(0); } /*@ SNESSetDivergenceTolerance - Sets the divergence tolerance used for the SNES divergence test. Logically Collective on SNES Input Parameters: + snes - the SNES context - divtol - the divergence tolerance. Use -1 to deactivate the test. Options Database Keys: . -snes_divergence_tolerance - Sets divtol Notes: The default divergence tolerance is 1e4. Level: intermediate .seealso: SNESSetTolerances(), SNESGetDivergenceTolerance @*/ PetscErrorCode SNESSetDivergenceTolerance(SNES snes,PetscReal divtol) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidLogicalCollectiveReal(snes,divtol,2); if (divtol != PETSC_DEFAULT) { snes->divtol = divtol; } else { snes->divtol = 1.0e4; } PetscFunctionReturn(0); } /*@ SNESGetTolerances - Gets various parameters used in convergence tests. Not Collective Input Parameters: + snes - the SNES context . atol - absolute convergence tolerance . rtol - relative convergence tolerance . stol - convergence tolerance in terms of the norm of the change in the solution between steps . maxit - maximum number of iterations - maxf - maximum number of function evaluations Notes: The user can specify NULL for any parameter that is not needed. Level: intermediate .seealso: SNESSetTolerances() @*/ PetscErrorCode SNESGetTolerances(SNES snes,PetscReal *atol,PetscReal *rtol,PetscReal *stol,PetscInt *maxit,PetscInt *maxf) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); if (atol) *atol = snes->abstol; if (rtol) *rtol = snes->rtol; if (stol) *stol = snes->stol; if (maxit) *maxit = snes->max_its; if (maxf) *maxf = snes->max_funcs; PetscFunctionReturn(0); } /*@ SNESGetDivergenceTolerance - Gets divergence tolerance used in divergence test. Not Collective Input Parameters: + snes - the SNES context - divtol - divergence tolerance Level: intermediate .seealso: SNESSetDivergenceTolerance() @*/ PetscErrorCode SNESGetDivergenceTolerance(SNES snes,PetscReal *divtol) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); if (divtol) *divtol = snes->divtol; PetscFunctionReturn(0); } /*@ SNESSetTrustRegionTolerance - Sets the trust region parameter tolerance. Logically Collective on SNES Input Parameters: + snes - the SNES context - tol - tolerance Options Database Key: . -snes_trtol - Sets tol Level: intermediate .seealso: SNESSetTolerances() @*/ PetscErrorCode SNESSetTrustRegionTolerance(SNES snes,PetscReal tol) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidLogicalCollectiveReal(snes,tol,2); snes->deltatol = tol; PetscFunctionReturn(0); } /* Duplicate the lg monitors for SNES from KSP; for some reason with dynamic libraries things don't work under Sun4 if we just use macros instead of functions */ PetscErrorCode SNESMonitorLGResidualNorm(SNES snes,PetscInt it,PetscReal norm,void *ctx) { PetscErrorCode ierr; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); ierr = KSPMonitorLGResidualNorm((KSP)snes,it,norm,ctx);CHKERRQ(ierr); PetscFunctionReturn(0); } PetscErrorCode SNESMonitorLGCreate(MPI_Comm comm,const char host[],const char label[],int x,int y,int m,int n,PetscDrawLG *lgctx) { PetscErrorCode ierr; PetscFunctionBegin; ierr = KSPMonitorLGResidualNormCreate(comm,host,label,x,y,m,n,lgctx);CHKERRQ(ierr); PetscFunctionReturn(0); } PETSC_INTERN PetscErrorCode SNESMonitorRange_Private(SNES,PetscInt,PetscReal*); PetscErrorCode SNESMonitorLGRange(SNES snes,PetscInt n,PetscReal rnorm,void *monctx) { PetscDrawLG lg; PetscErrorCode ierr; PetscReal x,y,per; PetscViewer v = (PetscViewer)monctx; static PetscReal prev; /* should be in the context */ PetscDraw draw; PetscFunctionBegin; PetscValidHeaderSpecific(v,PETSC_VIEWER_CLASSID,4); ierr = PetscViewerDrawGetDrawLG(v,0,&lg);CHKERRQ(ierr); if (!n) {ierr = PetscDrawLGReset(lg);CHKERRQ(ierr);} ierr = PetscDrawLGGetDraw(lg,&draw);CHKERRQ(ierr); ierr = PetscDrawSetTitle(draw,"Residual norm");CHKERRQ(ierr); x = (PetscReal)n; if (rnorm > 0.0) y = PetscLog10Real(rnorm); else y = -15.0; ierr = PetscDrawLGAddPoint(lg,&x,&y);CHKERRQ(ierr); if (n < 20 || !(n % 5) || snes->reason) { ierr = PetscDrawLGDraw(lg);CHKERRQ(ierr); ierr = PetscDrawLGSave(lg);CHKERRQ(ierr); } ierr = PetscViewerDrawGetDrawLG(v,1,&lg);CHKERRQ(ierr); if (!n) {ierr = PetscDrawLGReset(lg);CHKERRQ(ierr);} ierr = PetscDrawLGGetDraw(lg,&draw);CHKERRQ(ierr); ierr = PetscDrawSetTitle(draw,"% elemts > .2*max elemt");CHKERRQ(ierr); ierr = SNESMonitorRange_Private(snes,n,&per);CHKERRQ(ierr); x = (PetscReal)n; y = 100.0*per; ierr = PetscDrawLGAddPoint(lg,&x,&y);CHKERRQ(ierr); if (n < 20 || !(n % 5) || snes->reason) { ierr = PetscDrawLGDraw(lg);CHKERRQ(ierr); ierr = PetscDrawLGSave(lg);CHKERRQ(ierr); } ierr = PetscViewerDrawGetDrawLG(v,2,&lg);CHKERRQ(ierr); if (!n) {prev = rnorm;ierr = PetscDrawLGReset(lg);CHKERRQ(ierr);} ierr = PetscDrawLGGetDraw(lg,&draw);CHKERRQ(ierr); ierr = PetscDrawSetTitle(draw,"(norm -oldnorm)/oldnorm");CHKERRQ(ierr); x = (PetscReal)n; y = (prev - rnorm)/prev; ierr = PetscDrawLGAddPoint(lg,&x,&y);CHKERRQ(ierr); if (n < 20 || !(n % 5) || snes->reason) { ierr = PetscDrawLGDraw(lg);CHKERRQ(ierr); ierr = PetscDrawLGSave(lg);CHKERRQ(ierr); } ierr = PetscViewerDrawGetDrawLG(v,3,&lg);CHKERRQ(ierr); if (!n) {ierr = PetscDrawLGReset(lg);CHKERRQ(ierr);} ierr = PetscDrawLGGetDraw(lg,&draw);CHKERRQ(ierr); ierr = PetscDrawSetTitle(draw,"(norm -oldnorm)/oldnorm*(% > .2 max)");CHKERRQ(ierr); x = (PetscReal)n; y = (prev - rnorm)/(prev*per); if (n > 2) { /*skip initial crazy value */ ierr = PetscDrawLGAddPoint(lg,&x,&y);CHKERRQ(ierr); } if (n < 20 || !(n % 5) || snes->reason) { ierr = PetscDrawLGDraw(lg);CHKERRQ(ierr); ierr = PetscDrawLGSave(lg);CHKERRQ(ierr); } prev = rnorm; PetscFunctionReturn(0); } /*@ SNESMonitor - runs the user provided monitor routines, if they exist Collective on SNES Input Parameters: + snes - nonlinear solver context obtained from SNESCreate() . iter - iteration number - rnorm - relative norm of the residual Notes: This routine is called by the SNES implementations. It does not typically need to be called by the user. Level: developer .seealso: SNESMonitorSet() @*/ PetscErrorCode SNESMonitor(SNES snes,PetscInt iter,PetscReal rnorm) { PetscErrorCode ierr; PetscInt i,n = snes->numbermonitors; PetscFunctionBegin; ierr = VecLockReadPush(snes->vec_sol);CHKERRQ(ierr); for (i=0; imonitor[i])(snes,iter,rnorm,snes->monitorcontext[i]);CHKERRQ(ierr); } ierr = VecLockReadPop(snes->vec_sol);CHKERRQ(ierr); PetscFunctionReturn(0); } /* ------------ Routines to set performance monitoring options ----------- */ /*MC SNESMonitorFunction - functional form passed to SNESMonitorSet() to monitor convergence of nonlinear solver Synopsis: #include $ PetscErrorCode SNESMonitorFunction(SNES snes,PetscInt its, PetscReal norm,void *mctx) + snes - the SNES context . its - iteration number . norm - 2-norm function value (may be estimated) - mctx - [optional] monitoring context Level: advanced .seealso: SNESMonitorSet(), SNESMonitorGet() M*/ /*@C SNESMonitorSet - Sets an ADDITIONAL function that is to be used at every iteration of the nonlinear solver to display the iteration's progress. Logically Collective on SNES Input Parameters: + snes - the SNES context . f - the monitor function, see SNESMonitorFunction for the calling sequence . mctx - [optional] user-defined context for private data for the monitor routine (use NULL if no context is desired) - monitordestroy - [optional] routine that frees monitor context (may be NULL) Options Database Keys: + -snes_monitor - sets SNESMonitorDefault() . -snes_monitor_lg_residualnorm - sets line graph monitor, uses SNESMonitorLGCreate() - -snes_monitor_cancel - cancels all monitors that have been hardwired into a code by calls to SNESMonitorSet(), but does not cancel those set via the options database. Notes: Several different monitoring routines may be set by calling SNESMonitorSet() multiple times; all will be called in the order in which they were set. Fortran Notes: Only a single monitor function can be set for each SNES object Level: intermediate .seealso: SNESMonitorDefault(), SNESMonitorCancel(), SNESMonitorFunction @*/ PetscErrorCode SNESMonitorSet(SNES snes,PetscErrorCode (*f)(SNES,PetscInt,PetscReal,void*),void *mctx,PetscErrorCode (*monitordestroy)(void**)) { PetscInt i; PetscErrorCode ierr; PetscBool identical; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); for (i=0; inumbermonitors;i++) { ierr = PetscMonitorCompare((PetscErrorCode (*)(void))f,mctx,monitordestroy,(PetscErrorCode (*)(void))snes->monitor[i],snes->monitorcontext[i],snes->monitordestroy[i],&identical);CHKERRQ(ierr); if (identical) PetscFunctionReturn(0); } if (snes->numbermonitors >= MAXSNESMONITORS) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"Too many monitors set"); snes->monitor[snes->numbermonitors] = f; snes->monitordestroy[snes->numbermonitors] = monitordestroy; snes->monitorcontext[snes->numbermonitors++] = (void*)mctx; PetscFunctionReturn(0); } /*@ SNESMonitorCancel - Clears all the monitor functions for a SNES object. Logically Collective on SNES Input Parameters: . snes - the SNES context Options Database Key: . -snes_monitor_cancel - cancels all monitors that have been hardwired into a code by calls to SNESMonitorSet(), but does not cancel those set via the options database Notes: There is no way to clear one specific monitor from a SNES object. Level: intermediate .seealso: SNESMonitorDefault(), SNESMonitorSet() @*/ PetscErrorCode SNESMonitorCancel(SNES snes) { PetscErrorCode ierr; PetscInt i; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); for (i=0; inumbermonitors; i++) { if (snes->monitordestroy[i]) { ierr = (*snes->monitordestroy[i])(&snes->monitorcontext[i]);CHKERRQ(ierr); } } snes->numbermonitors = 0; PetscFunctionReturn(0); } /*MC SNESConvergenceTestFunction - functional form used for testing of convergence of nonlinear solver Synopsis: #include $ PetscErrorCode SNESConvergenceTest(SNES snes,PetscInt it,PetscReal xnorm,PetscReal gnorm,PetscReal f,SNESConvergedReason *reason,void *cctx) + snes - the SNES context . it - current iteration (0 is the first and is before any Newton step) . cctx - [optional] convergence context . reason - reason for convergence/divergence . xnorm - 2-norm of current iterate . gnorm - 2-norm of current step - f - 2-norm of function Level: intermediate .seealso: SNESSetConvergenceTest(), SNESGetConvergenceTest() M*/ /*@C SNESSetConvergenceTest - Sets the function that is to be used to test for convergence of the nonlinear iterative solution. Logically Collective on SNES Input Parameters: + snes - the SNES context . SNESConvergenceTestFunction - routine to test for convergence . cctx - [optional] context for private data for the convergence routine (may be NULL) - destroy - [optional] destructor for the context (may be NULL; PETSC_NULL_FUNCTION in Fortran) Level: advanced .seealso: SNESConvergedDefault(), SNESConvergedSkip(), SNESConvergenceTestFunction @*/ PetscErrorCode SNESSetConvergenceTest(SNES snes,PetscErrorCode (*SNESConvergenceTestFunction)(SNES,PetscInt,PetscReal,PetscReal,PetscReal,SNESConvergedReason*,void*),void *cctx,PetscErrorCode (*destroy)(void*)) { PetscErrorCode ierr; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); if (!SNESConvergenceTestFunction) SNESConvergenceTestFunction = SNESConvergedSkip; if (snes->ops->convergeddestroy) { ierr = (*snes->ops->convergeddestroy)(snes->cnvP);CHKERRQ(ierr); } snes->ops->converged = SNESConvergenceTestFunction; snes->ops->convergeddestroy = destroy; snes->cnvP = cctx; PetscFunctionReturn(0); } /*@ SNESGetConvergedReason - Gets the reason the SNES iteration was stopped. Not Collective Input Parameter: . snes - the SNES context Output Parameter: . reason - negative value indicates diverged, positive value converged, see SNESConvergedReason or the manual pages for the individual convergence tests for complete lists Options Database: . -snes_converged_reason - prints the reason to standard out Level: intermediate Notes: Should only be called after the call the SNESSolve() is complete, if it is called earlier it returns the value SNES__CONVERGED_ITERATING. .seealso: SNESSetConvergenceTest(), SNESSetConvergedReason(), SNESConvergedReason @*/ PetscErrorCode SNESGetConvergedReason(SNES snes,SNESConvergedReason *reason) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidPointer(reason,2); *reason = snes->reason; PetscFunctionReturn(0); } /*@ SNESSetConvergedReason - Sets the reason the SNES iteration was stopped. Not Collective Input Parameters: + snes - the SNES context - reason - negative value indicates diverged, positive value converged, see SNESConvergedReason or the manual pages for the individual convergence tests for complete lists Level: intermediate .seealso: SNESGetConvergedReason(), SNESSetConvergenceTest(), SNESConvergedReason @*/ PetscErrorCode SNESSetConvergedReason(SNES snes,SNESConvergedReason reason) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); snes->reason = reason; PetscFunctionReturn(0); } /*@ SNESSetConvergenceHistory - Sets the array used to hold the convergence history. Logically Collective on SNES Input Parameters: + snes - iterative context obtained from SNESCreate() . a - array to hold history, this array will contain the function norms computed at each step . its - integer array holds the number of linear iterations for each solve. . na - size of a and its - reset - PETSC_TRUE indicates each new nonlinear solve resets the history counter to zero, else it continues storing new values for new nonlinear solves after the old ones Notes: If 'a' and 'its' are NULL then space is allocated for the history. If 'na' PETSC_DECIDE or PETSC_DEFAULT then a default array of length 10000 is allocated. This routine is useful, e.g., when running a code for purposes of accurate performance monitoring, when no I/O should be done during the section of code that is being timed. Level: intermediate .seealso: SNESGetConvergenceHistory() @*/ PetscErrorCode SNESSetConvergenceHistory(SNES snes,PetscReal a[],PetscInt its[],PetscInt na,PetscBool reset) { PetscErrorCode ierr; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); if (a) PetscValidScalarPointer(a,2); if (its) PetscValidIntPointer(its,3); if (!a) { if (na == PETSC_DECIDE || na == PETSC_DEFAULT) na = 1000; ierr = PetscCalloc2(na,&a,na,&its);CHKERRQ(ierr); snes->conv_hist_alloc = PETSC_TRUE; } snes->conv_hist = a; snes->conv_hist_its = its; snes->conv_hist_max = na; snes->conv_hist_len = 0; snes->conv_hist_reset = reset; PetscFunctionReturn(0); } #if defined(PETSC_HAVE_MATLAB_ENGINE) #include /* MATLAB include file */ #include /* MATLAB include file */ PETSC_EXTERN mxArray *SNESGetConvergenceHistoryMatlab(SNES snes) { mxArray *mat; PetscInt i; PetscReal *ar; PetscFunctionBegin; mat = mxCreateDoubleMatrix(snes->conv_hist_len,1,mxREAL); ar = (PetscReal*) mxGetData(mat); for (i=0; iconv_hist_len; i++) ar[i] = snes->conv_hist[i]; PetscFunctionReturn(mat); } #endif /*@C SNESGetConvergenceHistory - Gets the array used to hold the convergence history. Not Collective Input Parameter: . snes - iterative context obtained from SNESCreate() Output Parameters: + a - array to hold history . its - integer array holds the number of linear iterations (or negative if not converged) for each solve. - na - size of a and its Notes: The calling sequence for this routine in Fortran is $ call SNESGetConvergenceHistory(SNES snes, integer na, integer ierr) This routine is useful, e.g., when running a code for purposes of accurate performance monitoring, when no I/O should be done during the section of code that is being timed. Level: intermediate .seealso: SNESSetConvergencHistory() @*/ PetscErrorCode SNESGetConvergenceHistory(SNES snes,PetscReal *a[],PetscInt *its[],PetscInt *na) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); if (a) *a = snes->conv_hist; if (its) *its = snes->conv_hist_its; if (na) *na = snes->conv_hist_len; PetscFunctionReturn(0); } /*@C SNESSetUpdate - Sets the general-purpose update function called at the beginning of every iteration of the nonlinear solve. Specifically it is called just before the Jacobian is "evaluated". Logically Collective on SNES Input Parameters: + snes - The nonlinear solver context - func - The function Calling sequence of func: $ func (SNES snes, PetscInt step); . step - The current step of the iteration Level: advanced Note: This is NOT what one uses to update the ghost points before a function evaluation, that should be done at the beginning of your FormFunction() This is not used by most users. .seealso SNESSetJacobian(), SNESSolve() @*/ PetscErrorCode SNESSetUpdate(SNES snes, PetscErrorCode (*func)(SNES, PetscInt)) { PetscFunctionBegin; PetscValidHeaderSpecific(snes, SNES_CLASSID,1); snes->ops->update = func; PetscFunctionReturn(0); } /* SNESScaleStep_Private - Scales a step so that its length is less than the positive parameter delta. Input Parameters: + snes - the SNES context . y - approximate solution of linear system . fnorm - 2-norm of current function - delta - trust region size Output Parameters: + gpnorm - predicted function norm at the new point, assuming local linearization. The value is zero if the step lies within the trust region, and exceeds zero otherwise. - ynorm - 2-norm of the step Note: For non-trust region methods such as SNESNEWTONLS, the parameter delta is set to be the maximum allowable step size. */ PetscErrorCode SNESScaleStep_Private(SNES snes,Vec y,PetscReal *fnorm,PetscReal *delta,PetscReal *gpnorm,PetscReal *ynorm) { PetscReal nrm; PetscScalar cnorm; PetscErrorCode ierr; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidHeaderSpecific(y,VEC_CLASSID,2); PetscCheckSameComm(snes,1,y,2); ierr = VecNorm(y,NORM_2,&nrm);CHKERRQ(ierr); if (nrm > *delta) { nrm = *delta/nrm; *gpnorm = (1.0 - nrm)*(*fnorm); cnorm = nrm; ierr = VecScale(y,cnorm);CHKERRQ(ierr); *ynorm = *delta; } else { *gpnorm = 0.0; *ynorm = nrm; } PetscFunctionReturn(0); } /*@ SNESReasonView - Displays the reason a SNES solve converged or diverged to a viewer Collective on SNES Parameter: + snes - iterative context obtained from SNESCreate() - viewer - the viewer to display the reason Options Database Keys: . -snes_converged_reason - print reason for converged or diverged, also prints number of iterations Level: beginner .seealso: SNESCreate(), SNESSetUp(), SNESDestroy(), SNESSetTolerances(), SNESConvergedDefault() @*/ PetscErrorCode SNESReasonView(SNES snes,PetscViewer viewer) { PetscViewerFormat format; PetscBool isAscii; PetscErrorCode ierr; PetscFunctionBegin; ierr = PetscObjectTypeCompare((PetscObject)viewer,PETSCVIEWERASCII,&isAscii);CHKERRQ(ierr); if (isAscii) { ierr = PetscViewerGetFormat(viewer, &format);CHKERRQ(ierr); ierr = PetscViewerASCIIAddTab(viewer,((PetscObject)snes)->tablevel);CHKERRQ(ierr); if (format == PETSC_VIEWER_ASCII_INFO_DETAIL) { DM dm; Vec u; PetscDS prob; PetscInt Nf, f; PetscErrorCode (**exactSol)(PetscInt, PetscReal, const PetscReal[], PetscInt, PetscScalar[], void *); void **exactCtx; PetscReal error; ierr = SNESGetDM(snes, &dm);CHKERRQ(ierr); ierr = SNESGetSolution(snes, &u);CHKERRQ(ierr); ierr = DMGetDS(dm, &prob);CHKERRQ(ierr); ierr = PetscDSGetNumFields(prob, &Nf);CHKERRQ(ierr); ierr = PetscMalloc2(Nf, &exactSol, Nf, &exactCtx);CHKERRQ(ierr); for (f = 0; f < Nf; ++f) {ierr = PetscDSGetExactSolution(prob, f, &exactSol[f], &exactCtx[f]);CHKERRQ(ierr);} ierr = DMComputeL2Diff(dm, 0.0, exactSol, exactCtx, u, &error);CHKERRQ(ierr); ierr = PetscFree2(exactSol, exactCtx);CHKERRQ(ierr); if (error < 1.0e-11) {ierr = PetscViewerASCIIPrintf(viewer, "L_2 Error: < 1.0e-11\n");CHKERRQ(ierr);} else {ierr = PetscViewerASCIIPrintf(viewer, "L_2 Error: %g\n", error);CHKERRQ(ierr);} } if (snes->reason > 0) { if (((PetscObject) snes)->prefix) { ierr = PetscViewerASCIIPrintf(viewer,"Nonlinear %s solve converged due to %s iterations %D\n",((PetscObject) snes)->prefix,SNESConvergedReasons[snes->reason],snes->iter);CHKERRQ(ierr); } else { ierr = PetscViewerASCIIPrintf(viewer,"Nonlinear solve converged due to %s iterations %D\n",SNESConvergedReasons[snes->reason],snes->iter);CHKERRQ(ierr); } } else { if (((PetscObject) snes)->prefix) { ierr = PetscViewerASCIIPrintf(viewer,"Nonlinear %s solve did not converge due to %s iterations %D\n",((PetscObject) snes)->prefix,SNESConvergedReasons[snes->reason],snes->iter);CHKERRQ(ierr); } else { ierr = PetscViewerASCIIPrintf(viewer,"Nonlinear solve did not converge due to %s iterations %D\n",SNESConvergedReasons[snes->reason],snes->iter);CHKERRQ(ierr); } } ierr = PetscViewerASCIISubtractTab(viewer,((PetscObject)snes)->tablevel);CHKERRQ(ierr); } PetscFunctionReturn(0); } /*@C SNESReasonViewFromOptions - Processes command line options to determine if/how a SNESReason is to be viewed. Collective on SNES Input Parameters: . snes - the SNES object Level: intermediate @*/ PetscErrorCode SNESReasonViewFromOptions(SNES snes) { PetscErrorCode ierr; PetscViewer viewer; PetscBool flg; static PetscBool incall = PETSC_FALSE; PetscViewerFormat format; PetscFunctionBegin; if (incall) PetscFunctionReturn(0); incall = PETSC_TRUE; ierr = PetscOptionsGetViewer(PetscObjectComm((PetscObject)snes),((PetscObject)snes)->options,((PetscObject)snes)->prefix,"-snes_converged_reason",&viewer,&format,&flg);CHKERRQ(ierr); if (flg) { ierr = PetscViewerPushFormat(viewer,format);CHKERRQ(ierr); ierr = SNESReasonView(snes,viewer);CHKERRQ(ierr); ierr = PetscViewerPopFormat(viewer);CHKERRQ(ierr); ierr = PetscViewerDestroy(&viewer);CHKERRQ(ierr); } incall = PETSC_FALSE; PetscFunctionReturn(0); } /*@ SNESSolve - Solves a nonlinear system F(x) = b. Call SNESSolve() after calling SNESCreate() and optional routines of the form SNESSetXXX(). Collective on SNES Input Parameters: + snes - the SNES context . b - the constant part of the equation F(x) = b, or NULL to use zero. - x - the solution vector. Notes: The user should initialize the vector,x, with the initial guess for the nonlinear solve prior to calling SNESSolve. In particular, to employ an initial guess of zero, the user should explicitly set this vector to zero by calling VecSet(). Level: beginner .seealso: SNESCreate(), SNESDestroy(), SNESSetFunction(), SNESSetJacobian(), SNESSetGridSequence(), SNESGetSolution() @*/ PetscErrorCode SNESSolve(SNES snes,Vec b,Vec x) { PetscErrorCode ierr; PetscBool flg; PetscInt grid; Vec xcreated = NULL; DM dm; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); if (x) PetscValidHeaderSpecific(x,VEC_CLASSID,3); if (x) PetscCheckSameComm(snes,1,x,3); if (b) PetscValidHeaderSpecific(b,VEC_CLASSID,2); if (b) PetscCheckSameComm(snes,1,b,2); /* High level operations using the nonlinear solver */ { PetscViewer viewer; PetscViewerFormat format; PetscInt num; PetscBool flg; static PetscBool incall = PETSC_FALSE; if (!incall) { /* Estimate the convergence rate of the discretization */ ierr = PetscOptionsGetViewer(PetscObjectComm((PetscObject) snes),((PetscObject)snes)->options, ((PetscObject) snes)->prefix, "-snes_convergence_estimate", &viewer, &format, &flg);CHKERRQ(ierr); if (flg) { PetscConvEst conv; DM dm; PetscReal *alpha; /* Convergence rate of the solution error for each field in the L_2 norm */ PetscInt Nf; incall = PETSC_TRUE; ierr = SNESGetDM(snes, &dm);CHKERRQ(ierr); ierr = DMGetNumFields(dm, &Nf);CHKERRQ(ierr); ierr = PetscCalloc1(Nf, &alpha);CHKERRQ(ierr); ierr = PetscConvEstCreate(PetscObjectComm((PetscObject) snes), &conv);CHKERRQ(ierr); ierr = PetscConvEstSetSolver(conv, (PetscObject) snes);CHKERRQ(ierr); ierr = PetscConvEstSetFromOptions(conv);CHKERRQ(ierr); ierr = PetscConvEstSetUp(conv);CHKERRQ(ierr); ierr = PetscConvEstGetConvRate(conv, alpha);CHKERRQ(ierr); ierr = PetscViewerPushFormat(viewer, format);CHKERRQ(ierr); ierr = PetscConvEstRateView(conv, alpha, viewer);CHKERRQ(ierr); ierr = PetscViewerPopFormat(viewer);CHKERRQ(ierr); ierr = PetscViewerDestroy(&viewer);CHKERRQ(ierr); ierr = PetscConvEstDestroy(&conv);CHKERRQ(ierr); ierr = PetscFree(alpha);CHKERRQ(ierr); incall = PETSC_FALSE; } /* Adaptively refine the initial grid */ num = 1; ierr = PetscOptionsGetInt(NULL, ((PetscObject) snes)->prefix, "-snes_adapt_initial", &num, &flg);CHKERRQ(ierr); if (flg) { DMAdaptor adaptor; incall = PETSC_TRUE; ierr = DMAdaptorCreate(PETSC_COMM_WORLD, &adaptor);CHKERRQ(ierr); ierr = DMAdaptorSetSolver(adaptor, snes);CHKERRQ(ierr); ierr = DMAdaptorSetSequenceLength(adaptor, num);CHKERRQ(ierr); ierr = DMAdaptorSetFromOptions(adaptor);CHKERRQ(ierr); ierr = DMAdaptorSetUp(adaptor);CHKERRQ(ierr); ierr = DMAdaptorAdapt(adaptor, x, DM_ADAPTATION_INITIAL, &dm, &x);CHKERRQ(ierr); ierr = DMAdaptorDestroy(&adaptor);CHKERRQ(ierr); incall = PETSC_FALSE; } /* Use grid sequencing to adapt */ num = 0; ierr = PetscOptionsGetInt(NULL, ((PetscObject) snes)->prefix, "-snes_adapt_sequence", &num, NULL);CHKERRQ(ierr); if (num) { DMAdaptor adaptor; incall = PETSC_TRUE; ierr = DMAdaptorCreate(PETSC_COMM_WORLD, &adaptor);CHKERRQ(ierr); ierr = DMAdaptorSetSolver(adaptor, snes);CHKERRQ(ierr); ierr = DMAdaptorSetSequenceLength(adaptor, num);CHKERRQ(ierr); ierr = DMAdaptorSetFromOptions(adaptor);CHKERRQ(ierr); ierr = DMAdaptorSetUp(adaptor);CHKERRQ(ierr); ierr = DMAdaptorAdapt(adaptor, x, DM_ADAPTATION_SEQUENTIAL, &dm, &x);CHKERRQ(ierr); ierr = DMAdaptorDestroy(&adaptor);CHKERRQ(ierr); incall = PETSC_FALSE; } } } if (!x) { ierr = SNESGetDM(snes,&dm);CHKERRQ(ierr); ierr = DMCreateGlobalVector(dm,&xcreated);CHKERRQ(ierr); x = xcreated; } ierr = SNESViewFromOptions(snes,NULL,"-snes_view_pre");CHKERRQ(ierr); for (grid=0; gridgridsequence; grid++) {ierr = PetscViewerASCIIPushTab(PETSC_VIEWER_STDOUT_(PetscObjectComm((PetscObject)snes)));CHKERRQ(ierr);} for (grid=0; gridgridsequence+1; grid++) { /* set solution vector */ if (!grid) {ierr = PetscObjectReference((PetscObject)x);CHKERRQ(ierr);} ierr = VecDestroy(&snes->vec_sol);CHKERRQ(ierr); snes->vec_sol = x; ierr = SNESGetDM(snes,&dm);CHKERRQ(ierr); /* set affine vector if provided */ if (b) { ierr = PetscObjectReference((PetscObject)b);CHKERRQ(ierr); } ierr = VecDestroy(&snes->vec_rhs);CHKERRQ(ierr); snes->vec_rhs = b; if (snes->vec_rhs && (snes->vec_func == snes->vec_rhs)) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_IDN,"Right hand side vector cannot be function vector"); if (snes->vec_func == snes->vec_sol) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_IDN,"Solution vector cannot be function vector"); if (snes->vec_rhs == snes->vec_sol) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_IDN,"Solution vector cannot be right hand side vector"); if (!snes->vec_sol_update /* && snes->vec_sol */) { ierr = VecDuplicate(snes->vec_sol,&snes->vec_sol_update);CHKERRQ(ierr); ierr = PetscLogObjectParent((PetscObject)snes,(PetscObject)snes->vec_sol_update);CHKERRQ(ierr); } ierr = DMShellSetGlobalVector(dm,snes->vec_sol);CHKERRQ(ierr); ierr = SNESSetUp(snes);CHKERRQ(ierr); if (!grid) { if (snes->ops->computeinitialguess) { ierr = (*snes->ops->computeinitialguess)(snes,snes->vec_sol,snes->initialguessP);CHKERRQ(ierr); } } if (snes->conv_hist_reset) snes->conv_hist_len = 0; if (snes->counters_reset) {snes->nfuncs = 0; snes->linear_its = 0; snes->numFailures = 0;} ierr = PetscLogEventBegin(SNES_Solve,snes,0,0,0);CHKERRQ(ierr); ierr = (*snes->ops->solve)(snes);CHKERRQ(ierr); ierr = PetscLogEventEnd(SNES_Solve,snes,0,0,0);CHKERRQ(ierr); if (!snes->reason) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_PLIB,"Internal error, solver returned without setting converged reason"); snes->domainerror = PETSC_FALSE; /* clear the flag if it has been set */ if (snes->lagjac_persist) snes->jac_iter += snes->iter; if (snes->lagpre_persist) snes->pre_iter += snes->iter; ierr = PetscOptionsGetViewer(PetscObjectComm((PetscObject)snes),((PetscObject)snes)->options,((PetscObject)snes)->prefix,"-snes_test_local_min",NULL,NULL,&flg);CHKERRQ(ierr); if (flg && !PetscPreLoadingOn) { ierr = SNESTestLocalMin(snes);CHKERRQ(ierr); } ierr = SNESReasonViewFromOptions(snes);CHKERRQ(ierr); if (snes->errorifnotconverged && snes->reason < 0) SETERRQ(PetscObjectComm((PetscObject)snes),PETSC_ERR_NOT_CONVERGED,"SNESSolve has not converged"); if (snes->reason < 0) break; if (grid < snes->gridsequence) { DM fine; Vec xnew; Mat interp; ierr = DMRefine(snes->dm,PetscObjectComm((PetscObject)snes),&fine);CHKERRQ(ierr); if (!fine) SETERRQ(PetscObjectComm((PetscObject)snes),PETSC_ERR_ARG_INCOMP,"DMRefine() did not perform any refinement, cannot continue grid sequencing"); ierr = DMCreateInterpolation(snes->dm,fine,&interp,NULL);CHKERRQ(ierr); ierr = DMCreateGlobalVector(fine,&xnew);CHKERRQ(ierr); ierr = MatInterpolate(interp,x,xnew);CHKERRQ(ierr); ierr = DMInterpolate(snes->dm,interp,fine);CHKERRQ(ierr); ierr = MatDestroy(&interp);CHKERRQ(ierr); x = xnew; ierr = SNESReset(snes);CHKERRQ(ierr); ierr = SNESSetDM(snes,fine);CHKERRQ(ierr); ierr = SNESResetFromOptions(snes);CHKERRQ(ierr); ierr = DMDestroy(&fine);CHKERRQ(ierr); ierr = PetscViewerASCIIPopTab(PETSC_VIEWER_STDOUT_(PetscObjectComm((PetscObject)snes)));CHKERRQ(ierr); } } ierr = SNESViewFromOptions(snes,NULL,"-snes_view");CHKERRQ(ierr); ierr = VecViewFromOptions(snes->vec_sol,(PetscObject)snes,"-snes_view_solution");CHKERRQ(ierr); ierr = VecDestroy(&xcreated);CHKERRQ(ierr); ierr = PetscObjectSAWsBlock((PetscObject)snes);CHKERRQ(ierr); PetscFunctionReturn(0); } /* --------- Internal routines for SNES Package --------- */ /*@C SNESSetType - Sets the method for the nonlinear solver. Collective on SNES Input Parameters: + snes - the SNES context - type - a known method Options Database Key: . -snes_type - Sets the method; use -help for a list of available methods (for instance, newtonls or newtontr) Notes: See "petsc/include/petscsnes.h" for available methods (for instance) + SNESNEWTONLS - Newton's method with line search (systems of nonlinear equations) - SNESNEWTONTR - Newton's method with trust region (systems of nonlinear equations) Normally, it is best to use the SNESSetFromOptions() command and then set the SNES solver type from the options database rather than by using this routine. Using the options database provides the user with maximum flexibility in evaluating the many nonlinear solvers. The SNESSetType() routine is provided for those situations where it is necessary to set the nonlinear solver independently of the command line or options database. This might be the case, for example, when the choice of solver changes during the execution of the program, and the user's application is taking responsibility for choosing the appropriate method. Developer Notes: SNESRegister() adds a constructor for a new SNESType to SNESList, SNESSetType() locates the constructor in that list and calls it to create the spexific object. Level: intermediate .seealso: SNESType, SNESCreate(), SNESDestroy(), SNESGetType(), SNESSetFromOptions() @*/ PetscErrorCode SNESSetType(SNES snes,SNESType type) { PetscErrorCode ierr,(*r)(SNES); PetscBool match; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidCharPointer(type,2); ierr = PetscObjectTypeCompare((PetscObject)snes,type,&match);CHKERRQ(ierr); if (match) PetscFunctionReturn(0); ierr = PetscFunctionListFind(SNESList,type,&r);CHKERRQ(ierr); if (!r) SETERRQ1(PETSC_COMM_SELF,PETSC_ERR_ARG_UNKNOWN_TYPE,"Unable to find requested SNES type %s",type); /* Destroy the previous private SNES context */ if (snes->ops->destroy) { ierr = (*(snes)->ops->destroy)(snes);CHKERRQ(ierr); snes->ops->destroy = NULL; } /* Reinitialize function pointers in SNESOps structure */ snes->ops->setup = 0; snes->ops->solve = 0; snes->ops->view = 0; snes->ops->setfromoptions = 0; snes->ops->destroy = 0; /* It may happen the user has customized the line search before calling SNESSetType */ if (((PetscObject)snes)->type_name) { ierr = SNESLineSearchDestroy(&snes->linesearch);CHKERRQ(ierr); } /* Call the SNESCreate_XXX routine for this particular Nonlinear solver */ snes->setupcalled = PETSC_FALSE; ierr = PetscObjectChangeTypeName((PetscObject)snes,type);CHKERRQ(ierr); ierr = (*r)(snes);CHKERRQ(ierr); PetscFunctionReturn(0); } /*@C SNESGetType - Gets the SNES method type and name (as a string). Not Collective Input Parameter: . snes - nonlinear solver context Output Parameter: . type - SNES method (a character string) Level: intermediate @*/ PetscErrorCode SNESGetType(SNES snes,SNESType *type) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidPointer(type,2); *type = ((PetscObject)snes)->type_name; PetscFunctionReturn(0); } /*@ SNESSetSolution - Sets the solution vector for use by the SNES routines. Logically Collective on SNES Input Parameters: + snes - the SNES context obtained from SNESCreate() - u - the solution vector Level: beginner @*/ PetscErrorCode SNESSetSolution(SNES snes, Vec u) { DM dm; PetscErrorCode ierr; PetscFunctionBegin; PetscValidHeaderSpecific(snes, SNES_CLASSID, 1); PetscValidHeaderSpecific(u, VEC_CLASSID, 2); ierr = PetscObjectReference((PetscObject) u);CHKERRQ(ierr); ierr = VecDestroy(&snes->vec_sol);CHKERRQ(ierr); snes->vec_sol = u; ierr = SNESGetDM(snes, &dm);CHKERRQ(ierr); ierr = DMShellSetGlobalVector(dm, u);CHKERRQ(ierr); PetscFunctionReturn(0); } /*@ SNESGetSolution - Returns the vector where the approximate solution is stored. This is the fine grid solution when using SNESSetGridSequence(). Not Collective, but Vec is parallel if SNES is parallel Input Parameter: . snes - the SNES context Output Parameter: . x - the solution Level: intermediate .seealso: SNESGetSolutionUpdate(), SNESGetFunction() @*/ PetscErrorCode SNESGetSolution(SNES snes,Vec *x) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidPointer(x,2); *x = snes->vec_sol; PetscFunctionReturn(0); } /*@ SNESGetSolutionUpdate - Returns the vector where the solution update is stored. Not Collective, but Vec is parallel if SNES is parallel Input Parameter: . snes - the SNES context Output Parameter: . x - the solution update Level: advanced .seealso: SNESGetSolution(), SNESGetFunction() @*/ PetscErrorCode SNESGetSolutionUpdate(SNES snes,Vec *x) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidPointer(x,2); *x = snes->vec_sol_update; PetscFunctionReturn(0); } /*@C SNESGetFunction - Returns the vector where the function is stored. Not Collective, but Vec is parallel if SNES is parallel. Collective if Vec is requested, but has not been created yet. Input Parameter: . snes - the SNES context Output Parameter: + r - the vector that is used to store residuals (or NULL if you don't want it) . f - the function (or NULL if you don't want it); see SNESFunction for calling sequence details - ctx - the function context (or NULL if you don't want it) Level: advanced Notes: The vector r DOES NOT, in general contain the current value of the SNES nonlinear function .seealso: SNESSetFunction(), SNESGetSolution(), SNESFunction @*/ PetscErrorCode SNESGetFunction(SNES snes,Vec *r,PetscErrorCode (**f)(SNES,Vec,Vec,void*),void **ctx) { PetscErrorCode ierr; DM dm; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); if (r) { if (!snes->vec_func) { if (snes->vec_rhs) { ierr = VecDuplicate(snes->vec_rhs,&snes->vec_func);CHKERRQ(ierr); } else if (snes->vec_sol) { ierr = VecDuplicate(snes->vec_sol,&snes->vec_func);CHKERRQ(ierr); } else if (snes->dm) { ierr = DMCreateGlobalVector(snes->dm,&snes->vec_func);CHKERRQ(ierr); } } *r = snes->vec_func; } ierr = SNESGetDM(snes,&dm);CHKERRQ(ierr); ierr = DMSNESGetFunction(dm,f,ctx);CHKERRQ(ierr); PetscFunctionReturn(0); } /*@C SNESGetNGS - Returns the NGS function and context. Input Parameter: . snes - the SNES context Output Parameter: + f - the function (or NULL) see SNESNGSFunction for details - ctx - the function context (or NULL) Level: advanced .seealso: SNESSetNGS(), SNESGetFunction() @*/ PetscErrorCode SNESGetNGS (SNES snes, PetscErrorCode (**f)(SNES, Vec, Vec, void*), void ** ctx) { PetscErrorCode ierr; DM dm; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); ierr = SNESGetDM(snes,&dm);CHKERRQ(ierr); ierr = DMSNESGetNGS(dm,f,ctx);CHKERRQ(ierr); PetscFunctionReturn(0); } /*@C SNESSetOptionsPrefix - Sets the prefix used for searching for all SNES options in the database. Logically Collective on SNES Input Parameter: + snes - the SNES context - prefix - the prefix to prepend to all option names Notes: A hyphen (-) must NOT be given at the beginning of the prefix name. The first character of all runtime options is AUTOMATICALLY the hyphen. Level: advanced .seealso: SNESSetFromOptions() @*/ PetscErrorCode SNESSetOptionsPrefix(SNES snes,const char prefix[]) { PetscErrorCode ierr; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); ierr = PetscObjectSetOptionsPrefix((PetscObject)snes,prefix);CHKERRQ(ierr); if (!snes->ksp) {ierr = SNESGetKSP(snes,&snes->ksp);CHKERRQ(ierr);} if (snes->linesearch) { ierr = SNESGetLineSearch(snes,&snes->linesearch);CHKERRQ(ierr); ierr = PetscObjectSetOptionsPrefix((PetscObject)snes->linesearch,prefix);CHKERRQ(ierr); } ierr = KSPSetOptionsPrefix(snes->ksp,prefix);CHKERRQ(ierr); PetscFunctionReturn(0); } /*@C SNESAppendOptionsPrefix - Appends to the prefix used for searching for all SNES options in the database. Logically Collective on SNES Input Parameters: + snes - the SNES context - prefix - the prefix to prepend to all option names Notes: A hyphen (-) must NOT be given at the beginning of the prefix name. The first character of all runtime options is AUTOMATICALLY the hyphen. Level: advanced .seealso: SNESGetOptionsPrefix() @*/ PetscErrorCode SNESAppendOptionsPrefix(SNES snes,const char prefix[]) { PetscErrorCode ierr; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); ierr = PetscObjectAppendOptionsPrefix((PetscObject)snes,prefix);CHKERRQ(ierr); if (!snes->ksp) {ierr = SNESGetKSP(snes,&snes->ksp);CHKERRQ(ierr);} if (snes->linesearch) { ierr = SNESGetLineSearch(snes,&snes->linesearch);CHKERRQ(ierr); ierr = PetscObjectAppendOptionsPrefix((PetscObject)snes->linesearch,prefix);CHKERRQ(ierr); } ierr = KSPAppendOptionsPrefix(snes->ksp,prefix);CHKERRQ(ierr); PetscFunctionReturn(0); } /*@C SNESGetOptionsPrefix - Sets the prefix used for searching for all SNES options in the database. Not Collective Input Parameter: . snes - the SNES context Output Parameter: . prefix - pointer to the prefix string used Notes: On the fortran side, the user should pass in a string 'prefix' of sufficient length to hold the prefix. Level: advanced .seealso: SNESAppendOptionsPrefix() @*/ PetscErrorCode SNESGetOptionsPrefix(SNES snes,const char *prefix[]) { PetscErrorCode ierr; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); ierr = PetscObjectGetOptionsPrefix((PetscObject)snes,prefix);CHKERRQ(ierr); PetscFunctionReturn(0); } /*@C SNESRegister - Adds a method to the nonlinear solver package. Not collective Input Parameters: + name_solver - name of a new user-defined solver - routine_create - routine to create method context Notes: SNESRegister() may be called multiple times to add several user-defined solvers. Sample usage: .vb SNESRegister("my_solver",MySolverCreate); .ve Then, your solver can be chosen with the procedural interface via $ SNESSetType(snes,"my_solver") or at runtime via the option $ -snes_type my_solver Level: advanced Note: If your function is not being put into a shared library then use SNESRegister() instead .seealso: SNESRegisterAll(), SNESRegisterDestroy() Level: advanced @*/ PetscErrorCode SNESRegister(const char sname[],PetscErrorCode (*function)(SNES)) { PetscErrorCode ierr; PetscFunctionBegin; ierr = SNESInitializePackage();CHKERRQ(ierr); ierr = PetscFunctionListAdd(&SNESList,sname,function);CHKERRQ(ierr); PetscFunctionReturn(0); } PetscErrorCode SNESTestLocalMin(SNES snes) { PetscErrorCode ierr; PetscInt N,i,j; Vec u,uh,fh; PetscScalar value; PetscReal norm; PetscFunctionBegin; ierr = SNESGetSolution(snes,&u);CHKERRQ(ierr); ierr = VecDuplicate(u,&uh);CHKERRQ(ierr); ierr = VecDuplicate(u,&fh);CHKERRQ(ierr); /* currently only works for sequential */ ierr = PetscPrintf(PETSC_COMM_WORLD,"Testing FormFunction() for local min\n");CHKERRQ(ierr); ierr = VecGetSize(u,&N);CHKERRQ(ierr); for (i=0; i - Sets rtol0 . -snes_ksp_ew_rtolmax - Sets rtolmax . -snes_ksp_ew_gamma - Sets gamma . -snes_ksp_ew_alpha - Sets alpha . -snes_ksp_ew_alpha2 - Sets alpha2 - -snes_ksp_ew_threshold - Sets threshold Notes: Currently, the default is to use a constant relative tolerance for the inner linear solvers. Alternatively, one can use the Eisenstat-Walker method, where the relative convergence tolerance is reset at each Newton iteration according progress of the nonlinear solver. Level: advanced Reference: S. C. Eisenstat and H. F. Walker, "Choosing the forcing terms in an inexact Newton method", SISC 17 (1), pp.16-32, 1996. .seealso: SNESKSPGetUseEW(), SNESKSPGetParametersEW(), SNESKSPSetParametersEW() @*/ PetscErrorCode SNESKSPSetUseEW(SNES snes,PetscBool flag) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidLogicalCollectiveBool(snes,flag,2); snes->ksp_ewconv = flag; PetscFunctionReturn(0); } /*@ SNESKSPGetUseEW - Gets if SNES is using Eisenstat-Walker method for computing relative tolerance for linear solvers within an inexact Newton method. Not Collective Input Parameter: . snes - SNES context Output Parameter: . flag - PETSC_TRUE or PETSC_FALSE Notes: Currently, the default is to use a constant relative tolerance for the inner linear solvers. Alternatively, one can use the Eisenstat-Walker method, where the relative convergence tolerance is reset at each Newton iteration according progress of the nonlinear solver. Level: advanced Reference: S. C. Eisenstat and H. F. Walker, "Choosing the forcing terms in an inexact Newton method", SISC 17 (1), pp.16-32, 1996. .seealso: SNESKSPSetUseEW(), SNESKSPGetParametersEW(), SNESKSPSetParametersEW() @*/ PetscErrorCode SNESKSPGetUseEW(SNES snes, PetscBool *flag) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidBoolPointer(flag,2); *flag = snes->ksp_ewconv; PetscFunctionReturn(0); } /*@ SNESKSPSetParametersEW - Sets parameters for Eisenstat-Walker convergence criteria for the linear solvers within an inexact Newton method. Logically Collective on SNES Input Parameters: + snes - SNES context . version - version 1, 2 (default is 2) or 3 . rtol_0 - initial relative tolerance (0 <= rtol_0 < 1) . rtol_max - maximum relative tolerance (0 <= rtol_max < 1) . gamma - multiplicative factor for version 2 rtol computation (0 <= gamma2 <= 1) . alpha - power for version 2 rtol computation (1 < alpha <= 2) . alpha2 - power for safeguard - threshold - threshold for imposing safeguard (0 < threshold < 1) Note: Version 3 was contributed by Luis Chacon, June 2006. Use PETSC_DEFAULT to retain the default for any of the parameters. Level: advanced Reference: S. C. Eisenstat and H. F. Walker, "Choosing the forcing terms in an inexact Newton method", Utah State University Math. Stat. Dept. Res. Report 6/94/75, June, 1994, to appear in SIAM J. Sci. Comput. .seealso: SNESKSPSetUseEW(), SNESKSPGetUseEW(), SNESKSPGetParametersEW() @*/ PetscErrorCode SNESKSPSetParametersEW(SNES snes,PetscInt version,PetscReal rtol_0,PetscReal rtol_max,PetscReal gamma,PetscReal alpha,PetscReal alpha2,PetscReal threshold) { SNESKSPEW *kctx; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); kctx = (SNESKSPEW*)snes->kspconvctx; if (!kctx) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_WRONGSTATE,"No Eisenstat-Walker context existing"); PetscValidLogicalCollectiveInt(snes,version,2); PetscValidLogicalCollectiveReal(snes,rtol_0,3); PetscValidLogicalCollectiveReal(snes,rtol_max,4); PetscValidLogicalCollectiveReal(snes,gamma,5); PetscValidLogicalCollectiveReal(snes,alpha,6); PetscValidLogicalCollectiveReal(snes,alpha2,7); PetscValidLogicalCollectiveReal(snes,threshold,8); if (version != PETSC_DEFAULT) kctx->version = version; if (rtol_0 != PETSC_DEFAULT) kctx->rtol_0 = rtol_0; if (rtol_max != PETSC_DEFAULT) kctx->rtol_max = rtol_max; if (gamma != PETSC_DEFAULT) kctx->gamma = gamma; if (alpha != PETSC_DEFAULT) kctx->alpha = alpha; if (alpha2 != PETSC_DEFAULT) kctx->alpha2 = alpha2; if (threshold != PETSC_DEFAULT) kctx->threshold = threshold; if (kctx->version < 1 || kctx->version > 3) SETERRQ1(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"Only versions 1, 2 and 3 are supported: %D",kctx->version); if (kctx->rtol_0 < 0.0 || kctx->rtol_0 >= 1.0) SETERRQ1(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"0.0 <= rtol_0 < 1.0: %g",(double)kctx->rtol_0); if (kctx->rtol_max < 0.0 || kctx->rtol_max >= 1.0) SETERRQ1(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"0.0 <= rtol_max (%g) < 1.0\n",(double)kctx->rtol_max); if (kctx->gamma < 0.0 || kctx->gamma > 1.0) SETERRQ1(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"0.0 <= gamma (%g) <= 1.0\n",(double)kctx->gamma); if (kctx->alpha <= 1.0 || kctx->alpha > 2.0) SETERRQ1(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"1.0 < alpha (%g) <= 2.0\n",(double)kctx->alpha); if (kctx->threshold <= 0.0 || kctx->threshold >= 1.0) SETERRQ1(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"0.0 < threshold (%g) < 1.0\n",(double)kctx->threshold); PetscFunctionReturn(0); } /*@ SNESKSPGetParametersEW - Gets parameters for Eisenstat-Walker convergence criteria for the linear solvers within an inexact Newton method. Not Collective Input Parameters: snes - SNES context Output Parameters: + version - version 1, 2 (default is 2) or 3 . rtol_0 - initial relative tolerance (0 <= rtol_0 < 1) . rtol_max - maximum relative tolerance (0 <= rtol_max < 1) . gamma - multiplicative factor for version 2 rtol computation (0 <= gamma2 <= 1) . alpha - power for version 2 rtol computation (1 < alpha <= 2) . alpha2 - power for safeguard - threshold - threshold for imposing safeguard (0 < threshold < 1) Level: advanced .seealso: SNESKSPSetUseEW(), SNESKSPGetUseEW(), SNESKSPSetParametersEW() @*/ PetscErrorCode SNESKSPGetParametersEW(SNES snes,PetscInt *version,PetscReal *rtol_0,PetscReal *rtol_max,PetscReal *gamma,PetscReal *alpha,PetscReal *alpha2,PetscReal *threshold) { SNESKSPEW *kctx; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); kctx = (SNESKSPEW*)snes->kspconvctx; if (!kctx) SETERRQ(PETSC_COMM_SELF,PETSC_ERR_ARG_WRONGSTATE,"No Eisenstat-Walker context existing"); if (version) *version = kctx->version; if (rtol_0) *rtol_0 = kctx->rtol_0; if (rtol_max) *rtol_max = kctx->rtol_max; if (gamma) *gamma = kctx->gamma; if (alpha) *alpha = kctx->alpha; if (alpha2) *alpha2 = kctx->alpha2; if (threshold) *threshold = kctx->threshold; PetscFunctionReturn(0); } PetscErrorCode KSPPreSolve_SNESEW(KSP ksp, Vec b, Vec x, SNES snes) { PetscErrorCode ierr; SNESKSPEW *kctx = (SNESKSPEW*)snes->kspconvctx; PetscReal rtol = PETSC_DEFAULT,stol; PetscFunctionBegin; if (!snes->ksp_ewconv) PetscFunctionReturn(0); if (!snes->iter) { rtol = kctx->rtol_0; /* first time in, so use the original user rtol */ ierr = VecNorm(snes->vec_func,NORM_2,&kctx->norm_first);CHKERRQ(ierr); } else { if (kctx->version == 1) { rtol = (snes->norm - kctx->lresid_last)/kctx->norm_last; if (rtol < 0.0) rtol = -rtol; stol = PetscPowReal(kctx->rtol_last,kctx->alpha2); if (stol > kctx->threshold) rtol = PetscMax(rtol,stol); } else if (kctx->version == 2) { rtol = kctx->gamma * PetscPowReal(snes->norm/kctx->norm_last,kctx->alpha); stol = kctx->gamma * PetscPowReal(kctx->rtol_last,kctx->alpha); if (stol > kctx->threshold) rtol = PetscMax(rtol,stol); } else if (kctx->version == 3) { /* contributed by Luis Chacon, June 2006. */ rtol = kctx->gamma * PetscPowReal(snes->norm/kctx->norm_last,kctx->alpha); /* safeguard: avoid sharp decrease of rtol */ stol = kctx->gamma*PetscPowReal(kctx->rtol_last,kctx->alpha); stol = PetscMax(rtol,stol); rtol = PetscMin(kctx->rtol_0,stol); /* safeguard: avoid oversolving */ stol = kctx->gamma*(kctx->norm_first*snes->rtol)/snes->norm; stol = PetscMax(rtol,stol); rtol = PetscMin(kctx->rtol_0,stol); } else SETERRQ1(PETSC_COMM_SELF,PETSC_ERR_ARG_OUTOFRANGE,"Only versions 1, 2 or 3 are supported: %D",kctx->version); } /* safeguard: avoid rtol greater than one */ rtol = PetscMin(rtol,kctx->rtol_max); ierr = KSPSetTolerances(ksp,rtol,PETSC_DEFAULT,PETSC_DEFAULT,PETSC_DEFAULT);CHKERRQ(ierr); ierr = PetscInfo3(snes,"iter %D, Eisenstat-Walker (version %D) KSP rtol=%g\n",snes->iter,kctx->version,(double)rtol);CHKERRQ(ierr); PetscFunctionReturn(0); } PetscErrorCode KSPPostSolve_SNESEW(KSP ksp, Vec b, Vec x, SNES snes) { PetscErrorCode ierr; SNESKSPEW *kctx = (SNESKSPEW*)snes->kspconvctx; PCSide pcside; Vec lres; PetscFunctionBegin; if (!snes->ksp_ewconv) PetscFunctionReturn(0); ierr = KSPGetTolerances(ksp,&kctx->rtol_last,0,0,0);CHKERRQ(ierr); kctx->norm_last = snes->norm; if (kctx->version == 1) { PC pc; PetscBool isNone; ierr = KSPGetPC(ksp, &pc);CHKERRQ(ierr); ierr = PetscObjectTypeCompare((PetscObject) pc, PCNONE, &isNone);CHKERRQ(ierr); ierr = KSPGetPCSide(ksp,&pcside);CHKERRQ(ierr); if (pcside == PC_RIGHT || isNone) { /* XXX Should we also test KSP_UNPRECONDITIONED_NORM ? */ /* KSP residual is true linear residual */ ierr = KSPGetResidualNorm(ksp,&kctx->lresid_last);CHKERRQ(ierr); } else { /* KSP residual is preconditioned residual */ /* compute true linear residual norm */ ierr = VecDuplicate(b,&lres);CHKERRQ(ierr); ierr = MatMult(snes->jacobian,x,lres);CHKERRQ(ierr); ierr = VecAYPX(lres,-1.0,b);CHKERRQ(ierr); ierr = VecNorm(lres,NORM_2,&kctx->lresid_last);CHKERRQ(ierr); ierr = VecDestroy(&lres);CHKERRQ(ierr); } } PetscFunctionReturn(0); } /*@ SNESGetKSP - Returns the KSP context for a SNES solver. Not Collective, but if SNES object is parallel, then KSP object is parallel Input Parameter: . snes - the SNES context Output Parameter: . ksp - the KSP context Notes: The user can then directly manipulate the KSP context to set various options, etc. Likewise, the user can then extract and manipulate the PC contexts as well. Level: beginner .seealso: KSPGetPC(), SNESCreate(), KSPCreate(), SNESSetKSP() @*/ PetscErrorCode SNESGetKSP(SNES snes,KSP *ksp) { PetscErrorCode ierr; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidPointer(ksp,2); if (!snes->ksp) { PetscBool monitor = PETSC_FALSE; ierr = KSPCreate(PetscObjectComm((PetscObject)snes),&snes->ksp);CHKERRQ(ierr); ierr = PetscObjectIncrementTabLevel((PetscObject)snes->ksp,(PetscObject)snes,1);CHKERRQ(ierr); ierr = PetscLogObjectParent((PetscObject)snes,(PetscObject)snes->ksp);CHKERRQ(ierr); ierr = KSPSetPreSolve(snes->ksp,(PetscErrorCode (*)(KSP,Vec,Vec,void*))KSPPreSolve_SNESEW,snes);CHKERRQ(ierr); ierr = KSPSetPostSolve(snes->ksp,(PetscErrorCode (*)(KSP,Vec,Vec,void*))KSPPostSolve_SNESEW,snes);CHKERRQ(ierr); ierr = PetscOptionsGetBool(((PetscObject)snes)->options,((PetscObject)snes)->prefix,"-ksp_monitor_snes",&monitor,NULL);CHKERRQ(ierr); if (monitor) { ierr = KSPMonitorSet(snes->ksp,KSPMonitorSNES,snes,NULL);CHKERRQ(ierr); } monitor = PETSC_FALSE; ierr = PetscOptionsGetBool(((PetscObject)snes)->options,((PetscObject)snes)->prefix,"-ksp_monitor_snes_lg",&monitor,NULL);CHKERRQ(ierr); if (monitor) { PetscObject *objs; ierr = KSPMonitorSNESLGResidualNormCreate(PetscObjectComm((PetscObject)snes),NULL,NULL,PETSC_DECIDE,PETSC_DECIDE,600,600,&objs);CHKERRQ(ierr); objs[0] = (PetscObject) snes; ierr = KSPMonitorSet(snes->ksp,(PetscErrorCode (*)(KSP,PetscInt,PetscReal,void*))KSPMonitorSNESLGResidualNorm,objs,(PetscErrorCode (*)(void**))KSPMonitorSNESLGResidualNormDestroy);CHKERRQ(ierr); } ierr = PetscObjectSetOptions((PetscObject)snes->ksp,((PetscObject)snes)->options);CHKERRQ(ierr); } *ksp = snes->ksp; PetscFunctionReturn(0); } #include /*@ SNESSetDM - Sets the DM that may be used by some nonlinear solvers or their underlying preconditioners Logically Collective on SNES Input Parameters: + snes - the nonlinear solver context - dm - the dm, cannot be NULL Notes: A DM can only be used for solving one problem at a time because information about the problem is stored on the DM, even when not using interfaces like DMSNESSetFunction(). Use DMClone() to get a distinct DM when solving different problems using the same function space. Level: intermediate .seealso: SNESGetDM(), KSPSetDM(), KSPGetDM() @*/ PetscErrorCode SNESSetDM(SNES snes,DM dm) { PetscErrorCode ierr; KSP ksp; DMSNES sdm; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidHeaderSpecific(dm,DM_CLASSID,2); ierr = PetscObjectReference((PetscObject)dm);CHKERRQ(ierr); if (snes->dm) { /* Move the DMSNES context over to the new DM unless the new DM already has one */ if (snes->dm->dmsnes && !dm->dmsnes) { ierr = DMCopyDMSNES(snes->dm,dm);CHKERRQ(ierr); ierr = DMGetDMSNES(snes->dm,&sdm);CHKERRQ(ierr); if (sdm->originaldm == snes->dm) sdm->originaldm = dm; /* Grant write privileges to the replacement DM */ } ierr = DMCoarsenHookRemove(snes->dm,DMCoarsenHook_SNESVecSol,DMRestrictHook_SNESVecSol,snes);CHKERRQ(ierr); ierr = DMDestroy(&snes->dm);CHKERRQ(ierr); } snes->dm = dm; snes->dmAuto = PETSC_FALSE; ierr = SNESGetKSP(snes,&ksp);CHKERRQ(ierr); ierr = KSPSetDM(ksp,dm);CHKERRQ(ierr); ierr = KSPSetDMActive(ksp,PETSC_FALSE);CHKERRQ(ierr); if (snes->npc) { ierr = SNESSetDM(snes->npc, snes->dm);CHKERRQ(ierr); ierr = SNESSetNPCSide(snes,snes->npcside);CHKERRQ(ierr); } PetscFunctionReturn(0); } /*@ SNESGetDM - Gets the DM that may be used by some preconditioners Not Collective but DM obtained is parallel on SNES Input Parameter: . snes - the preconditioner context Output Parameter: . dm - the dm Level: intermediate .seealso: SNESSetDM(), KSPSetDM(), KSPGetDM() @*/ PetscErrorCode SNESGetDM(SNES snes,DM *dm) { PetscErrorCode ierr; PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); if (!snes->dm) { ierr = DMShellCreate(PetscObjectComm((PetscObject)snes),&snes->dm);CHKERRQ(ierr); snes->dmAuto = PETSC_TRUE; } *dm = snes->dm; PetscFunctionReturn(0); } /*@ SNESSetNPC - Sets the nonlinear preconditioner to be used. Collective on SNES Input Parameters: + snes - iterative context obtained from SNESCreate() - pc - the preconditioner object Notes: Use SNESGetNPC() to retrieve the preconditioner context (for example, to configure it using the API). Level: developer .seealso: SNESGetNPC(), SNESHasNPC() @*/ PetscErrorCode SNESSetNPC(SNES snes, SNES pc) { PetscErrorCode ierr; PetscFunctionBegin; PetscValidHeaderSpecific(snes, SNES_CLASSID, 1); PetscValidHeaderSpecific(pc, SNES_CLASSID, 2); PetscCheckSameComm(snes, 1, pc, 2); ierr = PetscObjectReference((PetscObject) pc);CHKERRQ(ierr); ierr = SNESDestroy(&snes->npc);CHKERRQ(ierr); snes->npc = pc; ierr = PetscLogObjectParent((PetscObject)snes, (PetscObject)snes->npc);CHKERRQ(ierr); PetscFunctionReturn(0); } /*@ SNESGetNPC - Creates a nonlinear preconditioning solver (SNES) to be used to precondition the nonlinear solver. Not Collective; but any changes to the obtained SNES object must be applied collectively Input Parameter: . snes - iterative context obtained from SNESCreate() Output Parameter: . pc - preconditioner context Options Database: . -npc_snes_type - set the type of the SNES to use as the nonlinear preconditioner Notes: If a SNES was previously set with SNESSetNPC() then that SNES is returned, otherwise a new SNES object is created. The (preconditioner) SNES returned automatically inherits the same nonlinear function and Jacobian supplied to the original SNES during SNESSetUp() Level: developer .seealso: SNESSetNPC(), SNESHasNPC(), SNES, SNESCreate() @*/ PetscErrorCode SNESGetNPC(SNES snes, SNES *pc) { PetscErrorCode ierr; const char *optionsprefix; PetscFunctionBegin; PetscValidHeaderSpecific(snes, SNES_CLASSID, 1); PetscValidPointer(pc, 2); if (!snes->npc) { ierr = SNESCreate(PetscObjectComm((PetscObject)snes),&snes->npc);CHKERRQ(ierr); ierr = PetscObjectIncrementTabLevel((PetscObject)snes->npc,(PetscObject)snes,1);CHKERRQ(ierr); ierr = PetscLogObjectParent((PetscObject)snes,(PetscObject)snes->npc);CHKERRQ(ierr); ierr = SNESGetOptionsPrefix(snes,&optionsprefix);CHKERRQ(ierr); ierr = SNESSetOptionsPrefix(snes->npc,optionsprefix);CHKERRQ(ierr); ierr = SNESAppendOptionsPrefix(snes->npc,"npc_");CHKERRQ(ierr); ierr = SNESSetCountersReset(snes->npc,PETSC_FALSE);CHKERRQ(ierr); } *pc = snes->npc; PetscFunctionReturn(0); } /*@ SNESHasNPC - Returns whether a nonlinear preconditioner exists Not Collective Input Parameter: . snes - iterative context obtained from SNESCreate() Output Parameter: . has_npc - whether the SNES has an NPC or not Level: developer .seealso: SNESSetNPC(), SNESGetNPC() @*/ PetscErrorCode SNESHasNPC(SNES snes, PetscBool *has_npc) { PetscFunctionBegin; PetscValidHeaderSpecific(snes, SNES_CLASSID, 1); *has_npc = (PetscBool) (snes->npc ? PETSC_TRUE : PETSC_FALSE); PetscFunctionReturn(0); } /*@ SNESSetNPCSide - Sets the preconditioning side. Logically Collective on SNES Input Parameter: . snes - iterative context obtained from SNESCreate() Output Parameter: . side - the preconditioning side, where side is one of .vb PC_LEFT - left preconditioning PC_RIGHT - right preconditioning (default for most nonlinear solvers) .ve Options Database Keys: . -snes_pc_side Notes: SNESNRICHARDSON and SNESNCG only support left preconditioning. Level: intermediate .seealso: SNESGetNPCSide(), KSPSetPCSide() @*/ PetscErrorCode SNESSetNPCSide(SNES snes,PCSide side) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidLogicalCollectiveEnum(snes,side,2); snes->npcside= side; PetscFunctionReturn(0); } /*@ SNESGetNPCSide - Gets the preconditioning side. Not Collective Input Parameter: . snes - iterative context obtained from SNESCreate() Output Parameter: . side - the preconditioning side, where side is one of .vb PC_LEFT - left preconditioning PC_RIGHT - right preconditioning (default for most nonlinear solvers) .ve Level: intermediate .seealso: SNESSetNPCSide(), KSPGetPCSide() @*/ PetscErrorCode SNESGetNPCSide(SNES snes,PCSide *side) { PetscFunctionBegin; PetscValidHeaderSpecific(snes,SNES_CLASSID,1); PetscValidPointer(side,2); *side = snes->npcside; PetscFunctionReturn(0); } /*@ SNESSetLineSearch - Sets the linesearch on the SNES instance. Collective on SNES Input Parameters: + snes - iterative context obtained from SNESCreate() - linesearch - the linesearch object Notes: Use SNESGetLineSearch() to retrieve the preconditioner context (for example, to configure it using the API). Level: developer .seealso: SNESGetLineSearch() @*/ PetscErrorCode SNESSetLineSearch(SNES snes, SNESLineSearch linesearch) { PetscErrorCode ierr; PetscFunctionBegin; PetscValidHeaderSpecific(snes, SNES_CLASSID, 1); PetscValidHeaderSpecific(linesearch, SNESLINESEARCH_CLASSID, 2); PetscCheckSameComm(snes, 1, linesearch, 2); ierr = PetscObjectReference((PetscObject) linesearch);CHKERRQ(ierr); ierr = SNESLineSearchDestroy(&snes->linesearch);CHKERRQ(ierr); snes->linesearch = linesearch; ierr = PetscLogObjectParent((PetscObject)snes, (PetscObject)snes->linesearch);CHKERRQ(ierr); PetscFunctionReturn(0); } /*@ SNESGetLineSearch - Returns a pointer to the line search context set with SNESSetLineSearch() or creates a default line search instance associated with the SNES and returns it. Not Collective Input Parameter: . snes - iterative context obtained from SNESCreate() Output Parameter: . linesearch - linesearch context Level: beginner .seealso: SNESSetLineSearch(), SNESLineSearchCreate() @*/ PetscErrorCode SNESGetLineSearch(SNES snes, SNESLineSearch *linesearch) { PetscErrorCode ierr; const char *optionsprefix; PetscFunctionBegin; PetscValidHeaderSpecific(snes, SNES_CLASSID, 1); PetscValidPointer(linesearch, 2); if (!snes->linesearch) { ierr = SNESGetOptionsPrefix(snes, &optionsprefix);CHKERRQ(ierr); ierr = SNESLineSearchCreate(PetscObjectComm((PetscObject)snes), &snes->linesearch);CHKERRQ(ierr); ierr = SNESLineSearchSetSNES(snes->linesearch, snes);CHKERRQ(ierr); ierr = SNESLineSearchAppendOptionsPrefix(snes->linesearch, optionsprefix);CHKERRQ(ierr); ierr = PetscObjectIncrementTabLevel((PetscObject) snes->linesearch, (PetscObject) snes, 1);CHKERRQ(ierr); ierr = PetscLogObjectParent((PetscObject)snes, (PetscObject)snes->linesearch);CHKERRQ(ierr); } *linesearch = snes->linesearch; PetscFunctionReturn(0); }