fix paths in CI workflow for uploading Paraview-generated animations; add link to animation-generating notebook below the animations (#1613)

Author: slayoo

.github/workflows/tests.yml

@@ -294,15 +294,15 @@ jobs:
         if: ( ! startsWith(matrix.platform, 'windows-') ) && matrix.test-suite == env.anim_test-suite && matrix.python-version == env.anim_python-version
         uses: actions/upload-artifact@v4
         with:
-          name: animation-movie
+          name: animation-movie-${{ matrix.platform }}
           if-no-files-found: error
           path: ~/work/_temp/_github_home/figures/*.mp4
 
       - name: animation frame upload
         if: ( ! startsWith(matrix.platform, 'windows-') ) && matrix.test-suite == env.anim_test-suite && matrix.python-version == env.anim_python-version
         uses: actions/upload-artifact@v4
         with:
-          name: animation-frame
+          name: animation-frame-${{ matrix.platform }}
           if-no-files-found: error
           path: ~/work/_temp/_github_home/figures/*.pdf
 
@@ -311,4 +311,4 @@ jobs:
         uses: eine/tip@master
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
-          files: /*(home|Users)/runner/work/_temp/_github_home/figures/*.mp4
+          files: ~/work/_temp/_github_home/figures/*.mp4

docs/templates/index.html.jinja2

@@ -31,10 +31,13 @@
     <div style="padding-top: 2em">
         <h2>What is PySDM?</h2>
         <p>
-            <video controls style="float:right; width:40%">
+            <div style="float:right; width:40%">
+            <video controls style="width:100%">
                 <source src="https://github.com/open-atmos/PySDM/releases/download/tip/docs_intro_animation_ubuntu-24.04.mp4" type="video/mp4">
                 Your browser does not support the video tag.
             </video>
+            <a href="https://github.com/open-atmos/PySDM/blob/main/examples/PySDM_examples/_HOWTOs/paraview_hello_world.ipynb" style="small">Jupyter notebook setting up and running the above PySDM simulation and generating the visualisation using Paraview</a>
+            </div>
             PySDM is a package for simulating the <mark>dynamics of population of particles undergoing diffusional and collisional growth (and breakage)</mark>.
             The package features a Pythonic high-performance (multi-threaded CPU &amp; CUDA GPU) implementation of the <mark>Super-Droplet Method (SDM) Monte-Carlo algorithm</mark> 
               for representing collisional growth (<a href="https://doi.org/10.1002/qj.441">Shima et al. 2009</a>), hence the name.

examples/docs/pysdm_examples_landing.md

@@ -39,12 +39,15 @@ The 2D prescribed-flow framework used here can be traced back to the work of
     and dry-air potential temperature.
   In PySDM-examples, the Eulerian advection is handled using the <a href="https://doi.org/10.21105/joss.03896">PyMPDATA</a> Numba-based
     implementation of the <a href="https://doi.org/10.1002/fld.1071">MPDATA numerical scheme of Smolarkiewicz (e.g., 2006)</a>.
-  An animation depicting PySDM simulation capturing <mark>aerosol collisional processing</mark> by warm rain is shown below:
-
-<video controls style="width:100%">
+  An animation depicting PySDM simulation capturing <mark>aerosol collisional processing</mark> by warm rain is shown below
+  (<a href="https://github.com/open-atmos/PySDM/blob/main/examples/PySDM_examples/_HOWTOs/paraview_hello_world.ipynb">see
+  the Paraview hello-world HOWTO Jupyter notbook for code generating the simulation and visualisation</a>):
+<center>
+<video controls style="width:80%">
   <source src="https://github.com/open-atmos/PySDM/releases/download/tip/docs_intro_animation_ubuntu-24.04.mp4" type="video/mp4">
   Your browser does not support the video tag.
 </video>
+</center>
 
 Example notebooks:
 - `PySDM_examples.Arabas_et_al_2015`