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 

Usage

The compiled binary is now available in the build directory as build/vibrant and can be invoked e.g. from the root directory by the command

build/vibrant input.txt

with input.txt as a input file with the vibrant settings.