ADIOS2Wrappers for DOLFINx

Read Latest Documentation

This is an experimental library for checkpoint with DOLFINx using ADIOS2.

Docker

ADIOS2 is installed in the official DOLFINx containers.

docker run -ti -v $(pwd):/root/shared -w /root/shared --name=dolfinx-checkpoint ghcr.io/fenics/dolfinx/dolfinx:nightly

Conda

To use with conda (DOLFINx release v0.7.0 works with v0.7.1 of ADIOS4DOLFINx)

conda create -n dolfinx-checkpoint python=3.10
conda activate dolfinx-checkpoint
conda install -c conda-forge fenics-dolfinx pip adios2 numba
python3 -m pip install git+https://github.com/jorgensd/adios4dolfinx@v0.7.1

Long term plan

The long term plan is to get this library merged into DOLFINx (rewritten in C++ with appropriate Python-bindings).

Functionality

DOLFINx

• Reading and writing meshes, using adios4dolfinx.read/write_mesh
• Reading checkpoints for any element (serial and parallel, one checkpoint per file). Use adios4dolfinx.read/write_function.

Legacy DOLFIN

Only checkpoints for Lagrange or DG functions are supported from legacy DOLFIN

• Reading meshes from the DOLFIN HDF5File-format
• Reading checkpoints from the DOLFIN HDF5File-format (one checkpoint per file only)
• Reading checkpoints from the DOLFIN XDMFFile-format (one checkpoint per file only, and only uses the .h5 file)

See the API for more information.