Edge Code Reactions Library

VANTAGE-Reactions is a scalable, flexible, and extensible library for adding reactions/particle transformations to particle codes built on top of the NESO-Particles library.

Features provided by the library are:

• An extensible reaction abstraction, designed to be modular, separating the data and the actions on the parents/products
• A uniform and extensible interface for producing particle subgroups by composing marking strategies
• A uniform and extensible interface for defining, composing, and applying transformations to particle groups, including marking
• An interface for the simultaneous application of multiple reactions to the relevant particles and the handling of reaction products
• Various helper interfaces for defining particle species as well as generating uniform particle specs
• A collection of pre-built reactions/reaction data/reaction kernels

This library deals only with the definition and application of particle transformations useful when dealing with reacting particles in particle codes. It is NOT a particle code itself. It does not deal with moving the particles around, and is mesh agnostic. It does not define a standard set of reactions/species but provides the tools to do so.

Documentation

Documentation can be found here: https://ukaea-edge-code.github.io/VANTAGE-Reactions/

Quick-start with docker

Ensure docker v28.1.1+ is installed on either linux or WSL2 with non-root management enabled. See here for more details: https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user.

Clone the repo:

git clone --recurse-submodules git@github.com:UKAEA-Edge-Code/Reactions.git $HOME/VANTAGE_Reactions

Feel free to replace $HOME/VANTAGE_Reactions with a directory name of your choice. Next from within the repo directory, execute:

docker build -t vantage_reactions_img -f .devcontainer/Dockerfile .

then execute:

docker run --name vantage_reactions -v "$(pwd):/root/Reactions" vantage_reactions_img:latest -c "cd /root/Reactions && source run_tests.sh"

If there's a failure in the installation of neso-particles and/or reactions modify run_tests.sh and replace spack install with:

spack install -j1

and try the docker run command again.

Documentation

To build the documentation ensure the following pre-requisites are installed (via pip):

• sphinx (https://pypi.org/project/Sphinx/)
• pydata-sphinx-theme (https://pypi.org/project/pydata-sphinx-theme/)
• breathe (https://pypi.org/project/breathe/)

This can be done manually or by running:

python -m venv ./docs_venv
source ./docs_venv/bin/activate
pip install -U -r $HOME/VANTAGE_Reactions/docs/sphinx/requirements.txt

(replace $HOME/VANTAGE_Reactions with the name of the directory that the repo was cloned into.)

Then simply run make inside the docs folder in the repo (make sure you're inside the python virtual environment docs_venv). The documentation should be contained within:

$HOME/VANTAGE_Reactions/docs/build/sphinx/html/

Start by opening index.html in a web browser of your choice. To exit the python virtual environment just run deactivate in the terminal.