Description of the SUNNonlinearSolver ModuleΒΆ

SUNDIALS time integration packages are written in terms of generic nonlinear solver operations defined by the SUNNonlinSol API and implemented by a particular SUNNonlinSol module of type SUNNonlinearSolver. Users can supply their own SUNNonlinSol module, or use one of the modules provided with SUNDIALS. Depending on the package, nonlinear solver modules can either target system presented in a rootfinding (\(F(y) = 0\)) or fixed-point (\(G(y) = y\)) formulation. For more information on the formulation of the nonlinear system(s) see the ARKode SUNNonlinearSolver interface section.

The time integrators in SUNDIALS specify a default nonlinear solver module and as such this chapter is intended for users that wish to use a non-default nonlinear solver module or would like to provide their own nonlinear solver implementation. Users interested in using a non-default solver module may skip the description of the SUNNonlinSol API in section The SUNNonlinearSolver API and proceeded to the subsequent sections in this chapter that describe the SUNNonlinSol modules provided with SUNDIALS.

For users interested in providing their own SUNNonlinSol module, the following section presents the SUNNonlinSol API and its implementation beginning with the definition of SUNNonlinSol functions in the sections SUNNonlinearSolver core functions, SUNNonlinearSolver set functions and SUNNonlinearSolver get functions. This is followed by the definition of functions supplied to a nonlinear solver implementation in the section Functions provided by SUNDIALS integrators. The nonlinear solver return codes are given in the section SUNNonlinearSolver return codes. The SUNNonlinearSolver type and the generic SUNNonlinSol module are defined in the section The generic SUNNonlinearSolver module. Finally, the section Implementing a Custom SUNNonlinearSolver Module lists the requirements for supplying a custom SUNNonlinSol module. Users wishing to supply their own SUNNonlinSol module are encouraged to use the SUNNonlinSol implementations provided with SUNDIALS as a template for supplying custom nonlinear solver modules.