Recommended ICON Namelist Settings
Last Update: 2017/01/30 Daniel Rieger
It is necessary for the user to choose the ICON settings carefully. Part of the values listed in <a href="#tab:icon_tracer_nml" data-reference-type="autoref" data-reference="tab:icon_tracer_nml">[tab:icon_tracer_nml]</a> are recommended to obtain a stable ICON-ART simulation with scientifically reasonable results. Another part is necessary to enable ART features like aerosol-cloud-interactions.
<thead> </thead> <tbody> </tbody>
Recommended ICON namelist settings for ART tracers. | dtime | - | run_nml | If facing stability problems, it is recommended to use a shorter time step as recommended by operational setups (e.g. $\frac{3}{5}\cdot$dtimeoper). |
| ndyn_substeps | - | run_nml | There is no need to call the dynamics more often than in operational setup. Adjust it according to your dtime choice. |
| inwp_gscp | | ÔÇó nwp_phy_nml | In order to enable aerosol-cloud-interactions within ICON-ART, you have to specify this. Note, that you will still need to set iart_aci_warm and iart_aci_cold from <a href="#tab:art_nml_iact" data-reference-type="autoref" data-reference="tab:art_nml_iact">[tab:art_nml_iact]</a>. |
| irad_aero | | radiation_nml | aerosol optical properties are taken from climatology |
| | | optical properties depend on aerosol concentrations (set iart_ari = 1 in art_nml ) |
ART Namelists
Last Update: 2020/06/30 Michael Weimer
ICON-ART has an own namelist to modify the setup of ART simulations at runtime. The main switch for ART, lart, is located inside run_nml. The namelist for the other ART switches is called art_nml.
A naming convention is used in order to show the type of data. An INTEGER namelist parameter starts with iart_, a REAL namelist parameter starts with rart_, a LOGICAL namelist parameter starts with lart_, and a CHARACTER namelist parameter starts with cart_.
The ICON-ART namelist is located in the module src/namelists/mo_art_nml.f90. General namelist parameters are listed and explained within <a href="#tab:art_nml_gen" data-reference-type="autoref" data-reference="tab:art_nml_gen">[tab:art_nml_gen]</a>. Namelist parameters for ART input are listed within <a href="#tab:art_nml_io" data-reference-type="autoref" data-reference="tab:art_nml_io">[tab:art_nml_io]</a>. Namelist parameters related to atmospheric chemistry are listed within <a href="#tab:art_nml_chem" data-reference-type="autoref" data-reference="tab:art_nml_chem">[tab:art_nml_chem]</a>. Namelist parameters related to aerosol physics are listed within <a href="#tab:art_nml_aero" data-reference-type="autoref" data-reference="tab:art_nml_aero">[tab:art_nml_aero]</a>. Namelist parameters related to feedback processes between aerosols and meteorological variables are listed in <a href="#tab:art_nml_iact" data-reference-type="autoref" data-reference="tab:art_nml_iact">[tab:art_nml_iact]</a>. Finally, namelist parameters related to physics parameterizations in ICON are listed in <a href="#tab:art_nml_physparam" data-reference-type="autoref" data-reference="tab:art_nml_physparam">[tab:art_nml_physparam]</a>.
<thead> </thead> <tbody> </tbody>
General namelist parameters to control the ART routines. For naming conventions, see <a href="#sec:artnamelist" data-reference-type="autoref" data-reference="sec:artnamelist">[sec:artnamelist]</a>. These switches are - with the exception of lart- located inside art_nml. | lart | .FALSE. | Main switch which enables the ART modules. Located in the namelist run_nml . |
| iart_init_aero | | Initialization of aerosol species. Possible values: : Initialization with 0. : Initialization with Climatology1 (not yet implemented) : Initialization from files (see <a href="#sec:init" data-reference-type="autoref" data-reference="sec:init">[sec:init]</a>) |
| iart_init_gas | | Initialization of gaseous species. Possible values: : Initialization with 0. : Initialization with Climatology1 (not yet implemented) : Initialization in modus, given by the .xml file input declaration init_mode(see <a href="#sec:init" data-reference-type="autoref" data-reference="sec:init">[sec:init]</a>) : Initialization from files (see <a href="#sec:init" data-reference-type="autoref" data-reference="sec:init">[sec:init]</a>) |
| lart_chem | .FALSE. | Enables chemistry. The chemical mechanism and the according species are set via lart_chemtracer and lart_mecca. |
| lart_pntSrc | .FALSE. | Enables addition of point sources for passive tracer. The sources are controled via cart_pntSrc_xml. |
| lart_aerosol | .FALSE. | Main switch for the treatment of atmospheric aerosol. |
| lart_diag_out | .FALSE. | If this switch is set to .TRUE., diagnostic output fields are available. Set it to .FALSE. when facing memory problems. |
<thead> </thead> <tbody> </tbody>
Namelist parameters to control ART input. These switches are located inside art_nml. | cart_input_folder | ÔÇØ | Absolute path where input files, like initialization files are located. |
| cart_emiss_xml_file | ÔÇØ | Path and file name to the XML file for specifying emission metadata. |
| cart_chemtracer_xml | ÔÇØ | Path and file name to the XML file for specifying chemical and passive tracer. |
| cart_mecca_xml | ÔÇØ | Path and file name to the XML file for specifying tracers of the MECCA chemical mechanism. |
| cart_aerosol_xml | ÔÇØ | Path and file name to the XML file for specifying aerosol tracer. |
| cart_modes_xml | ÔÇØ | Path and file name to the XML file for specifying aerosol modes. |
| cart_pntSrc_xml | ÔÇØ | Path and file name to the XML file for specifying point source emissions. |
| cart_diagnostics_xml | ÔÇØ | Path and file name to the XML file for specifying (mainly GRIB2) metadata for diagnostic output variables. Not needed for NetCDF output at the moment. |
| cart_ext_data_xml | ÔÇØ | Path and file name to the XML file for specifying metadata of external datasets for prescribing tracers. |
<thead> </thead> <tbody> </tbody>
Namelist parameters related to atmospheric chemistry. For naming conventions, see <a href="#sec:artnamelist" data-reference-type="autoref" data-reference="sec:artnamelist">[sec:artnamelist]</a>. These switches art located inside art_nml. | lart_chemtracer | .FALSE. | Enables the computation of simplified chemistry and passive tracers. |
| lart_mecca | .FALSE. | Enables the computation of full chemistry via the MECCA package. |
| cart_vortex_init_date | ÔÇÖ ÔÇÖ | Date of vortex initialization |
| cart_cheminit_file | ÔÇÖ ÔÇÖ | Path to chemical initialization file |
| cart_cheminit_coord | ÔÇÖ ÔÇÖ | Path to chemical initialization coordinate file |
| cart_cheminit_type | ÔÇÖ ÔÇÖ | Type of chemical initialization coordinate file |
| lart_psc | .FALSE. | Switch if polar stratospheric clouds should be calculated |
<thead> </thead> <tbody> </tbody>
Namelist parameters related to aerosol physics. For naming conventions, see <a href="#sec:artnamelist" data-reference-type="autoref" data-reference="sec:artnamelist">[sec:artnamelist]</a>. These switches are located in art_nml . | iart_seasalt | | Treatment of sea salt aerosol. Possible values: : No treatment. : As specified in . Add 6 to iart_ntracer . |
| iart_dust | | Treatment of mineral dust aerosol. Possible values: : No treatment. : As specified in . : Simplified version of . |
| iart_volcano | | Treatment of volcanic ash particles. Possible values: : No treatment. : 1-moment treatment. As described in . Add 6 to iart_ntracer . : 2-moment treatment. Add 6 to iart_ntracer . |
| cart_volcano_file | ÔÇØ | Path and filename of the input file for the geographical position and the type of volcanoes. |
| iart_radioact | | Treatment of radioactive nuclei. Possible values: : No treatment. : As described in the ICON-ART technical documentation. An input file has to be specified via cart_radioact_file. Add 9 to iart_ntracer . |
| cart_radioact_file | ÔÇØ | Path and filename of the input file for the dispersion of radioactive nuclei. |
| iart_pollen | | Treatment of pollen. Possible values: : No treatment. : |
<thead> </thead> <tbody> </tbody>
Namelist parameters related to feedback processes between aerosols and meteorological variables. For naming conventions, see <a href="#sec:artnamelist" data-reference-type="autoref" data-reference="sec:artnamelist">[sec:artnamelist]</a>. | iart_aci_warm | | Treatment of warm-phase activation. Note, that inwp_gscp = 6 is a prerequisite for aerosol-cloud-interactions. Possible values: : Constant qni=200cm3 as for inwp_gscp = 4. : with extensions . |
| iart_aci_cold | | Treatment of cold-phase nucleation. Note, that inwp_gscp = 6 is a prerequisite for aerosol-cloud-interactions. Possible values: : scheme with constant IN properties as for inwp_gscp = 4. : scheme with scheme for het. nucleation. : scheme with scheme for het. nucleation. : scheme with scheme for het. nucleation. : scheme with scheme for het. nucleation. : scheme with Ullrich et al. scheme for het. nucleation. : scheme with scheme for het. nucleation and budget variable for activated dust IN. : scheme with prognostic mineral dust IN and budget variable for activated dust IN. |
| iart_ari | | Direct interaction of simulated aerosol with radiation (here default: irad_aero = 6 ).: no interaction : with interaction. Set irad_aero = 9 in radiation_nml |
<thead> </thead> <tbody> </tbody>
Namelist parameters related to physics parameterizations in ICON. For naming conventions, see <a href="#sec:artnamelist" data-reference-type="autoref" data-reference="sec:artnamelist">[sec:artnamelist]</a>. These switches art located inside art_nml . | lart_conv | .TRUE. | Consider tendencies due to the convection parameterization. |
| lart_turb | .TRUE. | Consider tendencies due to the turbulent diffusion parameterization. |