luszczek / xsdk-examples

Example codes demonstrating the use of various XSDK packages in combination.

xSDK Examples

The example codes provided here demonstrate the use of of various xSDK libraries in tandem to solve problems of interest. Each of the library folders has one or more examples codes that are built of that library and utilize code integrations with other xSDK libraries. Running these example codes and examining the output is a good way to better understand how these libraries can work together. The code samples are a good place to start for new projects. More details about the examples can be found in the README.md files in the library subfolders. For more information on the xSDK see https://xsdk.info/.

Code Example Summary

Example	Libraries	Description
hypre/ij_laplacian.c	HYPRE+SuperLU_Dist	2D Laplacian problem
libensemble/test_persistent_aposmm_tao.py	libEnsemble+PETSc	2D constrained optimization problem
mfem/hypre-superlu/convdiff.cpp	MFEM+HYPRE+SuperLU_Dist	2D steady state convective diffusion
mfem/ginkgo/mfem_ex1_gko.cpp	MFEM+Ginkgo	2D Poisson problem with Ginko solver
mfem/petsc/obstacle.cpp	MFEM+PETSc	Membrane obstacle problem (min energy functional)
mfem/sundials/transient-heat.cpp	MFEM+SUNDIALS	2D Transient nonlinear heat conduction
petsc/ex19.c	PETSc+HYPRE+SuperLU_Dist	2D nonlinear driven cavity problem
sundials/ark_brusselator1D_FEM_sludist.cpp	SUNDIALS+SuperLU_Dist	Chemical kinetics brusselator problem
sundials/cv_petsc_ex7.c	SUNDIALS+PETSc	2D nonlinear PDE solution
trilinos/SimpleSolve_WithParameters.cpp	Trilinos+SuperLU_Dist	Small linear system direct solution

These examples are currently in the repo but will not be enabled in the xsdk-examples spack package until we release a new version of the xSDK. They can still be built using CMake directly.

Example	Libraries	Description
mfem/sundials/advection.cpp	MFEM+SUNDIALS (CUDA)	2D Time-dependent advection
sundials/cvRoberts_blockdiag_magma.cpp	SUNDIALS+MAGMA (CUDA)	Solves a group of chemical kinetics ODEs

Install the code samples

The examples can be installed along with the xSDK utilizing the spack package.

spack install xsdk-examples

Further details on how to run each example code can be found in each example folder's README.md file.