Merge pull request #3284 from jessica-mitchell/add-files-examples

Configure Sphinx gallery to copy files from `pynest/examples`

Author: jessica-mitchell

doc/htmldoc/conf.py

@@ -80,6 +80,7 @@
     "gallery_dirs": "auto_examples",
     "plot_gallery": "False",
     "download_all_examples": False,
+    "copyfile_regex": r".*\.rst|.*\.png|.*\.svg|Snakefile|.*\.txt",
 }
 
 # General information about the project.
@@ -260,14 +261,6 @@
 ]
 
 
-def copy_example_file(src):
-    copyfile(os.path.join(pynest_dir, src), Path("examples") / Path(src).parts[-1])
-
-
-# -- Copy documentation for Microcircuit Model ----------------------------
-copy_example_file("examples/hpc_benchmark_connectivity.svg")
-
-
 def patch_documentation(patch_url):
     """Apply a hot-fix patch to the documentation before building it.
 

doc/htmldoc/examples/index.rst

@@ -76,14 +76,14 @@ PyNEST examples
 
 
     .. grid-item-card:: Cortical microcircuit (Potjans)
-           :img-top: ../static/img/potjans_2014_raster_plot.png
+           :img-top: ../auto_examples/Potjans_2014/potjans_2014_raster_plot.png
 
            * :doc:`../auto_examples/Potjans_2014/index`
 
 
 
     .. grid-item-card:: EI clustered network (Rostami et al)
-           :img-top: ../static/img/pynest/EI_clustered_network_schematic.png
+           :img-top: ../auto_examples/EI_clustered_network/EI_clustered_network_schematic.png
 
            :doc:`../auto_examples/EI_clustered_network/index`
 
@@ -256,7 +256,7 @@ PyNEST examples
            * :doc:`../auto_examples/sonata_example/sonata_network`
 
     .. grid-item-card:: HPC benchmark
-           :img-top: ../static/img/nest_logo-faded.png
+           :img-top: ../auto_examples/hpc_benchmark_connectivity.svg
 
            * :doc:`../auto_examples/hpc_benchmark`
 

doc/htmldoc/static/img/pynest/EI_clustered_network_schematic.png renamed to pynest/examples/EI_clustered_network/EI_clustered_network_schematic.png

@@ -3,7 +3,7 @@ EI-clustered circuit model
 
 This is PyNEST implementation of the EI-clustered circuit model described by Rostami et al. [1]_.
 
-.. figure:: /static/img/pynest/EI_clustered_network_schematic.png
+.. figure:: EI_clustered_network_schematic.png
    :alt: EI-clustered circuit model.
 
    Schematic of the EI-clustered circuit model. The network consists of `n_clusters` with one excitatory and one inhibitory population each.

pynest/examples/EI_clustered_network/README.rst

@@ -9,15 +9,15 @@ The network model represents four layers of cortex, L2/3, L4, L5, and L6, each c
 
    .. grid-item::
 
-     .. image:: ../../static/img/potjans_2014_microcircuit.png
+     .. image:: potjans_2014_microcircuit.png
 
    .. grid-item::
 
-     .. image:: ../../static/img/potjans_2014_raster_plot.png
+     .. image:: potjans_2014_raster_plot.png
 
    .. grid-item::
 
-     .. image:: ../../static/img/potjans_2014_box_plot.png
+     .. image:: potjans_2014_box_plot.png
 
 
 

pynest/examples/Potjans_2014/README.rst

@@ -2,7 +2,7 @@ E-prop plasticity examples
 ==========================
 
 
-.. image:: ../../../../pynest/examples/eprop_plasticity/eprop_supervised_regression_schematic_sine-waves.png
+.. image:: eprop_supervised_regression_schematic_sine-waves.png
 
 Eligibility propagation (e-prop) [1]_ is a three-factor learning rule for spiking neural networks
 that approximates backpropagation through time. The original TensorFlow implementation of e-prop

doc/htmldoc/static/img/potjans_2014_box_plot.png renamed to pynest/examples/Potjans_2014/potjans_2014_box_plot.png

@@ -40,7 +40,7 @@
 infer the underlying rationale of the task. Here, the solution is to turn to the side in which more cues were
 presented.
 
-.. image:: ../../../../pynest/examples/eprop_plasticity/eprop_supervised_classification_schematic_evidence-accumulation.png
+.. image:: eprop_supervised_classification_schematic_evidence-accumulation.png
    :width: 70 %
    :alt: See Figure 1 below.
    :align: center