libCEED/examples/README.md

12 <!-- bps-inclusion -->
14 The Center for Efficient Exascale Discretizations (CEED) uses Bakeoff Problems (BPs) to test and compare the performance of high-order finite element implementations.
20 :::{list-table}
21 :header-rows: 1
23 * - User code
24   - Supported BPs
25 * - `deal.II`
26   - * BP1 (scalar mass operator) with $Q=P+1$
32 * - `mfem`
33   - * BP1 (scalar mass operator) with $Q=P+1$
35 * - `petsc`
36   - * BP1 (scalar mass operator) with $Q=P+1$
42 * - `nek5000`
43   - * BP1 (scalar mass operator) with $Q=P+1$
47 These are all **T-vector**-to-**T-vector** and include parallel scatter, element scatter, element evaluation kernel, element gather, and parallel gather (with the parallel gathers/scatters done externally to libCEED).
52 The BPs are parametrized by the number $P$ of Gauss-Legendre-Lobatto nodal points (with $P=p+1$, and $p$ the degree of the basis polynomial) for the Lagrange polynomials, as well as the number of quadrature points, $Q$.
53 A $Q$-point Gauss-Legendre quadrature is used for all BPs except BP5 and BP6, which choose $Q = P$ and Gauss-Legendre-Lobatto quadrature to collocate with the interpolation nodes.
56 <!-- bps-exclusion -->
60 ## PETSc+libCEED Fluid Dynamics Navier-Stokes Mini-App
62 The Navier-Stokes problem solves the compressible Navier-Stokes equations using an explicit or implicit time integration.
65 ## PETSc+libCEED Solid Mechanics Elasticity Mini-App
67 This example solves the steady-state static momentum balance equations using unstructured high-order finite/spectral element spatial discretizations.
72 These examples, located in the [petsc/](./petsc) folder, use the mass operator to compute the surface area of a cube or a discrete cubed-sphere, using PETSc.
75 ## PETSc+libCEED Bakeoff Problems on the Cubed-Sphere
77 These examples, located in the [petsc/](./petsc) folder, reproduce the Bakeoff Problems 1-6 on a discrete cubed-sphere, using PETSc.
78 For a detailed description, please see the corresponding [problems on the cubed-sphere documentation page](https://libceed.org/en/latest/examples/petsc/index.html#bakeoff-problems-on-the-cubed-sphere).
91 To build the examples, set the `DEAL_II_DIR`, `MFEM_DIR`, `PETSC_DIR`, and `NEK5K_DIR` variables and, from the `examples/` directory, run
94 :start-after: <!-- running-examples-inclusion -->
95 :end-before: <!-- running-examples-exclusion -->