Installation

Prerequisites

Requirement	Minimum version
GNU gfortran	14.2.0
NVIDIA nvfortran	25.3
MPI implementation	any standard
HDF5 (Fortran + parallel)	1.14.6

Pre-built HDF5 1.14.6 libraries are included in the repository under lib/hdf5/1.14.6/, so no separate HDF5 build is required for the default GNU and NVIDIA toolchains.

Download

Clone the repository, then fetch the third-party dependencies via FoBiS.py:

git clone https://github.com/szaghi/MOTIOn
cd MOTIOn
FoBiS.py fetch

FoBiS.py fetch reads src/third_party/.deps_config.ini and downloads the required libraries into src/third_party/.

Alternatively, use the provided convenience script (supports both git and wget workflows):

./scripts/install.sh --download git --build fobis

Run ./scripts/install.sh --help for all options.

Third-party dependencies

The dependencies are placed under src/third_party/:

Library	Purpose
PENF	Portable numeric kind parameters (R8P, I4P, …)
StringiFor	String utilities
FoXy	Fortran XML generation (used by the XDMF layer)
BeFoR64	Base64 encoding
FACE	ANSI terminal colors

Build with FoBiS.py

FoBiS.py is the build system. Install it with pip if not already present:

pip install FoBiS.py

List all build modes

FoBiS.py build -lmodes

Build the library

# Shared library — GNU gfortran (release)
FoBiS.py build -mode shared-gnu

# Static library — GNU gfortran (release)
FoBiS.py build -mode static-gnu

# Shared library — GNU gfortran (debug)
FoBiS.py build -mode shared-gnu-debug

# Static library — GNU gfortran (debug)
FoBiS.py build -mode static-gnu-debug

Outputs are placed in ./shared/ or ./static/ respectively.

Build and run the test suite

# Build tests (GNU, release)
FoBiS.py build -mode tests-gnu

# Build tests (GNU, debug — strict flags, NaN-initialised reals)
FoBiS.py build -mode tests-gnu-debug

# Build tests (NVIDIA Fortran, release)
FoBiS.py build -mode tests-nvf

# Run all tests (serial)
./scripts/run_tests.sh

# Run all tests via MPI with N ranks
./scripts/run_tests.sh --np 2

Compiled test executables are placed in ./exe/.

NVIDIA Fortran

Switch to the nvf modes, which use the pre-built HDF5 under lib/hdf5/1.14.6/nvf/25.3/:

FoBiS.py build -mode tests-nvf
FoBiS.py build -mode tests-nvf-debug

Documentation

FoBiS.py rule -ex makedoc   # build FORD HTML docs → doc/html/
FoBiS.py rule -ex deldoc    # delete generated docs

Coverage analysis

FoBiS.py rule -ex makecoverage          # build + run + gcov
FoBiS.py rule -ex makecoverage-analysis # also save markdown reports

Building HDF5 from source

If you need a custom HDF5 build (different compiler version, different options), use the provided helper:

./scripts/hdf5_build.sh -get -build -sdk GNU
# Options: -sdk GNU | NVF
#          -hdf5 <path>   override HDF5 source path
#          -lsrc <path>   override library source path