Merge branch 'develop' into bump-versions

Author: MakisH

elastic-tube-1d/README.md

@@ -40,7 +40,7 @@ preCICE configuration (image generated using the [precice-config-visualizer](htt
 Both fluid and solid participant are supported in:
 
 - *C++*: example solvers using the intrinsic [C++ API of preCICE](https://precice.org/couple-your-code-api.html). The fluid solver also depends on LAPACK (e.g. on Ubuntu `sudo apt-get install liblapack-dev`)
-- *Python*: example solvers using the preCICE [Python bindings](https://precice.org/installation-bindings-python.html). Both solvers depend on `numpy`. The fluid solver additionally depends on the Python libraries `scipy matplotlib`. You can get these libraries from your system package manager or with `pip3 install --user <package>`.
+- *Python*: example solvers using the preCICE [Python bindings](https://precice.org/installation-bindings-python.html). The run script installs these automatically via pip in a virtual environment.
 - *Rust*: example solvers using the preCICE [Rust bindings](https://precice.org/installation-bindings-rust.html). They need `cargo` to be installed.
 
 ## Running the Simulation

flow-around-controlled-moving-cylinder/README.md

@@ -29,7 +29,7 @@ OpenFOAM is used for the `Fluid` participant. The spring-damper system is solved
 
 - *OpenFOAM*: To run this case, you need the preCICE [OpenFOAM Adapter](https://precice.org/adapter-openfoam-get.html). OpenFOAM is used to simulate the laminar flow around the cylinder with the solver `pimpleFoam`.
 - *FMI*: A solver using the [preCICE-FMI Runner](https://github.com/precice/fmi-runner) (requires at least v0.2). The Runner executes the FMU model `PIDcontroller.fmu` for computation. The provided run script (see below) builds this model if not already there. If you want to change the model parameters or simulation setup, have a look inside `fmi-settings.json` and `precice-settings.json` (see folder `controller-fmi`).
-- *Python*: A python script solving the spring damper system. It uses the preCICE [Python bindings](https://precice.org/installation-bindings-python.html) and depends on the Python library `numpy`. You can install `numpy` from your system package manager or with `pip3 install --user <package>`.
+- *Python*: A python script solving the spring damper system, using the preCICE [Python bindings](https://precice.org/installation-bindings-python.html). The run script installs the dependencies automatically via pip in a virtual environment.
 
 ## Running the simulation
 

heat-exchanger/README.md

@@ -15,7 +15,7 @@ This is one of our first ever and most popular tutorials, yet definitely not the
 
 This tutorial describes how to run a conjugate heat transfer simulation with two separate OpenFOAM solvers and CalculiX. The files for this tutorial are located in this repository (directory CHT/heat_exchanger).
 
-This tutorial is based on [a case](https://www.simscale.com/projects/cheunglucia/heat_exchanger_-_cht_simulation/) prepared with [SimScale](https://www.simscale.com/) by [Lucia Cheung Yau](https://github.com/ludcila) for her [Master's Thesis](https://www5.in.tum.de/pub/Cheung2016_Thesis.pdf).
+This tutorial is based on [a case](https://www.simscale.com/projects/cheunglucia/heat_exchanger_-_cht_simulation/) prepared with [SimScale](https://www.simscale.com/) by [Lucia Cheung Yau](https://github.com/ludcila) for her [Master's Thesis](https://mediatum.ub.tum.de/1461907).
 
 ## Setup
 

oscillator-overlap/README.md

@@ -27,7 +27,7 @@ preCICE configuration (image generated using the [precice-config-visualizer](htt
 
 This tutorial is only available in Python. You need to have preCICE and the Python bindings installed on your system.
 
-- *Python*: An example solver using the preCICE [Python bindings](https://precice.org/installation-bindings-python.html). This solver also depends on the Python libraries `numpy`, which you can get from your system package manager or with `pip3 install --user <package>`.
+- *Python*: An example solver using the preCICE [Python bindings](https://precice.org/installation-bindings-python.html). The run script installs the dependencies automatically via pip in a virtual environment.
 
 ## Running the Simulation
 

oscillator/README.md

@@ -27,7 +27,7 @@ preCICE configuration (image generated using the [precice-config-visualizer](htt
 
 There are two different implementations:
 
-- *Python*: A solver using the preCICE [Python bindings](https://precice.org/installation-bindings-python.html). This solver also depends on the Python libraries `numpy`, which you can get from your system package manager or with `pip3 install --user <package>`. Using the option `-ts` allows you to pick the time stepping scheme being used. Available choices are Newmark beta, generalized alpha, explicit Runge Kutta 4, and implicit RadauIIA. The solver uses subcycling: Each participant performs 4 time steps in each time window. The data of these 4 substeps is then used by preCICE to create a third order B-spline interpolation (`waveform-degree="3"` in `precice-config.xml`).
+- *Python*: A solver using the preCICE [Python bindings](https://precice.org/installation-bindings-python.html). The run script installs the dependencies automatically via pip in a virtual environment. Using the option `-ts` allows you to pick the time stepping scheme being used. Available choices are Newmark beta, generalized alpha, explicit Runge Kutta 4, and implicit RadauIIA. The solver uses subcycling: Each participant performs 4 time steps in each time window. The data of these 4 substeps is then used by preCICE to create a third order B-spline interpolation (`waveform-degree="3"` in `precice-config.xml`).
 - *FMI*: A solver using the [preCICE-FMI runner](https://github.com/precice/fmi-runner) (requires at least v0.2). The Runner executes the FMU model `Oscillator.fmu` for computation. The provided run scripts (see below) build this model if not already there. For more information, please refer to [2].
 
 ## Running the simulation

perpendicular-flap/README.md

@@ -47,7 +47,7 @@ Solid participant:
 
 * Nutils. The structural model is currently limited to linear elasticity. For more information, have a look at the [Nutils adapter documentation](https://precice.org/adapter-nutils.html). This Nutils solver requires at least Nutils v8.0.
 
-* solids4foam. Like for CalculiX, the geometrically non-linear solver is used by default. For more information, see the [solids4foam documentation](https://solids4foam.github.io/documentation/overview.html) and a [related tutorial](https://solids4foam.github.io/tutorials/more-tutorials/flexibleOversetCylinder.html). This case works with solids4foam v2.0, which is compatible with up to OpenFOAM v2012 and OpenFOAM 9 (as well as foam-extend, with which the OpenFOAM-preCICE adapter is not compatible), as well as the OpenFOAM-preCICE adapter v1.2.0 or later.
+* solids4foam. Like for CalculiX, the geometrically non-linear solver is used by default. For more information, see the [solids4foam documentation](https://solids4foam.github.io/documentation/overview.html) and a [related tutorial](https://www.solids4foam.com/tutorials/more-tutorials/fluid-solid-interaction/flexibleOversetCylinder.html). This case works with solids4foam v2.0, which is compatible with up to OpenFOAM v2012 and OpenFOAM 9 (as well as foam-extend, with which the OpenFOAM-preCICE adapter is not compatible), as well as the OpenFOAM-preCICE adapter v1.2.0 or later.
 
 * OpenFOAM (solidDisplacementFoam). For more information, have a look at the [OpenFOAM plateHole tutorial](https://www.openfoam.com/documentation/tutorial-guide/5-stress-analysis/5.1-stress-analysis-of-a-plate-with-a-hole). The solidDisplacementFoam solver only supports linear geometry and this case is only provided for quick testing purposes, leading to outlier results. For general solid mechanics procedures in OpenFOAM, see solids4foam.
 
@@ -122,6 +122,11 @@ In this case, the coupling between the fluid flow and the flap becomes stronger
 
 With the default value of $$ \rho_s= 3.0·10^{3}kg/m^{3} $$, the simulation will also converge with an explicit coupling scheme. With $$ \rho_s= 1kg/m^{3} $$, the simulation will only converge with implicit coupling, with an acceleration method such as the IQN-ILS in the current configuration.
 
+See [how this tutorial behaves with different coupling algorithms](https://makish.github.io/vki-training/#/17).
+This talk varies the [coupling scheme configuration](https://precice.org/configuration-coupling.html) and demonstrates explicit and implicit coupling schemes, the latter with constant, Aitken, and Anderson acceleration.
+Even though this is not a rigorous study, it demonstrates the effect that different coupling algorithms can have.
+Find more thorough studies in the [literature guide](https://precice.org/fundamentals-literature-guide.html#precice-features).
+
 {% disclaimer %}
 This offering is not approved or endorsed by OpenCFD Limited, producer and distributor of the OpenFOAM software via www.openfoam.com, and owner of the OPENFOAM®  and OpenCFD®  trade marks.
 {% enddisclaimer %}

quickstart/README.md

@@ -14,6 +14,8 @@ toc: false
 
 This is the first step you may want to try if you are new to preCICE: install preCICE and some solvers, and run a simple coupled case.
 
+[![asciicast](https://asciinema.org/a/RqGhiiS8jf2fKTaXgiNn73B1G.svg)](https://asciinema.org/a/RqGhiiS8jf2fKTaXgiNn73B1G)
+
 To get a feeling what preCICE does, watch a [short presentation](https://www.youtube.com/watch?v=FCv2FNUvKA8) or a [longer talk on the fundamentals](https://www.youtube.com/watch?v=9EDFlgfpGBs).
 
 ## Installation

tools/tests/README.md

@@ -10,6 +10,8 @@ The tutorials repository hosts cases that need multiple components from the preC
 
 Read more about the system tests in the publication [System Regression Tests for the preCICE Coupling Ecosystem](https://doi.org/10.14279/eceasst.v83.2614).
 
+[![ECEASST](https://img.shields.io/badge/DOI-10.14279%2Feceasst.v83.2614-green)](https://doi.org/10.14279/eceasst.v83.2614)
+
 ## Running the system tests
 
 The main workflow for the user is executing the `systemtests.py` script. Depending on the options given to the script, it reads in the respective metadata files and generates `docker-compose.yaml` files that can start a fully-defined coupled simulation.