pySDC & FEniCS solver for partitioned-heat-equation (#557)

Add SDC time stepping as an option for FEniCS-bases partitioned heat conduction scenario.
---------

Co-authored-by: Benjamin Rodenberg <[email protected]>

Author: TobiasEppacher

changelog-entries/557.md

@@ -0,0 +1 @@
+- Added SDC from pySDC as new time-stepping scheme in [partitioned-heat-conduction tutorial](https://precice.org/tutorials-partitioned-heat-conduction.html) with FEniCS.

partitioned-heat-conduction/dirichlet-fenics/run.sh

@@ -1,9 +1,43 @@
 #!/usr/bin/env bash
 set -e -u
 
+python3 -m venv --system-site-packages ../solver-fenics/.venv
+. ../solver-fenics/.venv/bin/activate
+pip install -r ../solver-fenics/requirements.txt
+
 . ../../tools/log.sh
 exec > >(tee --append "$LOGFILE") 2>&1
 
-python3 ../solver-fenics/heat.py Dirichlet
+if [ $# -eq 0 ] 
+then
+    echo "Running simulation with default FEniCS implementation"
+    python3 ../solver-fenics/heat.py Dirichlet
+else
+    case "$1" in
+        -[hH]|--help)
+            echo "Usage: $0 [highorder|sdc|*]"
+            echo ""
+            echo "      irk : Run simulation with higher-order implicit Runge-Kutta schemes FEniCS implementation"
+            echo "      sdc : Run simulation with pySDC+FEniCS implementation"
+            echo "      *   : For every other input run the simulation with default FEniCS implementation"
+            exit 0
+            ;;
+        irk)
+            echo "Running simulation with higher-order implicit Runge-Kutta schemes FEniCS implementation"
+            python3 ../solver-fenics/heatHigherOrder.py Dirichlet
+            ;;
+        sdc)
+            # install pySDC + its dependencies only if needed
+            pip install git+https://github.com/Parallel-in-Time/[email protected]
+            pip install pySDC~=5.4
+            echo "Running simulation with pySDC+FEniCS implementation"
+            python3 ../solver-fenics/heat_pySDC.py Dirichlet
+            ;;
+        *)
+            echo "Running simulation with default FEniCS implementation"
+            python3 ../solver-fenics/heat.py Dirichlet
+            ;;
+    esac
+fi
 
 close_log

partitioned-heat-conduction/neumann-fenics/run.sh

@@ -1,6 +1,10 @@
 #!/usr/bin/env bash
 set -e -u
 
+python3 -m venv --system-site-packages ../solver-fenics/.venv
+. ../solver-fenics/.venv/bin/activate
+pip install -r ../solver-fenics/requirements.txt
+
 . ../../tools/log.sh
 exec > >(tee --append "$LOGFILE") 2>&1