split multigrid docs out into their own section (#239)

zingale · web-flow · commit 63e64073cd64 · 2024-09-02T14:12:22.000-04:00
diff --git a/docs/source/index.rst b/docs/source/index.rst
@@ -42,14 +42,24 @@ new ideas.
 
 .. toctree::
    :maxdepth: 1
-   :caption: Solvers
+   :caption: Multigrid
+   :hidden:
+
+   multigrid
+   multigrid_basics
+   multigrid-constant-coefficients
+   multigrid-variable-coeff
+   multigrid-general-linear
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Hydro Solvers
    :hidden:
 
    advection_basics
    burgers_basics
    compressible_basics
    compressible_compare
-   multigrid
    diffusion_basics
    incompressible_basics
    incompressible_viscous_basics
diff --git a/docs/source/multigrid.rst b/docs/source/multigrid.rst
@@ -38,13 +38,3 @@ to square grids with zoning a power of 2.
    since there is no time-dependence in pure elliptic problems. Instead,
    there are a few scripts in the multigrid/ subdirectory that
    demonstrate its use.
-
-
-.. toctree::
-   :hidden:
-
-   multigrid_basics
-   multigrid-constant-coefficients
-   multigrid-variable-coeff
-   multigrid-general-linear
-   multigrid_exercises
diff --git a/docs/source/multigrid_basics.rst b/docs/source/multigrid_basics.rst
@@ -95,3 +95,21 @@ Left is the original u velocity, middle is the modified field after
 adding the gradient of the scalar, and right is the recovered field.
 
 
+Exercises
+---------
+
+Explorations
+^^^^^^^^^^^^
+
+* Try doing just smoothing, no multigrid. Show that it still converges
+  second order if you use enough iterations, but that the amount of
+  time needed to get a solution is much greater.
+
+Extensions
+^^^^^^^^^^
+
+* Add a different bottom solver to the multigrid algorithm
+
+* Make the multigrid solver work for non-square domains
+
+* Implement the full-multigrid algorithm instead of just V-cycles
diff --git a/docs/source/multigrid_exercises.rst b/docs/source/multigrid_exercises.rst
