Skip to content

[package list]

MicroHH

License information

MicroHH is released under the GNU General Public License (v3).

From version 2.0.2 onwards, you can find a copy of the license in the COPYING file in $EBROOTMICROHH/share/licenses/MicroHH after installing and loading the module.

Users are asked to cite the following publication: 

van Heerwaarden, C. C., van Stratum, B. J. H., Heus, T., Gibbs, J. A., Fedorovich, E., and Mellado, J. P.: MicroHH 1.0: a computational fluid dynamics code for direct numerical simulation and large-eddy simulation of atmospheric boundary layer flows, Geosci. Model Dev., 10, 3145–3165, https://doi.org/10.5194/gmd-10-3145-2017, 2017.

User-installable modules (and EasyConfigs)

Install with the EasyBuild-user module: 

eb <easyconfig> -r
To access module help after installation and get reminded for which stacks and partitions the module is installed, use module spider MicroHH/<version>.

EasyConfig:

  • EasyConfig MicroHH-2.0.1-cpeGNU-24.03.eb, will build MicroHH/2.0.1-cpeGNU-24.03

    CPU version, compile for partition/C and run on LUMI-C.

  • EasyConfig MicroHH-2.0.1-cpeGNU-25.03.eb, will build MicroHH/2.0.1-cpeGNU-25.03

    CPU version, compile for partition/C and run on LUMI-C. The test step does want to start job steps, so either compile anywhere but disable the test step using eb MicroHH-2.0.1-cpeGNU-25.03.eb --skip-test-step or allocate a node with srun -N1 -t15:00 -A project_46YXXXXXX -pstandard --pty bash and compile in that environment. It is essential that you do not use a -n or -c flag with that srun command. The test phase should be quick. If it hangs for more than two minutes or so during the testing... step then you made a mistake somewhere and srun got stuck.

  • ccpe container only EasyConfig MicroHH-2.0.2-cpeGNU-26.03.eb, will build MicroHH/2.0.2-cpeGNU-26.03

    CPU version, compile for partition/C and run on LUMI-C. The test step does want to start job steps, so either compile anywhere but disable the test step using eb MicroHH-2.0.1-cpeGNU-25.03.eb --skip-test-step or allocate a node with srun -N1 -t15:00 -A project_46YXXXXXX -pstandard --pty bash and compile in that environment. It is essential that you do not use a -n or -c flag with that srun command. The test phase should be quick. If it hangs for more than two minutes or so during the testing... step then you made a mistake somewhere and srun got stuck.

Technical documentation

MicroHH is a computational fluid dynamics code designed to simulate turbulent flows in the atmosphere using Direct Numerical Simulation (DNS) and Large-Eddy Simulation (LES) techniques. Its capabilities span a range from highly idealized flows to realistic atmospheric boundary layers, incorporating all relevant processes, such as moist thermodynamics, radiation, land surface processes, and microphysics. The code is written in C++/CUDA and runs on both CPUs and GPUs (but only NVIDIA at the time of writing).

EasyBuild

Version 2.0.1 for cpeGNU

  • The EasyConfig was contributed by the EPICURE project.

  • When having trouble after a system update, it may be a good idea to move Boost to the regular depencencies as now many system libraries are used that may or may not be present after a system update.

  • MicroHH-2.0.1-cpeGNU-24.03.eb: version for the Cray Programming Environment with GNU compiler version 24.03.

  • MicroHH-2.0.1-cpeGNU-25.03.eb: version for the Cray Programming Environment with GNU compiler version 25.03.

    This version also adds some testing in the "testing" step.

Version 2.0.2 for cpeGNU/26.03

  • A trivial update of the 2.0.1 EasyConfig for 25.03.

  • We had issues with the download if it was stored as a .tar.xz file which got stuck, so for now we only store as a .tar file without checksums as they appeared to not be reproducible.

  • Switched to EB6-compatible parameters in the EasyConfig.

  • Added license information to the installation.