Wherever the information in this documentation is not enough (in this case, let us know), you may find a wide spectrum of additional information in publications. This page will guide you through it.
Starting points
-
The main reference article for preCICE is preCICE - A Fully Parallel Library for Multi-Physics Surface Coupling. This may not be the best introduction for new users because of its condensed form. A very good first reading is the dissertations of the core preCICE developers.
-
Bernhard Gatzhammer introduced preCICE in his dissertation Efficient and Flexible Partitioned Simulation of Fluid-Structure Interactions (2014). Chapters 1-4 give a detailed introduction of most of the preCICE features and are still valid to a large extend. Start here for an explanation of the different coupling schemes, of the different communication methods, or of the data mapping techniques. Note that the “geometry interface” and “server mode” features have been removed.
-
Benjamin Uekermann introduced inter- and intra-solver parallelization in his dissertation Partitioned Fluid-Structure Interaction on Massively Parallel Systems (2016). Chapter 2 gives a compact introduction to preCICE. Furthermore, read here especially for the parallel coupling schemes, which allow a simultaneous execution of multiple solvers (Chapter 3) and the realization of all main features on distributed data (Chapter 4).
The list of completed dissertations also includes:
-
Klaudius Scheufele: Coupling schemes and inexact Newton for multi-physics and coupled optimization problems. (2018)
-
Florian Lindner: Data Transfer in Partitioned Multi-Physics Simulations: Interpolation & Communication (2019)
and the story continues by the current team.
preCICE features
-
Coupling schemes For an introduction to explicit and implicit coupling, as well as the various acceleration / post-processing techniques, have a look at the dissertations of Bernhard Gatzhammer (Sections 2.3 and 4.1) and Benjamin Uekermann (Chapter 3).
-
Data mapping For an introduction to the various techniques, have a look at the dissertations of Bernhard Gatzhammer (Sections 2.4 and 4.2) and Benjamin Uekermann (Section 4.3). For a more condensed overview of RBF mapping, see Radial Basis Function Interpolation for Black-Box Multi-Physics Simulations
-
Communication For an introduction to the various techniques, have a look at the dissertation of Bernhard Gatzhammer (Section 4.3). Have a look also at the master’s thesis of Alexander Shukaev: “A Fully Parallel Process-to-Process Intercommunication Technique for preCICE”.
-
Time interpolation This feature is currently under active development. Have a look at the publications, talks, and posters of Benjamin Rodenberg.
Parallel and high-performance computing
- The initial effort for parallelization of preCICE is documented in Partitioned Fluid-Structure-Acoustics Interaction on Distributed Data: Coupling via preCICE (2016).
- Further steps to speed up initialization are documented in ExaFSA: Parallel Fluid-Structure-Acoustic Simulation (2020).
- The parallelization of communication initialization is published in Efficient and Scalable Initialization of Partitioned Coupled Simulations with preCICE (2021).
- More details can be found in Benjamin’s thesis (2016), Florian’s thesis (2019), and Klaudius’ thesis (2019).
Adapters
-
For the official adapters for open-source solvers, an overview is given in “Official preCICE Adapters for Standard Open-Source Solvers” (2017).
-
For the first implementation of the OpenFOAM, CalculiX, and Code_Aster adapters, have a look at Lucia Cheung Yau’s Master’s Thesis Conjugate Heat Transfer with the Multiphysics Coupling Library preCICE (2016). Start here also for the physics of Conjugate Heat Transfer. The OpenFOAM adapter was then extended by Gerasimos Chourdakis in his Master’s Thesis A general OpenFOAM adapter for the coupling library preCICE (2017). Start here for the structure of the current OpenFOAM adapter. For the additional functionality to support mechanical FSI simulations, have a look at Derek Risseeuw’s thesis.
-
For the SU2 adapter, read Alexander Rusch’s Bachelor’s Thesis Extending SU2 to Fluid-Structure Interaction via preCICE (2016). In this you can also find a quick introduction to Fluid-Structure Interaction.