FESTUNG (Finite Element Simulation Toolbox for Unstructured Grids) is a Matlab / GNU Octave toolbox for the discontinuous Galerkin (DG) method on unstructured grids. It is primarily intended as a fast and flexible prototyping platform and testbed for students and developers.
FESTUNG relies on fully vectorized matrix/vector operations to deliver optimized computational performance combined with a compact, user-friendly interface and a comprehensive documentation.
Have a look at our gallery for example applications that use FESTUNG.
- The latest published version can always be downloaded from the GitHub repository. To check out the latest version, run
git clone --recursive https://github.com/FESTUNG/project.git
- Tarballs of previous code versions and further information about the project can be found on our Project page.
Model problems are defined following a generic solver structure.
Have a look at the implementation of the standard (element-based) DG discretizations of linear advection (folders
advection for time-explicit and
advection_implicit for time-implicit) or the LDG discretization of the diffusion operator (folder
A hybridized DG discretization of linear advection can be found in the folder
Start the computation for any of these problems using
main(<folder name>), for example
To change simulation parameters or modify initial and boundary data, have a look into
configureProblem.m in the respective problem folder, or pass them directly when calling the problem solver, e.g.,
main('advection', 'tEnd', 10, 'p', 1, 'hmax', 2^-4)
to run the Advection problem with a different end time and linear ansatz functions on a mesh with maximum element size of 1/16.
When developing code for or with FESTUNG we suggest to stick to the Naming convention to allow for better readability and a similar appearance of all code parts. Keep in mind the generic solver structure when modifying and adding new problems. All files should be documented using the Doxygen syntax.
For more details, see Using and contributing to FESTUNG.
All routines are carefully documented in the Doxygen format, which allows to produce this documentation. It can be generated by calling
doxygen in the main directory.
The main developers of FESTUNG are Florian Frank, Balthasar Reuter, and Vadym Aizinger. Its initial release was developed at the Chair for Applied Mathematics I at Friedrich-Alexander-University Erlangen-Nürnberg.
Third party libraries
- FESTUNG makes extensive use of the built-in routines in MATLAB / GNU Octave.
- triquad was written by Greg von Winckel. See triquad.txt for license details.
- m2cpp.pl by Fabrice to generate a Doxygen documentation. See license.txt for license details.
FESTUNG is published under GPLv3, see License file.
- Version 0.1 as published in the paper Frank, Reuter, Aizinger, Knabner: "FESTUNG: A MATLAB / GNU Octave toolbox for the discontinuous Galerkin method. Part I: Diffusion operator". In: Computers & Mathematics with Applications 70 (2015) 11-46, Available online 15 May 2015, ISSN 0898-1221, http://dx.doi.org/10.1016/j.camwa.2015.04.013.
- Version 0.2 as published in the paper Reuter, Aizinger, Wieland, Frank, Knabner: "FESTUNG: A MATLAB / GNU Octave toolbox for the discontinuous Galerkin method. Part II: Advection operator and slope limiting". In: Computers & Mathematics with Applications 72 (2016) 1896-1925, Available online 25 August 2016, ISSN 0898-1221, http://dx.doi.org/doi:10.1016/j.camwa.2016.08.006.
- Version 0.3 as published in the paper Jaust, Reuter, Aizinger, Schuetz, Knabner: "FESTUNG: A MATLAB / GNU Octave toolbox for the discontinuous Galerkin method. Part III: Hybridized discontinuous Galerkin (HDG) formulation". In: Computers & Mathematics with Applications (2018) in press, Available online 2 May 2018, ISSN 0898-1221, https://doi.org/10.1016/j.camwa.2018.03.045.
- Version 0.4 as published in the paper Reuter, Rupp, Aizinger, Frank, Knabner: "FESTUNG: A MATLAB / GNU Octave toolbox for the discontinuous Galerkin method. Part IV: Generic problem framework and model-coupling interface". Submitted to Computers & Mathematics with Applications (2018).