WABBIT

(W)avelet (A)daptive (B)lock-(B)ased solver for (I)nteractions with (T)urbulence

With WABBIT it is possible to solve partial differential equations on block-based adaptive grids. Calculations in 2D and 3D are possible and is performed fully parallel. As in WABBIT the set of PDE is encapsulated from the rest of the code the PDE implementation is similar to calculatoins with single domain code. Solvable PDEs are of type

$\partial_t \phi = N(\phi)$

and $N(\phi)$ can be defined.

Getting Started

How to get a copy of WABBIT and compiling the code:

Clone from github

git clone https://github.com/adaptive-cfd/WABBIT

Compile the code running make.

Note that WABBI requires:
- MPI library
- HDF5 library
- BLAS+LAPACK library
- some variables have to be exported (see below).

make [FC=[mpif90]]

Run the testfiles with

make test

HDF5 Library

Make sure that the mpi library which is also used for WABBIT is installed (for example by loading mpich3).

This is a short example (/working practice) of how to install hdf5 libary (Tested for version hdf5-1.10.1).

download source code from hdf5
open terminal and follow
(mind that path_2_build_dir has to be replaced by the path of the directory of your choice.)

gunzip < hdf5-X.Y.Z.tar.gz | tar xf -
cd hdf5-X.Y.Z
./configure --prefix=path_2_build_dir --enable-fortran --enable-parallel
make
make check                # run test suite.
make install
make check-install        # verify installation.

export variables:

HDF_ROOT=path_2_build_dir
export HDF_ROOT
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${HDF_ROOT}/lib:${HDF_ROOT}/lib64
export LD_RUN_PATH=$LD_LIBRARY_PATH

Recommendtaion: Add the lines to export the variables to your bashrc-file.

run WABBIT

Customize the .ini-file and rename file to [your_filename.ini], run WABBIT with option for dimension and .ini-file name

wabbit [2D|3D] [your_filename.ini] --memory=2.0GB

where the --memory options allows you to approximately control how much memory is globally allocated, i.e., on all ranks. Note that WABBIT does not free memory which is once allocated again during runtime. This is because we intent to use clusters, where the globally available memory is reserved for the exectution.

Additional Information

If you are new to WABBIT it is recommended to read the information for newcomers!

In case you have problems with the preparation to use WABBIT, have a look at the informations given in the wiki

For further Information see the documentation. Therefor it is necessary to have Doxygen installed.

make doc

Publications

"An Open and Parallel Multiresolution Framework Using Block-Based Adaptive Grids"; Sroka, Engels, Krah, Mutzel, Schneider, Reiss; Active Flow and Combustion Control 2018

History

v0.1 - 2D, periodic boundary, mesh adaption --- lots of schemes for testing
v0.2 - 2D, periodic boundary, mesh adaption --- change mesh adaption to paris_meeting-version, simplify code
v0.3 - 2D, periodic boundary, mesh adaption --- MPI added, split block data in light/heavy data
v0.4 - 2D, periodic boundary, mesh adaption --- reworked data structure, order subroutines and switch to explicit variable/parameter passing
v0.5 - 3D, 2D, periodic boundary, mesh adaption --- now uses 3D

ligaohua / WABBIT