Skip to content
This repository has been archived by the owner on Jun 20, 2024. It is now read-only.

Latest commit

 

History

History
84 lines (57 loc) · 2.85 KB

README.md

File metadata and controls

84 lines (57 loc) · 2.85 KB
Raw

Warning

Superseded by https://github.com/UoB-HPC/CloverLeaf, which contains a StdPar implementation, along with many other models.

A C++ stdpar port of CloverLeaf

This is a port of CloverLeaf from MPI+Kokkos to MPI+stdpar

Tested configurations

The program was compiled and tested on the following configurations.

Building

Prerequisites:

  • CentOS 7
  • cmake3
  • openmpi, opemmpi-devel
  • devtoolset-7
  • C++17 compiler: NVHPC, GCC with TBB, etc.

First, generate a build:

cmake3 -Bbuild -H. -DCMAKE_BUILD_TYPE=Release

Flags:

  • MPI_AS_LIBRARY - BOOL(ON|OFF), enable if CMake is unable to detect the correct MPI implementation or if you want to use a specific MPI installation. Use this a last resort only as your MPI implementation may pass on extra linker flags.
    • Set MPI_C_LIB_DIR to <mpi_root_dir>/lib
    • Set MPI_C_INCLUDE_DIR to <mpi_root_dir>/include
    • Set MPI_C_LIB to the library name, for exampe: mpich for libmpich.so
  • CXX_EXTRA_FLAGS - STRING, appends extra flags that will be passed on to the compiler, applies to all configs
  • CXX_EXTRA_LINKER_FLAGS - STRING, appends extra linker flags (the comma separated list after the -Wl flag) to the linker, applies to all configs
  • USE_VECTOR - BOOL(ON|OFF), whether to use std::vector for the backing buffers or plain pointers through std::malloc.

Offload specific flags:

  • USE_TBB - BOOL(ON|OFF), whether to download, compile, and link TBB as part of the build. This is useful for the PSTL implementation of libstdc++ which delegates to TBB.
  • NVHPC_OFFLOAD - STRING, enables offloading support (via the non-standard -stdpar) for the NVHPC SDK. The values are Nvidia architectures in ccXY format which will be passed in via -gpu= (e.g cc70).

If parts of your toolchain are installed at different places, you'll have to specify it manually, for example:

cmake3 -Bbuild -H.  \
-DCMAKE_CXX_COMPILER=/PATH/TO/NVHPC/nvc++ \
-DNVHPC_OFFLOAD=cc80 \  
-DCMAKE_BUILD_TYPE=Release \

Proceed with compiling:

cmake3 --build build --target clover_leaf --config Release -j $(nproc)

Running

The main clover_leaf executable takes a clover.in file as parameter and outputs clover.out at working directory.

For example, after successful compilation, at project root:

./build/clover_leaf --file InputDecks/clover_bm16_short.in

See Tested configurations for tested platforms and drivers.

For help, use the -h flag:

Options:
  -h  --help               Print the message
      --list               List available devices
      --device <INDEX>     Select device at INDEX from output of --list
      --file               Custom clover.in file (defaults to clover.in if unspecified)