Getting Started: Difference between revisions
(added link to full Installation page from kit wiki) |
(Adapted the Art Install instructions to the current ICON Versions, where ART is installed by default. Linked DWD Tutorial on how to install ICON.) |
||
| Line 3: | Line 3: | ||
== Overview == |
== Overview == |
||
ICON-ART is a state-of-the-science seamless model system for the whole atmosphere (physics and composition) that comprises the key components of the next generation Earth system model in Germany. ICON is a global weather and climate model solves the full three-dimensional non-hydrostatic and compressible Navier-Stokes equations on an icosahedral grid and allows seamless predictions from local to global scales. Aerosol and Reactive Trace gases (ART), as a submodule of ICON, supplements the model by including emissions, transport, gas phase chemistry |
ICON-ART is a state-of-the-science seamless model system for the whole atmosphere (physics and composition) that comprises the key components of the next generation Earth system model in Germany. ICON is a global weather and climate model that solves the full three-dimensional non-hydrostatic and compressible Navier-Stokes equations on an icosahedral grid and allows seamless predictions from local to global scales. Aerosol and Reactive Trace gases (ART), as a submodule of ICON, supplements the model by including emissions, transport, gas phase chemistry and aerosol dynamics in the troposphere and stratosphere (as seen in figure [[#ART-capabilities|1.1]]). |
||
[[File:ART-capabilities.png|thumb|none|alt=Capabilities of ICON-ART and how they relate to each other.|Capabilities of ICON-ART and how they relate to each other.]] |
[[File:ART-capabilities.png|thumb|none|alt=Capabilities of ICON-ART and how they relate to each other.|Capabilities of ICON-ART and how they relate to each other.]] |
||
| Line 17: | Line 17: | ||
https://code.mpimet.mpg.de/projects/iconpublic |
https://code.mpimet.mpg.de/projects/iconpublic |
||
In order to obtain the ART code, the institution that wants to use ICON-ART has to sign an additional license agreement with Karlsruhe Institute of Technology (KIT). Further information can be found on the following website: |
|||
http://icon-art.imk-tro.kit.edu |
|||
After you have signed the license agreement, you will be provided with a compressed file with the recent source code of ART which is called ART-v<X>.<YY>.tar.gz. <X> and <YY> indicate the version numbers. |
|||
== Installation == |
== Installation == |
||
ICON-ART is already included in the most recent ICON version. For Instructions on how to install ICON, please refer to the [https://www.dwd.de/EN/ourservices/nwv_icon_tutorial/pdf_volume/icon_tutorial2020_en.html:official ICON Model Tutorial]. |
|||
In this section, a brief description of how to compile ICON-ART is given. The user has to do the same steps as compiling ICON with a few additions. The reader is referred to in order to compile ICON successfully. First, the ART-v<X>.<YY>.tar.gz file has to uncompressed. You will obtain a directory, which should be copied inside the ICON source directory $ICON-DIR/src/. In the following, we refer to this directory<br /> |
|||
$ICON-DIR/src/ART-v<X>.<YY> as $ARTDIR. |
|||
If you have compiled ICON as recommended first without ART, you have to do clean up first: |
|||
<div class="small"> |
|||
<pre> make distclean</pre> |
|||
</div> |
|||
In order to compile ICON-ART, an additional flag has to be set at the configuration command: |
|||
<div class="small"> |
|||
<pre> ./config/dkrz/mistral.intel --enable-art |
|||
</div> |
|||
By setting –with-art a compiler flag -D__ICON_ART is set. This flag tells the preprocessor to compile the code inside the ART interfaces and hence connect the ICON code with the ART code. As soon as the configuration is finished, you can start to compile the ICON-ART code: |
|||
<div class="small"> |
|||
<pre> make -j8 |
|||
</div> |
|||
| ⚫ | |||
== Running a Job == |
== Running a Job == |
||
| Line 61: | Line 30: | ||
* Make sure you have everything required for an ICON run |
* Make sure you have everything required for an ICON run |
||
| ⚫ | |||
* Configure the code with the additional flag –enable-art as described above |
|||
* Prepare the input data (see section [[https://www.icon-art.kit.edu/userguide/index.php?title=Input]] |
|||
* Inside the runscript in the namelist run_nml, set the main switch for ICON-ART to true: lart = .true. |
* Inside the runscript in the namelist run_nml, set the main switch for ICON-ART to true: lart = .true. |
||
* Add a namelist art_nml and choose the namelist parameters for the ART setup as described in . |
* Add a namelist art_nml and choose the namelist parameters for the ART setup as described in [[https://www.icon-art.kit.edu/userguide/index.php?title=Input]]. |
||
* Adapt the XML files for tracers, emi. The number of tracers related to a specific setup is equal to the number of possible prognostic output fields as described in . |
* Adapt the XML files for tracers, emi. The number of tracers related to a specific setup is equal to the number of possible prognostic output fields as described in [[https://www.icon-art.kit.edu/userguide/index.php?title=Input]]. |
||
* Add an output namelist as described in for the species you are interested in. |
* Add an output namelist as described in for the species you are interested in [[https://www.icon-art.kit.edu/userguide/index.php?title=Input]]. |
||
* Submit the job analogous to an ICON job. |
* Submit the job analogous to an ICON job. |
||
Revision as of 11:49, 20 October 2022
Getting Started
Overview
ICON-ART is a state-of-the-science seamless model system for the whole atmosphere (physics and composition) that comprises the key components of the next generation Earth system model in Germany. ICON is a global weather and climate model that solves the full three-dimensional non-hydrostatic and compressible Navier-Stokes equations on an icosahedral grid and allows seamless predictions from local to global scales. Aerosol and Reactive Trace gases (ART), as a submodule of ICON, supplements the model by including emissions, transport, gas phase chemistry and aerosol dynamics in the troposphere and stratosphere (as seen in figure 1.1).
Being a seamless model makes it possible to use ART to simulate processes overarching multiple scales, like the emission of greenhouse gases, aerosol-cloud interactions and atmospheric chemistry as indicated in figure 1.2. It also enables its use as a prediction tool for the production of renewable energy.
Getting the source code
A user who wants to work with ICON-ART has to sign the ICON license agreement with the German Weatherservice (DWD) and Max-Planck-Institute for Meteorology (MPI-M) first. Further information can be found on the following website:
https://code.mpimet.mpg.de/projects/iconpublic
Installation
ICON-ART is already included in the most recent ICON version. For Instructions on how to install ICON, please refer to the ICON Model Tutorial.
Running a Job
For a user who succeeded in running the ICON model, there are only a few steps to run the ART extension along with the ICON model. A description how to run the ICON model can be found in .
In order to run ICON-ART, one has to do the following steps:
- Make sure you have everything required for an ICON run
- Prepare the input data (see section [[1]] )
- Inside the runscript in the namelist run_nml, set the main switch for ICON-ART to true: lart = .true.
- Add a namelist art_nml and choose the namelist parameters for the ART setup as described in [[2]].
- Adapt the XML files for tracers, emi. The number of tracers related to a specific setup is equal to the number of possible prognostic output fields as described in [[3]].
- Add an output namelist as described in for the species you are interested in [[4]].
- Submit the job analogous to an ICON job.