Fix gallery (pymc-devs#359)

* create truncated regression example

* delete truncated regression example from main branch

* create truncated regression example

* delete truncated regression example from main branch

* create truncated regression example

* delete truncated regression example from main branch

* fix incorrect statement about pm.NormalMixture

* update gallery to include all (relevant) subfolders of examples

* commit the *.myst.md files just magically created

* delete myst_nbs/pymc3_howto

* small fix to underlining of section headings

* rename pymc_howto/ to howto/

* add the howto/*.myst.md files that suddenly appeared

* rerun sampling_callback.ipynb (under v3) to fix cell order error

* remove duplicate section in gallery.rst

* global find and replace pymc3_howto -> howto

* remove another duplicate in gallery.rst 🙄

* move BART and Spline notebooks into Case Studies to fix gallery rendering error

It doesn't like it when there is only one notebook in each section

* this should do it!

Co-authored-by: Benjamin T. Vincent <[email protected]>

Author: Benjamin T. Vincent

.pre-commit-config.yaml

@@ -29,7 +29,7 @@ repos:
             |examples/gaussian_processes/GP-Latent\.ipynb$
             |examples/gaussian_processes/GP-MaunaLoa2\.ipynb$
             |examples/samplers/MLDA_gravity_surveying\.ipynb$
-            |examples/pymc3_howto/sampling_callback\.ipynb$
+            |examples/howto/sampling_callback\.ipynb$
             |examples/case_studies/blackbox_external_likelihood\.ipynb$
             |examples/samplers/GLM-hierarchical-jax\.ipynb$
             |examples/variational_inference/convolutional_vae_keras_advi\.ipynb$
@@ -76,7 +76,7 @@ repos:
                examples/generalized_linear_models/GLM-robust.ipynb|
                examples/generalized_linear_models/GLM-rolling-regression.ipynb|
                examples/generalized_linear_models/GLM-simpsons-paradox.ipynb|
-               examples/pymc3_howto/api_quickstart.ipynb|
+               examples/howto/api_quickstart.ipynb|
                examples/samplers/MLDA_gravity_surveying.ipynb|
                examples/samplers/MLDA_simple_linear_regression.ipynb|
                examples/samplers/SMC-ABC_Lotka-Volterra_example.ipynb|

examples/BART/BART_introduction.ipynb renamed to examples/case_studies/BART_introduction.ipynb

@@ -223,7 +223,7 @@ def setup(app: Sphinx):
     "generalized_linear_models/*",
     "mixture_models/*",
     "ode_models/*",
-    "pymc3_howto/*",
+    "howto/*",
     "samplers/*",
     "splines/*",
     "survival_analysis/*",

examples/splines/spline.ipynb renamed to examples/case_studies/spline.ipynb

@@ -7,7 +7,7 @@ PyMC Example Gallery
    object_index/index
 
 (Generalized) Linear and Hierarchical Linear Models
--------------------------
+---------------------------------------------------
 
 .. nbgallery::
     :name: generalized_linear_models
@@ -48,6 +48,16 @@ Gaussian Processes
 
     gaussian_processes/*
 
+BART
+----
+
+.. nbgallery::
+    :name: BART
+    :glob:
+    :reversed:
+
+    BART/*
+
 Inference in ODE models
 -----------------------
 
@@ -107,3 +117,23 @@ Variational Inference
     :reversed:
 
     variational_inference/*
+
+How to
+------
+
+.. nbgallery::
+    :name: howto
+    :glob:
+    :reversed:
+
+    howto/*
+
+Splines
+-------
+
+.. nbgallery::
+    :name: splines
+    :glob:
+    :reversed:
+
+    splines/*