Priorities

docs/00_intro/introduction.rst

@@ -10,19 +10,18 @@ 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**
    - **Description**
    - **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:
 

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

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