About

[Lexi][elexi] is a high-order numerical Eulerian-Lagrangian framework for solving PDEs, with a special focus on Computational Fluid Dynamics. It is an extension of FLEXI which is based on the Discontinuous Galerkin Spectral Element Method (DGSEM). DGSEM allows for high-order of accuracy and fully unstructured hexahedral meshes. The solver is parallelized very efficiently for large-scale applications and scales to 500,000+ cores. Moreover, [Lexi][elexi] comes with a capable pre- and post-processing suite that enables complex simulation setups up to the finished visualization.

For the main development branch, see flexi-framework/flexi. This repository contains an extension of FLEXI towards particle-laden flows. The particle tracking approach operates in physical space and is based on methods from ray-tracing to handle intersections with possibly curved boundaries. Particles are implemented with a Lagrangian point-particle ansatz and can either be one-, two- or four-way coupled to the fluid phase. Particle-particle and particle-wall interactions are handled via a hard-sphere approach, where multiple models are available.

For details on the available models and implementation, see our paper in Computer Physics Communications or the manuscript on arxiv.

[Lexi][elexi]/FLEXI has been developed by the Numerics Research Group (NRG) founded by Prof. Claus-Dieter Munz and currently lead by Prof. Andrea Beck at the Institute of Aerodynamics and Gasdynamics at the University of Stuttgart, Germany.

You can find detailed installation instructions, the extensive documentation and several tutorial cases for FLEXI here.

[Lexi][elexi]/FLEXI is Copyright (C) 2016, Prof. Claus-Dieter Munz and is released under the GNU General Public License v3.0. For the full license terms see the included license file.

Numerous people have worked on and with [Lexi][elexi]/FLEXI over the last years. We would like to thank all these contributors for their efforts they spent on building [Lexi][elexi]/FLEXI.

In case you have questions regarding Lexi or want to contribute yourself by either reporting bugs, requesting features or adding somthing different to the project, feel free to open an issue or pull request.

Cite

Lexi is a scientific project. If you use Lexi for publications or presentations in science, please support the project by citing it. As general reference, please cite Kopper, P., Schwarz, A., Copplestone, S. M., Ortwein, P., Staudacher, S., and Beck, A. A framework for high-fidelity particle tracking on massively parallel systems Computer Physics Communications, 289, (2023), 108762 or use the following Bibtex entry

@article{elexi,
 title     = {A framework for high-fidelity particle tracking on massively parallel systems},
 author    = {Kopper, Patrick and Schwarz, Anna and Copplestone, Stephen M. and Ortwein, Philip and Staudacher, Stephan and Beck, Andrea},
 journal   = {Computer Physics Communications},
 year      = {2023},
 month     = aug,
 pages     = {108762},
 doi       = {10.1016/j.cpc.2023.108762},
 publisher = {Elsevier},
}

To refer to specific applications and features, you can also cite the appropriate paper from this list.

Quick Start Guide

For a more detailed installation instructions, please see the online documentation or the userguide.

[Lexi][elexi] is tested for various Linux distributions including Ubuntu, OpenSUSE, CentOS, or Arch. Lexi also runs on macOS. For the installation, you require the following dependencies:

| Package | Required | Installed by Lexi | |:-----------------|:--------:|:------------------:| | Git | x | | | CMake | x | | | Fortran and C/C++ Compilers (GNU compilers recommended) | x | | | LAPACK / OpenBLAS | x | x | | HDF5 | x | x | | MPI | (x) | | | OpenMP | (x) | | | FFTW | (x) | x | | PAPI | | | | Reggie2.0 | | | | ParaView | | |

The MPI library is only required for running parallel simulations on multiple ranks. The HDF5 and LAPACK libraries can are optionally built and locally installed during the FLEXI build process. The names of the packages and the package manager might differ depending on the specific distribution used.

Getting the code

Open a terminal, download [Lexi][elexi] via git

git clone git@github.com:flexi-framework/elexi.git

Compiling the code

Enter the [Lexi][elexi] directory, create a build directory and use CMake to configure and compile the code

cd elexi
cmake -B build
cmake --build build

The executable elexi is now contained in the Lexi directory in build/bin/. Custom configurations of the compiler options, dependencies, and code features can be set using

ccmake -B build

Running the code

Navigate to the directory of the tutorial cavity and run [Lexi][elexi]

cd tutorials/cavity
flexi parameter_flexi.ini