This is the ExaHyPE Teaching Code

This is the main repository of the ExaHyPE teaching code project.

Mini installation guide

ExaHyPE has several dependencies, when running on your local machine make sure you have either a gcc/5.0 or later or an intel compiler 2018 or later. Alternatively, only if you are running on IvyMUC you can use the modules listed in the bashrc file in this repository. Move it to ~/.bashrc and then run source ~/.bashrc.

Copy and paste these commands to start with a working ExaHyPE application and initialize the demo application Euler_ADERDG:

git clone https://github.com/annereinarz/ExaHyPE-Workshop-Engine
cd ExaHyPE-Workshop-Engine
./Submodules/updateSubmodules.sh
./Toolkit/toolkit.sh Demonstrators/EulerADERDG/EulerADERDG.exahype

Now you are ready to compile and run an ExaHyPE application according to the guidebook:

cd Demonstrators/EulerADERDG
make
./ExaHyPE-EulerADERDG EulerADERDG.exahype

After the simulation finished you will find some files with the suffix .vtk in The folder Demonstrators/Euler_ADERDG, which you can open in Paraview.

Requirements

If above doesn't work you might want to try these fixes

If you don't have a g++ compiler install it via apt-get sudo apt-get install g++

To run programms on multiple threads it is necessary that you have Intel TBB installed. You can find the most recent version at TBB or run the installer script.

The installer script will return you some output similar to this (The paths might differ on your machine)

add this to you .bashrc (/home/user/.bashrc):
export TBB_INC="-I /home/user/ExaHyPE-Teaching/tbb/include"
export TBB_SHLIB="-L /home/user/ExaHyPE-Teaching/tbb/build/linux_intel64_gcc_cc5.4.0_libc2.23_kernel4.15.0_release -ltbb"
and hit
source /home/user/.bashrc

Follow the instructions and add the lines

export TBB_INC="-I /home/user/ExaHyPE-Teaching/tbb/include"
export TBB_SHLIB="-L /home/user/ExaHyPE-Teaching/tbb/build/linux_intel64_gcc_cc5.4.0_libc2.23_kernel4.15.0_release -ltbb"

to /home/user/.bashrc (If the file doesn't exists create it) after that open a new terminal or apply the .bashrc to your current shell: source /home/user/.bashrc

To be able to look at the generated .vtk output it is necessary to have Paraview installed.

Support

We only support default Linux systems like Ubuntu and Mint.

There currently is no support for Windows or Mac, please use a virtual machine like VirtualBox