(For installation of programms use apt in Ubuntu or dnf in Fedora. Search for available programms first using the search option)

1. Install a fortran compiler (gfortran from gcc).

2. Install openmpi and its development version (openmpi-dev) or mpich (and mpich-dev) (mpich is only recommended for fedora; in Ubuntu using mpich could lead to some extra work as some programms as e.g. paraview use openmpi by default, and it has to be ensured, that compiling and running wabbit only uses mpich or openmpi but not both).

3. Install zlib-devel (and zlib).

4. Install hdf5 as described on the WABBIT mainpage. Note that it is not necessary that make check executes without errors as hdf5 is much more powerfull than necessary for WABBIT and not all of it is needed. BUT check if after executing "make" and "make install" the folder "include" exists and contains the file "h5f.mod" and further .mod files. Do not forget to export the variables as written on the WABBIT mainpage; if you write the commands to your bash, do not forget to reopen your shell. ;)

5. Install the BLAS and LAPACK library and their development packages (if you install lapack-devel then blas, blas-devel and lapack should be installed automatically).

6. Install the python-tools repository somewhere. Note that you will have to update this repository from time to time.

cd /home/user/PYTHON/ 

# get a copy of the repository
git clone https://github.com/adaptive-cfd/python-tools .              

# add the path to the PYTHONPATH variable (such that other python scripts can use "import wabbit_tools")
export PYTHONPATH=$PYTHONPATH:/home/user/PYTHON/

# add it to bash path (such that you can use commands like "wabbit-compare-hdffiles.py" in the shell)
export PATH=${PATH}:$HOME/Documents/PYTHON:$HOME/Documents/PYTHON/bin 

# test if that all worked: 
which wabbit-compare-hdffiles.py 

# the output of this command should be_
# /home/user/PYTHON/bin/wabbit-compare-hdffiles.py_

# after a while, check if there are updates available:
cd /home/user/PYTHON/
git pull

6. Clone WABBIT and run make.

7. Try to run the tests with make test.

Failing tests could be caused by (a.) memory issues and (b.) if the versions of mpi library are not used correctly. Check on the log-file of one of the failed tests.

1. Set the memory, WABBIT will use a bit lower than half of your working storage using export `memory="--memory=3.0GB"` (here for example the working storage is 8GB)

   check the versions of mpi used

   mpif90 –v
   mpirun --version
   

   Both should be mpich. In case the runs are executed by (for example) openmpi you can either remove this programm (remove openmpi-bin and libopenmpi-dev in case these are installed at your system) or somehow tell your system to prefere mpich and not openmpi.