v202404.0 - Now with preCICE v3

It took a while, but the wait was worth it, we promise!

Important

This release (only) works with preCICE v3! And this is also the first release to support preCICE v3.

Some of the new tutorials:

• two-scale heat conduction, using the new Micro Manager.
• flow around controlled moving cylinder, using the new FMI runner.
• breaking dam with flexible pillar 2D
• partitioned flow over a backwards-facing step
• partitioned flow over a heated plate
• partitioned pipe: two-phase
• oscillator: overlap
• partitioned heat conduction: overlap
• volume-coupled flow

The following tutorials include new options:

• channel transport
• oscillator
• flow over a heated plate
• perpendicular flap
• elastic tube 1D

Besides the above, all tutorials now include a visual representation of their configuration, they automatically export the screen output into log file, and we finally include a .gitignore file. Under the hood, this is the first release to sport our revived system regression tests and some reference results for the tutorials we currently test.

Many more fixes and improvent are included in this (massive) release. Have a look at the changelog, or compare to the v2211.0 release.

Besides the preCICE maintainers (in alphabetical order: @BenjaminRodenberg, @carme-hp (new), @davidscn, @fsimonis, @Fujikawas (new), @IshaanDesai, @KyleDavisSA, @MakisH, @uekerman), this time we also have community and student contributions by @gertjanvanzwieten, @j-signorelli (new), @mathiskelm (new), @NiklasVin (new), @PhilipHildebrand (new, but we will actually bring these FEniCSx tutorials later), @theBelpo (new), @Timo-Schrader (new), @tirgendetwas (new), @thesamriel, @valentin-seitz. Thank you all very very much! 🤗

v202211.0 - Before the iceberg hits

As we announced with the preCICE v2.5.0 release notes, the next preCICE release will be v3.0.0. This is the last tutorials release that works with preCICE v2.x, as some examples directly use preCICE. This is also part of the preCICE Distribution v2211, released for the same reason.

A few new tutorials, several new tutorial cases, and a few bug fixes are part of this release. Among other news, we have new tutorials:

• ASTE tutorial, demonstrating the preCICE Artificial Solver Testing Environment
• Oscillator tutorial
• Uni-directional volume-coupled channel transport tutorial
• Channel transport with chemical reactions tutorial
• Partitioned heat conduction using direct mesh access tutorial
• Simplified heat exchanger tutorial

This also brings several new cases in existing tutorials, mainly for the perpendicular flap (solid-openfoam, solid-solids4foam, modal dynamic option in solid-calculix) and the flow over a heated plate (solid-dunefem, solid-calculix - as a separate tutorial).

There are also a few changes and fixes. See the CHANGELOG.md for more details.

Once again, this is the result of hard work from many contributors. This release includes direct code contributions and reviews/testing by (in alphabetic order): @BenjaminRodenberg @boris-martin @davidscn @fsimonis @gertjanvanzwieten @IshaanDesai @kanishkbh @kursatyurt @KyleDavisSA @lupaz @MakisH @mennodeij @NiklasKotarsky @scdivi @thesamriel @valentinaschueller @uekerman

New tutorials and several changes (workshop is coming!)

New year, new tutorial cases!

In this scheduled release (part of the preCICE Distribution 2202.0 and in the context of the preCICE Workshop 2022), you can find:

• A new volume coupled diffusion tutorial with FEniCS
• Our first tutorial case with DUNE: a solid solver for the perpendicular flap tutorial.
• An OpenFOAM version of the partitioned heat confuction tutorial.
• A FEniCS version of the elastic tube 3D tutorial.

Additionally, this release brings several changes changes. Most importantly, we changed the type of elements that CalculiX uses in the perpendicular flap tutorial (from C3D8 to C3D8I), which now performs very similarly to the rest of the cases. We also cleaned up several configuration files from confusing unnecessary details. See the changelog or all file changes for more details.

Once more, this release was a collective effort by the complete preCICE team. It includes code contributions by @IshaanDesai, @BenjaminRodenberg, @davidscn, @MakisH, further contributions by @fsimonis, @KyleDavisSA, and @uekerman, as well as first-time community contributions by @AndresPedemonteFIUBA, @maxfirmbach, and @mohamad-altaweel.

v202104.1.1 - a small patch for you

Minor fixes affecting flow-over-heated-plate-steady-state and elastic-tube-1d (#212):

• The helper tool openfoam_remove_empty_dirs now respects also results in the compressed OpenFOAM format (76f4482). This was previously deleting all results at the end of the flow-over-heated-plate-steady-state case.
• The post-processing functionality of the elastic-tube-1d and the respective documentation are now in synch. (#209)
• Further small issues in the documentation are now fixed.

A new structure for the tutorials

Over the past months, we redesigned the tutorials of preCICE. Previously, cases often had inconsistent names (e.g. flap_perp), were offered only for specific combinations of solvers (e.g. OpenFOAM-CalculiX) and had quite some duplication in the related run & clean scripts.

This is the first versioned release, which you can rely upon and refer to for the next months. We will be following the scheme <year-month>.<minor>.<patch>, following the system used in the preCICE VM (Vagrant box).

Highlights of this release:

• No more scattering of documentation: Find everything directly in our redesigned preCICE website (rendered from the README.md files here, so you can also check the basic information without internet connection).
• No more scattering of case files: We know, keeping the OpenFOAM-only cases in the OpenFOAM adapter repository did not really help.
• New directory structure. Read more in the contributing guidelines.
• Self-contained cases: The files for each case are inside its own directory, e.g. fluid-openfoam. The exchange directory is set to .., next to precice-config.xml.
• Arbitrary combinations of solvers: Run OpenFOAM-CalculiX, OpenFOAM-deal.II, SU2-deal.II, ... you name it!
• A standard way to run each case: Get into the case folder you want to run and execute ./run.sh. We kept these scripts as short as possible, so that you can easily copy from them.
• A standard way to clean: A clean<what>.sh script in each directory cleans up everything from this level and deeper.
• An easy-to-run first tutorial: We created a quickstart tutorial to get everything you need and run a simple case on your laptop.
• Better 2D cases: Two-dimensional cases such as the (now rotated) perpendicular flap are using the 2D interface of preCICE and every involved adapter supports a 2D mode.
• A validated Turek-Hron FSI3: No more "cylinder-flap is almost like FSI3, but not exactly". You can now validate your cases starting from this case, validated with OpenFOAM and non-linear deal.II.
• Formatting & linting: Our Python scripts, shell scripts, and Markdown files are now a little bit more robust and pretty!

Update your adapters to their latest state and enjoy! 🤗

With love,
the preCICE team