This miniapp solves the compressible fluid dynamics (Euler) equations using 2D cartesian grids, parallelized for shared memory system. The full application for 2D/3D grids with MPI and Kokkos is available here : https://github.com/pkestene/euler_kokkos

Get the source

Our miniApp uses kokkos as a git submodule, configured to use the develop branch of kokkos. In order to download the sources all-in-one (miniApp + kokkos):

git clone --recursive [email protected]:pkestene/euler2d_kokkos.git

Alternatively, if you didn't use option --recursive, you can afterwards retrieve kokkos like this

git submodule init
git submodule update

Build

We strongly recommend the out-of-source build, so that one can have one build directory per architecture.

If you already have Kokkos installed

Just make sure that your env variable CMAKE_PREFIX_PATH point to the location where Kokkos where installed. More precisely if Kokkos is installed in KOKKOS_ROOT, you add $KOKKOS_ROOT/lib/cmake to your CMAKE_PREFIX_PATH; this way kokkos will be found automagically by cmake, and the right Kokkos backend will be selected.

mkdir -p build; cd build
cmake -DEULER2D_KOKKOS_BUILD=OFF ..
make

You should now have executable euler2d. You can run a simply implode test like this

cd src
./euler2d ./test_implode.ini

Kokkos is not already installed => build for Kokkos/OpenMP

To build for Kokkos/OpenMP backend (which is the default backend):

mkdir -p build/openmp; cd build/openmp
cmake -DEULER2D_KOKKOS_BUILD=ON -DKokkos_ENABLE_OPENMP=ON ../..
make

You should now have executable euler2d. You can run a simply implode test like this

cd src
./euler2d ./test_implode.ini

Optionally, you can (recommended) activate HWLOC support by turning ON the flag Kokkos_ENABLE_HWLOC.

Kokkos is not already installed => build for Kokkos/CUDA

Obviously, you need to have Nvidia/CUDA driver and toolkit installed on your platform.

Example configuration:

mkdir build/cuda; cd build/cuda
cmake -DEULER2D_KOKKOS_BUILD=ON -DKokkos_ENABLE_CUDA=ON -DKokkos_ENABLE_CUDA_LAMBDA=ON -DKokkos_ARCH_TURING75=ON -DKokkos_ENABLE_HWLOC=ON ../..
make

Be aware that, kokkos will not use Nvidia compiler nvcc directly, but will use a wrapper instead (located in Kokkos source directory).

then make should give you a working executable euler2d running on GPU.

cd src
./euler2d ./test_implode.ini