experimental preCICE-adapter for the open source multiphysical simulation software Elmer FEM
- preCICE: please refer to installation documentation.
- Elmer: please refer to Elmer documentation.
The adapter is called during runtime by Elmer. It is developed as a standalone library of Elmer features, so it has to be built before running the simulation. For building, Elmer provides a FORTRAN wrapper to make sure that code compiled by the user is compatible with ElmerSolver.
To build the adapter, navigate to the folder Adapter and run make. If Elmer is installed correctly, this should work out of the box.
Examples for usage of the adapter can be found in the Partitioned_Heat_Conduction/ folder and in the preCICE tutorial flow-over-heated-plate. For new users it is recommended to look at the tutorial case as a starting point.
Assuming you already have a case.sif file and the required mesh files, follow the steps:
- Take one of the existing example cases and copy the
Coupler_Solver.F90from there into your project folder. - Use the provided instructions to compile the adapter.
- Use one of the provided
case.siffiles from the example as a template and add the respective commands for calling the adapter in yourcase.siffile. - Create an appropriate
precice-config.xmlfor the coupling. - Run your case in Elmer via
ElmerSolver case.sif. You should now see that Elmer waits for the other participant. When you start the other participant your coupled simulation will be executed.
Currently, implicit coupling is not supported by the adapter. Parallelization and other advanced features were not explicitly developed or tested.
Partitioned heat equation is thoroughly tested for explicit coupling and gives correct results for an Elmer-Elmer coupling and for Elmer-FEniCS coupling (where Elmer is the Dirichlet participant). If Elmer is the Neumann participant in Elmer-FEniCS coupling, problems occur (probably due to the flux computation, see thesis of Hisham Saeed for details).
The example case Perpendicular_Flap is currently only a monolithic simulation, but a good starting point for FSI. See the perpendicular flap tutorial for details.
Please make sure to use Paraview version >= 5.12. You can check your Paraview version by running paraview --version from the command line.
- Elmer-preCICE: If you are using this adapter (Elmer-preCICE), please consider citing the thesis of Hisham Saeed.
- preCICE: preCICE is an academic project, developed at the Technical University of Munich and at the University of Stuttgart. If you use preCICE, please cite preCICE.
- Elmer: If you are using Elmer, please also consider citing the Elmer repository.
- The initial version of this adapter was developed by Hisham Saeed during his work on his master's thesis under supervision of Benjamin Rodenberg.
- The adapter and the flow over heated plate tutorial case were updated for preCICE version 3 by Alihossein Sepahvand.