Installation

The CMake build framework is used in order to compile the vibrant code. To install it type the following in the root directory of the repository and make sure that you have a working GNU fortran compiler (e.g. gfortran):

mkdir build && cd build 
cmake ..
make -j 5

Optional: Test if the installation is working as expected by typing

ctest 

in the build directory to run the regression tests.

Install options

Options can be passed to cmake via an initial_cache.cmake file:

cmake -C ../initial_cache.cmake ..

e.g to specify a dependency path (for more options see initial_cache.example.cmake):

set(BLAS_LIBRARY_DIR "/path/to/BLAS" CACHE PATH "Path to BLAS library directory")

Within this file the dependency paths, the compiler, the compiler flags etc. can be specified. For more options see initial_cache.example.cmake.

Dependencies

Dependency

Version

Comment

LAPACK (e.g. OpenBLAS)

(>0.3)

Required, if no path provided then cmake tries to find the library

FFTW

>3.3

Required, if no path provided then installed together with vibrant

GreenX

v2.0

Required, if no path provided then installed together with vibrant

Python

>3.10

Required, only if ENABLE_REGRESSION_TESTS is ON

Regression test

The regression tests can be run by running the following in the build directory after vibrant was build:

ctest