Skip to content

CFT-HY/HILA

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 the HILA preprocessor "hilapp", which is a C++ source-to-source transpiler 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]);
}

Hilapp handles the expansion of the above code into c++ code. Behind the scenes HILA takes care of the MPI layout and communication. It structures the fields based on the target architecture: '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

Development and Contribution

HILA is a community-driven FOSS project. Before sending out PR, make sure to have a close look on guide line for contributing HILA.

License

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

Packages

 
 
 

Contributors

Languages