Build status of the library against official deal.II docker images:
This library provides classes and functions to solve instationary partial differential equations by using space-time finite elements i.e. finite elements in both time and space. It heavily builds on the 1 to 3d finite element capabilities of deal.II so you should make yourself familiar with solving stationary problems with that library first.
First you need to install deal.II by following the instructions on their site. If you plan on using parallel linear algebra and other advanced features of deal.II and ideal.II you should use either the cmake superbuild or candi. Note down the installation directory of deal.II (for example ~/Software/dealii)
The installation of ideal.II is based on CMake as well, the steps are as follows.
-
Choose an installation directory for ideal.II (for example ~/Software/idealii)
-
Open a console and go to a directory where you want to download the source files (e.g. ~/Downloads) and clone the repository
cd ~/Downloads
git clone https://github.com/instatdealii/idealii
- After cloning is finished execute the following commands (with the above directory examples write ~/Software/dealii instead of <path_to_your_deal_installation> and ~/Software/idealii instead of <path_to_install_idealii_in>
cd idealii
cmake -S. -Bbuild -DDEAL_II_DIR=<path_to_your_deal_installation> -DCMAKE_INSTALL_PREFIX=<path_to_install_idealii_in>
cmake --build build
cmake --install build
Take a look at one of the example steps and copy the CMakeLists.txt file from there into your project directory. Set the correct project name and sources and then call the following commands from your project directory.
cmake -S. -Bbuild -DIDEAL_II_DIR=<path_to_install_idealii_in>
cmake --build build
Then the executable will be inside the build subdirectory.
The software metapaper is currently in preparation. Once published the readme will be updated accordingly.
If you write a paper using results obtained with the help of ideal.II, please cite the following reference:
- Jan Philipp Thiele, ideal.II: a Galerkin space-time extension to the finite element library deal.II, preprint(2024), arXiv 2408.08840
@misc{idealII,
archiveprefix = {arXiv},
author = {Thiele, Jan Philipp},
eprint = {2408.08840},
primaryclass = {math.NA},
title = {ideal.{II}: a Galerkin Space-Time Extension to the Finite Element Library deal.{II}},
year = {preprint(2024), \url{https://arxiv.org/abs/2408.08840}}
}
- Please also cite deal.II as explained here
A full documentation including the underlying mathematics (WIP) can be found here.
The doxygen API Reference of the library functions can be found here.