.. _dynRes software stack:
#########################
The DynRes Software Stack
#########################

The DynRes Software Stack supports dynamic resource management based on the :ref:`Dynamic Processes With PSets (DPP)` design principles.

***************
Software Layers
***************
The following figure gives an overview of the different software layers of the DynRes Software Stack.

.. image:: images/stack_layers.png

******************
Supported Software
******************
This section lists all software projects currently intgrated in the DynRes Software Stack.

Package Manager
===============

- `DynPkgs <https://dynres-dynpkgs.readthedocs.io/en/latest/>`__: A package manager to install software of the DynRes Software Stack

Applications/Examples
=====================

- `Benchmarks <https://gitlab.inria.fr/dynres/applications/benchmarks>`__: An environment for creating, running and analyzing Dynamic Resource Management experiments and benchmarks.
- `Charm++ Examples <https://gitlab.inria.fr/dynres/applications/charmpp_examples>`__: Example Application to demonstrate (Dyn)Charm++ integration.
- `DMR Examples <https://gitlab.inria.fr/dynres/applications/drm_examples>`__: Iterative kernels Jacobi, Laplace and Conjugate Gradient demonstrating the DMR integration with DPP
- `DynPetsc Examples <https://gitlab.inria.fr/dynres/applications/dynpetsc_examples>`__: Linear, Non-linear and timestepper examples demonstrating DynPetSc integration
- `DynRM Examples <https://gitlab.inria.fr/dynres/applications/dynrm_examples>`__: Synthetic Application to demonstrate DynRM and DynPSets functionalities
- `DynTaskGraphs Examples <https://gitlab.inria.fr/dynres/applications/dyntaskgraphs_examples>`__: Examples of using the DynTaskGraphs Library
- `DynXBraid Examples <https://gitlab.inria.fr/dynres/applications/dyn_xbraid_examples>`__: 1D heat equation examples demonstrating dynamic resources in XBraid 
- `LibPFASST Examples <https://gitlab.inria.fr/dynres/applications/libpfasst_app>`__: Example application demonstrating dynamic resources in LibPFASST 
- `MPI Tests <https://gitlab.inria.fr/dynres/applications/miniapps>`__: Simple test applications to test the DPP MPI Sessions extensions
- `ML Examples <https://gitlab.inria.fr/dynres/applications/ml_examples>`__: Example Application demonstrating dynamic resources for Machine Learning Workloads
- `MPDATA3D <https://gitlab.inria.fr/dynres/applications/mpdata3d>`__: 3D semi-Lagrangian multiscale fluid solver using DynPSets for dynamic resources
- `DynP4est Examples <https://gitlab.inria.fr/dynres/applications/p4est_dyn_examples>`__: Example Application demonstrating dynamic resources with Adaptive Mesh Refinement using DynP4est
- `PSet Monitoring Examples <https://gitlab.inria.fr/dynres/applications/pset_monitoring_examples>`__: Examples Application demonstrating PSet-based monitoring capabilities in PRRTE and OpenPMIx

Libraries
=========
- `DMR <https://gitlab.bsc.es/siserte/dmr/-/tree/sessions?ref_type=heads>`__: A library designed to offer the global advantages of process malleability while providing a minimalist MPI-like syntax.
- `DynPetsc <https://gitlab.inria.fr/dynres/applications/dynpetsc>`__: Adaptive version of PetSc - A parallel numerical software library 
- `DynPSets <https://dynres.readthedocs.io/projects/DynPSets/en/latest/>`__: A library to support dynamic MPI reconfiguration - inspired by DMR.
- `DTG <https://dynres.readthedocs.io/projects/DTG/en/latest/>`__: A library for implementing and running resource-dynamic MPI-based task graphs.
- `DynXBraid <https://gitlab.inria.fr/dynres/applications/dyn_xbraid>`__: Adaptive version of XBraid - a multigrid-based parallel-in-time library
- `DynLibPFASST <https://gitlab.inria.fr/dynres/applications/libpfasst>`__: Adaptive version of LibPFASST - a parallel-in-time library based on  the Parallel Full Approximation Scheme in Space and Time (PFASST) algorithm
- `DynP4est <https://gitlab.inria.fr/dynres/applications/p4est_dyn>`__: Adaptive version of P4est - an Adaptive Mesh Refinement Framework

Programming Models and Runtime Systems
======================================
- `DynCharm++ <https://gitlab.inria.fr/dynres/applications/charm>`__: Adptive version of Charm++ - a C++-based parallel programming system, founded on the migratable-objects programming model, and supported by a novel and powerful adaptive runtime system. 
- `Dynamic Open-MPI <https://gitlab.inria.fr/dynres/dyn-procs/ompi>`__: Adaptive version of Open-MPI - an implementation of the MPI standard. Supportes Dynamic Resource Extensions of the MPI Sessions interface 
- `Dynamic OpenPMIx <https://gitlab.inria.fr/dynres/dyn-procs/openpmix>`__: Adaptive version of OpenPMIx - an implementation of the PMIx Standard
- `Dynamic PRRTE <https://gitlab.inria.fr/dynres/dyn-procs/prrte>`__: Adaptive version of PRRTE - the PMIx Reference Runtime environment
- `Dynamic MPI4py <https://gitlab.inria.fr/dynres/dyn-procs/mpi4py>`__: Extends the Python MPI Bindings to the dynamic resources extesnions of the MPI Sessions Model

Resource Manager
================
- `DynRM <https://dynres.readthedocs.io/projects/DynRM/en/latest/>`__: A modular, Python-based resource manager supporting Dynamic Resource Management based on DPP