Skip to content

CFT-HY/HILA

Folders and files

NameName
Last commit message
Last commit date
Feb 24, 2025
Apr 7, 2025
Jun 7, 2023
Mar 10, 2025
Apr 9, 2025
Mar 4, 2021
Apr 13, 2025
Apr 10, 2025
Apr 10, 2023
Sep 1, 2023
Nov 11, 2022
Oct 25, 2024
Sep 6, 2022
Jun 2, 2023
Aug 17, 2024

Repository files navigation

HILA

axions

HILA (lattice in Finnish) is a C++ lattice field theory programming framework, aimed at HPC simulations.

Purpose: make writing applications straightforward and intuitive, while producing optimized executables for different (super)computing platforms (parallelization with MPI, GPU computing with Cuda or HIP, AVX vectorization, etc.). Details of the parallelization and computing architecture are hidden from the user's view, and all applications automatically run on present or future platform. Write once -- run anywhere.

Hila is based on HILA preprocessor "hilapp", which is a C++ source-to-source transformer using the libtooling toolbox of the Clang compiler. It converts application C++ to platform-specific C++ code, which is passed to appropriate compilers for the platforms.

Simplistic functionality which HILA promises is for example:

Field<Complex<double>> f;
Field<double> g = 0;

onsites(ALL) f[X].gaussian_random();

foralldir(d){
  g[ALL] += abs(f[X + d] - 2 * f[X] + f[X - d]);
}

Above we have created a random gaussian field and then interated over it with some operation that holds neighboring communication. We then store the result in a field initialized to zero.

Hilapp handles the expansion of the above code into valid c++ code. Behind the scenes HILA takes care of MPI layout and communications. It lays out the lattice fields differently for different computing platforms: 'array of structures' (standard), 'array of structures of vectors' (AVX-type), or 'structure of arrays' (GPU-type).

Installation and documentation

Installation and user guide can be viewed on the web documentation

License

The GPL-2.0 license information can be reviewed at the license page