diff --git a/docs/00_intro/introduction.rst b/docs/00_intro/introduction.rst index c3ae18d..5f97abb 100644 --- a/docs/00_intro/introduction.rst +++ b/docs/00_intro/introduction.rst @@ -10,6 +10,11 @@ and Computing (ASC) **Future Computing Resource (FCR)**. Benchmark Overview ================== +Mini Applications and Microbenchmarks are features, components, performance characteristics, or other properties that are important to the Laboratories. Mini Applications are prioritized as Priority 1, or Priority 2. + +Priority 1 Mini Applications +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + .. list-table:: * - **Benchmark** @@ -17,12 +22,6 @@ Benchmark Overview - **Language** - **Parallelism** - **Libraries** - * - AMG2023 - - AMG solver of sparse matrices - - C - - | MPI+CUDA/HIP/SYCL - | OpenMP on CPU - - Hypre * - Kripke - | Scalable 3D Sn deterministic | particle transport code @@ -35,7 +34,7 @@ Benchmark Overview | element compressible gas dynamics - C++ - MPI+RAJA/CUDA/HIP - - MFEM, Hypre + - RAJA, MFEM, Hypre * - RAJA Performance Suite - | Collection of loop-based computational | kernels found in HPC applications @@ -61,6 +60,24 @@ Benchmark Overview - C++ - MPI+Kokkos - Kokkos + + +Priority 2 Mini Applications +^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +.. list-table:: + + * - **Benchmark** + - **Description** + - **Language** + - **Parallelism** + - **Libraries** + * - AMG2023 + - AMG solver of sparse matrices + - C + - | MPI+CUDA/HIP/SYCL + | OpenMP on CPU + - Hypre * - LAMMPS ACE - | Molecular dynamics using | Atomic Cluster Expansion (ACE) @@ -72,18 +89,20 @@ Benchmark Overview | high-order finite element advection - C++ - MPI+RAJA/CUDA/HIP - - MFEM, Hypre + - RAJA, MFEM, Hypre * - MiniEM - Electro-Magnetics solver - C++ - MPI+Kokkos - - Kokkos + - Kokkos, Trillinos * - MLPerf - Llama 3.1 405B training - Python - NCCL+CUDA - NVIDIA NeMo +Please note that half of the RAJA kernels are Priority 1, and the other half are Priority 2. Similarly, 2 of the Laghos problems are Priority 1, and the third is Priority 2. + .. _GlobalRunRules: diff --git a/docs/12_laghos/laghos.rst b/docs/12_laghos/laghos.rst index a7135e3..532ddf7 100644 --- a/docs/12_laghos/laghos.rst +++ b/docs/12_laghos/laghos.rst @@ -17,10 +17,24 @@ Characteristics Problems -------- -The test problems to be run are the Sedov shock (problem 1) in 3D. -These are to be run with a conforming mesh. +The test problems are the Sedov shock (problem 1 in Laghos) in 3D. +The test problems should be run with a conforming mesh. +Linear, quadratic, and cubic orders are of interest with the following priorities: -The problem sizes and partitioning scheme for both problems can be set by the user from the command line. +Priority 1 problems +^^^^^^^^^^^^^^^^^^^ + #. **3D Linear** This problem uses a kinematic order of 1, and a thermodynamic order of 0 (Q1Q0). + #. **3D Quadratic** This problem uses a kinematic order of 2, and a thermodynamic order of 1 (Q2Q1). + +Priority 2 problems +^^^^^^^^^^^^^^^^^^^ + 3. **3D Cubic** This problem uses a kinematic order of 3, and a thermodynamics order of 2 (Q3Q2). + + +The problem sizes and partitioning scheme for both problems can be set by the user from the command line. +The kinematic order is set using the `-ok` command-line option while the thermodynamic order is set using `-ot`. +In all cases the default quadrature integration order should be used. +See :ref:`RunningLaghos` for how to run each of the different problems. Figure of Merit --------------- @@ -240,6 +254,7 @@ Validation Code correctness is validated by using the following tests and comparing the outputted **Energy diff**, and **Density L2 error**. These quantities must be less than or equal to the following values on CPU and GPU: .. code-block:: console + laghos -dim 3 -p 1 -ok 1 -ot 0 -oq -1 -pa -no-nc -tf 0.6 -err -rs 0 -rp 0 -nx 64 -ny 64 -nz 64 Energy diff: 7.61e-05 Density L2 error: 1.95e-01 diff --git a/docs/index.rst b/docs/index.rst index 245ca32..11438f4 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -22,15 +22,21 @@ FCR Benchmarks Project. ATTENTION: This page is a work in progress and nothing i .. toctree:: :maxdepth: 3 :numbered: - :caption: Mini-Applications + :caption: Priority 1 Mini-Applications - 10_amg/amg 11_kripke/kripke 12_laghos/laghos 13_rajaperf/rajaperf 14_scaffold/scaffold 20_branson/branson 31_sparta/sparta + +.. toctree:: + :maxdepth: 3 + :numbered: + :caption: Priority 2 Mini-Applications + + 10_amg/amg 32_lammpsACE/lammpsACE 40_remhos/remhos 50_miniem/miniem