Installation#

Building#

Comprehensive instructions on the software stack requirements and how to configure and compile the code are available within the source code under doc/Quick_Start.md.

In general ICON has an autotools based building system and the release ships a lot of its dependencies, which are all build automatically by ICON. If in doubt, check

./configure --help

and have a look at the example build wrappers for supported HPC systems.

Testing#

The ICON model is tested for a set of configurations by an internal CI infrastucture on supported systems. The test scripts are available in the run/ directory, after running the ./makescripts command as described in the running section of the Quick Start Guide. Users of one of the supported system configurations can run one of the test script generated by the ./makescripts --all to check that the installation is working properly.
For users outside of supported systems, only idealized CI type test cases which do not require input data can be run as simple tests to check the installation. The recommended idealized test is the atm_tracer_Hadley. In addition a set of recommended configurations with corresponding input data is provided for longer tests and simulations as described in the recommended configuration section.
It is the responsability of the user to verify these tests on a given machine.

Supported Hardware#

ICON is tested during development on different hardware platforms

  • CPU: AMD Epic, Intel Xeon and several others

  • GPU: Nvidia A100, AMD MI250x

  • Vector: NEC Aurora

For special tasks ICON has been successfully run on

  • Fujitsu A64FX arm

ICON also works with virtual machines. Please have a look at the official documentaton about it.

On this page