docs: integrate gallery into Sphinx site

cuihantao · cuihantao · commit 834e3ab3d91a · 2026-03-08T23:21:19.000-04:00
Add Gallery card to the landing page, register gallery/index in the
main toctree, and exclude the three gallery notebooks from notebook
execution (each runs hundreds of TDS scenarios).
diff --git a/docs/source/_html_landing.rst b/docs/source/_html_landing.rst
@@ -10,7 +10,7 @@ ANDES is an open-source Python library for power system modeling, computation, a
 
 ----
 
-.. grid:: 1 2 2 2
+.. grid:: 1 2 3 3
    :gutter: 3
 
    .. grid-item-card:: Tutorials
@@ -19,6 +19,12 @@ ANDES is an open-source Python library for power system modeling, computation, a
 
       Complete learning path from installation through advanced analysis: power flow, time-domain simulation, eigenvalue analysis, parameter sweeps, and contingency studies.
 
+   .. grid-item-card:: Gallery
+      :link: gallery/index
+      :link-type: doc
+
+      Research-oriented application examples: forced oscillation analysis, frequency stability under low inertia, ML-based security assessment, and more.
+
    .. grid-item-card:: Modeling Guide
       :link: modeling/index
       :link-type: doc
diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -52,6 +52,9 @@
 nb_execution_excludepatterns = [
     'verification/*',                 # Skip verification notebooks (long-running)
     'tutorials/15-reinforcement-learning.ipynb',  # Requires gymnasium (rl extra)
+    'gallery/forced-oscillation.ipynb',             # WECC 179-bus multi-stage TDS (long-running)
+    'gallery/low-inertia-freq.ipynb',              # WECC 179-bus 4 scenarios (long-running)
+    'gallery/critical-clearing-time.ipynb',        # 300 TDS scenarios via reinit (long-running)
 ]
 nb_merge_streams = True               # Merge stdout/stderr into single output
 
diff --git a/docs/source/index.rst b/docs/source/index.rst
@@ -11,6 +11,7 @@ ANDES Documentation
 
    about
    tutorials/index
+   gallery/index
    modeling/index
    reference/index
    verification/index

Original file line number	Diff line number	Diff line change
`@@ -52,6 +52,9 @@`
`52`	`52`	`nb_execution_excludepatterns = [`
`53`	`53`	`'verification/*', # Skip verification notebooks (long-running)`
`54`	`54`	`'tutorials/15-reinforcement-learning.ipynb', # Requires gymnasium (rl extra)`
	`55`	`+ 'gallery/forced-oscillation.ipynb', # WECC 179-bus multi-stage TDS (long-running)`
	`56`	`+ 'gallery/low-inertia-freq.ipynb', # WECC 179-bus 4 scenarios (long-running)`
	`57`	`+ 'gallery/critical-clearing-time.ipynb', # 300 TDS scenarios via reinit (long-running)`
`55`	`58`	`]`
`56`	`59`	`nb_merge_streams = True # Merge stdout/stderr into single output`
`57`	`60`