Installation

ADAM is provided as source files and must be compiled to produce executables.

ADAM has two types of dependencies: source libraries fetched by FoBiS (into src/third_party) and external libraries that must be installed on the system.

Supported Compilers

Compiler	Status
NVIDIA HPC SDK (nvfortran) ≥ 25.3	Supported — see Install NVIDIA HPC SDK
GNU gfortran ≥ 9	CPU builds only
Intel oneAPI (ifort/ifx)	GMP backend (experimental)
AMD flang	Planned

Obtain ADAM

Clone the repository, then fetch source dependencies with FoBiS:

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

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

Alternatively, use the provided install.sh script which automates both steps:

# clone + fetch deps + build
scripts/install.sh --download git --build fobis --mode <mode>

# download a release tarball instead of cloning
scripts/install.sh --download wget --build fobis --mode <mode> --tag v1.0.0

Run scripts/install.sh --help for the full option list.

Compile ADAM

The preferred build system is FoBiS. Install it with:

pip install FoBiS.py

The repository root structure:

.
├── exe/
├── fobos
├── LICENSE.lgpl3.md
├── LICENSE.mit.md
├── README.md
├── scripts/
└── src/

List all available build modes:

FoBiS.py build -lmodes

See Architecture → Build Commands for a full list of build targets.

Install NVIDIA HPC SDK

Download the latest NVIDIA HPC SDK:

wget https://developer.download.nvidia.com/hpc-sdk/25.3/nvhpc_2025_253_Linux_x86_64_cuda_12.8.tar.gz

Decompress and install:

tar xf nvhpc_2025_253_Linux_x86_64_cuda_12.8.tar.gz
cd nvhpc_2025_253_Linux_x86_64_cuda_12.8/
sudo ./install

The default installation path is /opt/nvidia/hpc_sdk/Linux_x86_64/25.3.

After installation, update your PATH. If the module system is available:

module load /opt/nvidia/hpc_sdk/modulefiles/nvhpc/25.3
module load nvhpc/25.3

Alternatively, set environment variables directly:

export PATH=/opt/nvidia/hpc_sdk/Linux_x86_64/25.3/compilers/bin:$PATH
export MANPATH=/opt/nvidia/hpc_sdk/Linux_x86_64/25.3/compilers/man:$MANPATH
export PATH=/opt/nvidia/hpc_sdk/Linux_x86_64/25.3/comm_libs/mpi/bin:$PATH

Install External Dependencies

SZIP Library

git clone https://github.com/erdc/szip
cd szip
export CC=nvc
export CXX=nvc++
export FC=nvfortran
export CFLAGS='-O3'
export CXXFLAGS='-O3'
export FCFLAGS='-O3'
./configure --prefix=/opt/szip/bin/2.1.1/nvf/25.3
make
make check
make install
cd ..

TIP

The installation directory must be created before make install and you must have proper permissions.

ZLIB Library

wget https://zlib.net/current/zlib.tar.gz
tar xf zlib.tar.gz
cd zlib
export CC=nvc
export CFLAGS='-O3 -fPIC'
./configure --prefix=/opt/zlib/bin/1.3.1/nvf/25.3
make
make check
make install
cd ..

HDF5 Library

Once ZLIB and SZIP are installed:

git clone https://github.com/HDFGroup/hdf5
cd hdf5
CFLAGS="-fPIC" FCFLAGS="-fPIC" ./configure \
  --prefix=/opt/HDF5/bin/1.14.6/nvf/25.3 \
  --enable-shared --enable-parallel --enable-fortran \
  --disable-libtool-lock \
  --with-szlib=/opt/szip/bin/2.1.1/nvf/25.3 \
  --with-zlib=/opt/zlib/bin/1.3.1/nvf/25.3 \
  CC=mpicc FC=mpif90
make
make check
make install
cd ..