/parthenon

Parthenon AMR infrastructure

Primary LanguageC++OtherNOASSERTION

parthenon

Parthenon AMR infrastructure

Community

Required Dependencies

  • CMake 3.10 or greater
  • gcc or intel compiler
  • mpi
  • openMP
  • hdf5
  • kokkos

Dependencies Other

  • catch2

Installation

For detailed instructions for a given system, see our build doc.

Basics

mkdir build
cd build
cmake ../
make
make test

Import Into Your Code

// Imports all of parthenon's public interface
#include <parthenon/parthenon.hpp>

// You can use one of the following headers instead if you want to limit how
// much you import. They import Parthenon's Driver and Package APIs,
// respectively
#include <parthenon/driver.hpp>
#include <parthenon/package.hpp>

// The following namespaces are good short-hands to import commonly used names
// for each set of Parthenon APIs.
using namespace parthenon::driver::prelude;
using namespace parthenon::package::prelude;

Parallel_for wrapper options

Following options are available to configure the default behavior of the par_for wrappers.

  • PAR_LOOP_LAYOUT (sets default layout)
    • MANUAL1D_LOOP maps to Kokkos::RangePolicy (default for CUDA backend)
    • MDRANGE maps to Kokkos::MDRangePolicy
    • SIMDFOR_LOOP maps to standard for loops with #pragma omp simd (default for OpenMP backend)
    • TPTTR_LOOP maps to double nested loop with Kokkos::TeamPolicy and Kokkos::ThreadVectorRange
    • TPTVR_LOOP maps to double nested loop with Kokkos::TeamPolicy and Kokkos::ThreadVectorRange
    • TPTTRTVR_LOOP maps to triple nested loop with Kokkos::TeamPolicy, Kokkos::TeamThreadRange and Kokkos::ThreadVectorRange

Kokkos options

Kokkos can be configured through cmake options, see https://github.com/kokkos/kokkos/wiki/Compiling

For example to build with the OpenMP backend for Intel Skylake architecture using Intel compilers

mkdir build-omp-skx && cd build-omp-skx
cmake -DKokkos_ENABLE_OPENMP=On -DCMAKE_CXX_COMPILER=icpc -DKokkos_ARCH_SKX=On ../

or to build for NVIDIA V100 GPUs (using nvcc compiler for GPU code)

mkdir build-cuda-v100 && cd build-cuda-v100
cmake -DKokkos_ENABLE_CUDA=On -DCMAKE_CXX_COMPILER=$(pwd)/../external/kokkos/bin/nvcc_wrapper -DKokkos_ARCH_VOLTA70=On ../

Developing/Contributing

Please see the developer guidelines for additional information.

Documentation

Please see the docs/ folder for additional documentation on features and how to use them.

Contributors

Name Handle Team
Jonah Miller @Yurlungur LANL Physics
Josh Dolence @jdolence LANL Physics
Andrew Gaspar @AndrewGaspar LANL Computer Science
Philipp Grete @pgrete Athena Physics
Forrest Glines @forrestglines Athena Physics
Jim Stone @jmstone Athena Physics
Jonas Lippuner @jlippuner LANL Computer Science
Joshua Brown @JoshuaSBrown LANL Computer Science
Christoph Junghans @junghans LANL Computer Science
Sriram Swaminarayan @nmsriram LANL Computer Science
Daniel Holladay @dholladay00 LANL Computer Science
Galen Shipman @gshipman LANL Computer Science