Add the 2D and 3D redoxnics models as examples of how to use the library.

_config.yml

@@ -61,6 +61,13 @@ sphinx:
         - fmt: py
     # A tutorial or demo that raises fails the build, instead of a warning
     nb_execution_raise_on_error: true
+    # Pages that cite references cited elsewhere too list them as footnotes,
+    # {footcite} and {footbibliography}. MyST checks footnotes before
+    # sphinxcontrib-bibtex creates them, and warns about each; the book has
+    # no MyST footnotes of its own
+    suppress_warnings: ["myst.footnote"]
+    # No rule before the footnotes, which end a page under References
+    myst_footnote_transition: false
     autodoc_member_order: bysource
     # The page tables of contents list objects by name, without their module
     toc_object_entries_show_parents: hide

_toc.yml

@@ -24,6 +24,9 @@ parts:
   - caption: "Electrochemistry"
     chapters:
       - file: "examples/electrochemistry/porous_electrode.py"
+      - file: "examples/electrochemistry/vanadium_half_cell_1d.py"
+      - file: "examples/electrochemistry/vanadium_half_cell_2d.py"
+      - file: "examples/electrochemistry/vanadium_half_cell_3d.py"
   - caption: "Python API"
     chapters:
       - file: "docs/api/index"

docs/api/electrochemistry.md

@@ -49,3 +49,10 @@
 .. autoclass:: MassTransferButlerVolmer
    :members:
 ```
+
+## Half-cells
+
+```{eval-rst}
+.. autoclass:: RedoxHalfCell
+   :members:
+```

docs/api/symbolic.md

@@ -44,6 +44,8 @@
    :members:
 
 .. autofunction:: as_expr
+
+.. autofunction:: value_at_defaults
 ```
 
 ## Components
@@ -121,7 +123,11 @@
 .. autoclass:: Interpolation
    :members:
 
+.. currentmodule:: sumfem.symbolic.transfer
+
 .. autodata:: Transferable
+
+.. currentmodule:: sumfem.symbolic
 ```
 
 ## Units and dimensional analysis
@@ -140,12 +146,20 @@
 
 .. autoexception:: UnitError
 
+.. currentmodule:: sumfem.symbolic.constants
+
 .. autodata:: BOLTZMANN
 
+.. currentmodule:: sumfem.symbolic.constants
+
 .. autodata:: FARADAY
 
+.. currentmodule:: sumfem.symbolic.constants
+
 .. autodata:: GAS_CONSTANT
 
+.. currentmodule:: sumfem.symbolic
+
 .. autofunction:: boltzmann_constant
 ```