How to build the libraries, tests, and examples, run the tests, and verify the results

In a nutshell

RTE+RRTMGP uses CMake. In the root directory: cmake -S . -B build will guide you through configuration options.

Or use:

cmake -S . -B build -G "Ninja" \
  -DCMAKE_BUILD_TYPE=RelWithDebInfo|None \
  -DRTE_ENABLE_SP=ON|OFF \
  -DKERNEL_MODE=default|accel\
  -DBUILD_TESTING=ON|OFF

Evaluating the results of the tests requires Python and the packages described in environment*.yml.

Building and testing using (Gnu) autotools

Sergey Kosukhin and his colleagues at the Max Planck Institute for Meteorology maintain the autoconf branch which adds Gnu autotools building to main branch.

Supplying data

Running the tests and verifying the results requires the RRTMGP data. Clone the data repository or download the Zenodo archive. Set the environment variable RRTMGP_DATA to the root of this directory.

Example compiler flags

In these examples FC is the Fortran compilers using flags FCFLAGS

Gnu Fortran

(see also the continuous integration) FC: gfortran-10 or gfortran-11 or gfortran-12

Debugging flags

FCFLAGS: "-ffree-line-length-none -m64 -std=f2008 -march=native -fbounds-check -finit-real=nan -DRTE_USE_CBOOL"

Even stricter debugging flags

FCFLAGS: "-ffree-line-length-none -m64 -std=f2008 -march=native -fbounds-check -fbacktrace -finit-real=nan -DRTE_USE_CBOOL -pedantic -g -Wall"

Intel Fortran Classic

(see also the continuous integration) FC: ifort

Debugging flags

FCFLAGS: "-m64 -g -traceback -heap-arrays -assume realloc_lhs -extend-source 132 -check bounds,uninit,pointers,stack -stand f08"

Optimization flags:

FCFLAGS:"-m64 -O3 -g -traceback -heap-arrays -assume realloc_lhs -extend-source 132"

Intel Fortran

(LLVM, see also the continuous integration) FC: ifort

Debugging flags

FCFLAGS: "-debug -traceback -heap-arrays -assume realloc_lhs -extend-source 132 -stand f08"

Using OpenMP GPU offload

See this open issue

NVFortran

(see also the see also the continuous integration) FC: nvfortran

Debugging flags

FCFLAGS: "-g -Minfo -Mbounds -Mchkptr -Mstandard -Kieee -Mchkstk -Mallocatable=03 -Mpreprocess"

Optimization flags:

FCFLAGS: "-O3 -fast -Minfo -Mallocatable=03 -Mpreprocess"

HPE CCE for GPU using OpenMP-acc: crayftn – requires at least CCE 14.0.0

FC: crayftn

Debugging flags (these appear to be insufficient during the link stage)

FCFLAGS: "-hnoacc -homp -O0"