]> https://gitweb.dealii.org/ - dealii.git/commitdiff
In step-77, also talk about the other nonlinear solver packages we support. 15128/head
authorWolfgang Bangerth <bangerth@colostate.edu>
Sat, 22 Apr 2023 00:23:16 +0000 (18:23 -0600)
committerWolfgang Bangerth <bangerth@colostate.edu>
Sat, 22 Apr 2023 00:23:16 +0000 (18:23 -0600)
examples/step-77/doc/intro.dox

index eec14ea429362c0ca755a5afe5cf517cf5f07ecc..f095ac99c8011339a1f9976d72607293ad79dfd2 100644 (file)
@@ -155,6 +155,18 @@ provides a vast amount of finite-element functionality, %SUNDIALS'
 KINSOL package provides a vast amount of nonlinear solver
 functionality, and we better use it.
 
+@note While this program uses SUNDIAL's KINSOL package as the engine to
+  solve nonlinear problems, KINSOL is not the only option you have.
+  deal.II also has interfaces to PETSc's SNES collection of algorithms
+  (see the PETScWrappers::NonlinearSolver class) as well as to
+  the Trilinos NOX package (see the TrilinosWrappers::NOXSolver class)
+  that provide not only very similar functionality, but also a largely
+  identical interface. If you have installed a version of deal.II that
+  is configured to use either PETSc or Trilinos, but not SUNDIALS,
+  then it is not too difficult to switch this program to use either
+  of the former two packages instead: Basically everything that we
+  say and do below will also be true and work for these other packages!
+
 
 <h3> How deal.II interfaces with KINSOL </h3>
 
@@ -237,7 +249,7 @@ problem as follows:
   independent, and can be broken into separate functions.
 
 There is an assumption here that whenever KINSOL asks for a linear
-solver with the (approximation of the) Jacobian, that this will be for
+solver with the (approximation of the) Jacobian, that this will be
 for an update $\delta U$ (which has zero boundary values), a multiple
 of which will be added to the solution (which already has the right
 boundary values).  This may not be true and if so, we might have to

In the beginning the Universe was created. This has made a lot of people very angry and has been widely regarded as a bad move.

Douglas Adams


Typeset in Trocchi and Trocchi Bold Sans Serif.