Namelist: Difference between revisions
| No edit summary | |||
| (19 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
| __TOC__ | |||
| = Recommended ICON Namelist Settings = | |||
| == Recommended ICON Namelist Settings == | |||
| It is necessary for the user to choose the ICON settings carefully. Part of the values listed in 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. | It is necessary for the user to choose the ICON settings carefully. Part of the values listed in 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. | ||
| Line 5: | Line 6: | ||
| <div id="tab:icon_tracer_nml"> | <div id="tab:icon_tracer_nml"> | ||
| {| class="wikitable" style=" | {| class="wikitable" style="text-align:left;" | ||
| |+ Recommended ICON namelist settings for ART tracers. | |+ Recommended ICON namelist settings for ART tracers. | ||
| ! '''Parameter''' | ! '''Parameter''' | ||
| Line 15: | Line 16: | ||
| | - | | - | ||
| | run_nml | | run_nml | ||
| | If facing stability problems, it is recommended to use a shorter time step as recommended by operational setups (e.g.  | | If facing stability problems, it is recommended to use a shorter time step as recommended by operational setups (e.g. 0.5*dtime). | ||
| |- | |||
| | 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 | | inwp_gscp | ||
| |  | | 4 | ||
| | nwp_phy_nml | | nwp_phy_nml | ||
| |  | | Standard value is 1. Set this to 4 for aerosol-cloud-interactions within ICON-ART. Note, that you will still need to set iart_aci_warm and iart_aci_cold < 0 .  | ||
| |- | |- | ||
| | irad_aero | | irad_aero | ||
| Line 37: | Line 33: | ||
| | optical properties depend on aerosol concentrations (set iart_ari = 1 in art_nml ) | | optical properties depend on aerosol concentrations (set iart_ari = 1 in art_nml ) | ||
| |} | |} | ||
| </div> | </div> | ||
| = ART Namelists = | == ART Namelists == | ||
| 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. | 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. | ||
| Line 47: | Line 42: | ||
| 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_. | 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 . Namelist parameters for ART input are listed within . Namelist parameters related to atmospheric chemistry are listed within . Namelist parameters related to aerosol physics are listed within . Namelist parameters related to feedback processes between aerosols and meteorological variables are listed in . Finally, namelist parameters related to physics parameterizations in ICON are listed in | The ICON-ART namelist is located in the module src/namelists/mo_art_nml.f90. General namelist parameters are listed and explained within . Namelist parameters for ART input are listed within . Namelist parameters related to atmospheric chemistry are listed within . Namelist parameters related to aerosol physics are listed within . Namelist parameters related to feedback processes between aerosols and meteorological variables are listed in . Finally, namelist parameters related to physics parameterizations in ICON are listed in. | ||
| Line 58: | Line 53: | ||
| <div id="tab:namelist"> | <div id="tab:namelist"> | ||
| {| class="wikitable" style=" | {| class="wikitable" style="text-align:left;" | ||
| |+ Art namelist parameters | |+ Art namelist parameters | ||
| ! '''Name''' | ! '''Name''' | ||
| Line 65: | Line 60: | ||
| | '''General Variables''' | | '''General Variables''' | ||
| | | | | ||
| |- | |||
| | <code>cart_input_folder</code> | |||
| | Absolute Path to ART source code | |||
| |- | |- | ||
| | <code>iart_init_aero</code> | | <code>iart_init_aero</code> | ||
| Line 83: | Line 75: | ||
| | <code>lart_emiss_turbdiff</code> | | <code>lart_emiss_turbdiff</code> | ||
| | Switch if emissions should be included as surface flux condition | | Switch if emissions should be included as surface flux condition | ||
| |- | |||
| | <code>cart_input_folder</code> | |||
| | Absolute Path to ART Input Files | |||
| |- | |- | ||
| | <code>cart_io_suffix</code> | | <code>cart_io_suffix</code> | ||
| Line 136: | Line 131: | ||
| |- | |- | ||
| | <code>cart_emiss_xml_file</code> | | <code>cart_emiss_xml_file</code> | ||
| | Path  | | Path to XML file for emission metadata | ||
| |- | |- | ||
| | <code>cart_ext_data_xml</code> | | <code>cart_ext_data_xml</code> | ||
| | Path to XML file for metadata of datasets prescribing tracers | | Path to XML file for metadata of datasets prescribing tracers | ||
| |- | |||
| | <code>cart_coag_xml</code> | |||
| | Path to XML file for coagulation processes | |||
| |- | |- | ||
| | '''Atmospheric Aerosol''' | | '''Atmospheric Aerosol''' | ||
| Line 148: | Line 146: | ||
| |- | |- | ||
| | <code>iart_seasalt </code> | | <code>iart_seasalt </code> | ||
| | Treatment of sea salt aerosol | | Treatment of sea salt aerosol interaction with radiation | ||
| |- | |- | ||
| | <code>iart_dust </code> | | <code>iart_dust </code> | ||
| | Treatment of mineral dust aerosol | | Treatment of mineral dust aerosol interaction with radiation | ||
| |- | |- | ||
| | <code>iart_anthro</code> | | <code>iart_anthro</code> | ||
| Line 157: | Line 155: | ||
| |- | |- | ||
| | <code>iart_fire </code> | | <code>iart_fire </code> | ||
| |  | | Enables treatment of wildfire aerosol | ||
| |- | |- | ||
| | <code>iart_volcano </code> | | <code>iart_volcano </code> | ||
| |  | | Enables treatment of volcanic ash aerosol | ||
| |- | |||
| | <code> iart_isorropia</code> | |||
| | Treatment of aerosol gas partitioning | |||
| |- | |- | ||
| | <code>iart_nonsph</code> | | <code>iart_nonsph</code> | ||
| Line 194: | Line 195: | ||
| <div id="tab:art_nml-params"> | <div id="tab:art_nml-params"> | ||
| {| class="wikitable" style="margin:auto" | |||
| ---- | |||
| |+ General art_nml namelist switches and respective parameters. | |||
| {| class="wikitable" | |||
| ! Namelist parameter | |||
| ! Default | |||
| ! Description | |||
| ! If .TRUE. then needs | |||
| |- | |- | ||
| | <code>iart_modeshift</code> | |||
| | 1 | |||
| | | |||
| | | |||
| |} | |||
| </div> | |||
| <div id="tab:art_nml_gen"> | |||
| {| class="wikitable" style="margin:auto" | |||
| |+ General namelist parameters to control the ART routines. For naming conventions, see . These switches are - with the exception of lart- located inside art_nml. | |||
| ! | ! | ||
| ! Name | |||
| ! | |||
| ! Default Value | |||
| ! '''Description''' | |||
| ! Description | |||
| |- | |||
| ! Details | |||
| | lart | |||
| ! Dependencies | |||
| | .FALSE. | |||
| | Main switch which enables the ART modules. Located in the namelist run_nml . | |||
| |- | |- | ||
| !rowspan="8" style="vertical-align:top;" | General Variables | |||
| | iart_init_aero | | iart_init_aero | ||
| | 0 | |||
| | Initialization of aerosol species. | |||
| |  | |||
|  0: Initialization with 0  | |||
|  1: At this point climatological aerosol profiles may be included as standard initialization  | |||
|  2: Initialization with fixed value different from 0.0_wp (e.g. using 10.0_wp)  | |||
|  5: Set aerosol tracer initial values from file  | |||
|  6: Read background climatology from aes-ham | |||
| | | | | ||
| | Initialization of aerosol species. Possible values: : Initialization with 0. : Initialization with Climatology1 (not yet implemented) : Initialization from files (see ) | |||
| |- | |- | ||
| | iart_init_gas | | iart_init_gas | ||
| | 0 | |||
| | Initialization of gaseous species. | |||
| |  | |||
|  0: Nothing to do here, tracers are initialized with 0.0_wp automatically  | |||
|  1: At this point climatological gas profiles may be included as a standard initialization | |||
|  4: Initializing chemical tracers using method given by .xml | |||
|  5: Initializing from file | |||
| | | | | ||
| | 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 <code>init_mode</code>(see ) : Initialization from files (see ) | |||
| |- | |- | ||
| | lart_diag_out | |||
| | lart_chem | |||
| | .FALSE. | | .FALSE. | ||
| | Enable output of diagnostic fields. | |||
| | Enables chemistry. The chemical mechanism and the according species are set via <code>lart_chemtracer</code> and <code>lart_mecca</code>. | |||
| | If this switch is set to .TRUE., diagnostic output fields are available. Set it to .FALSE. when facing memory problems. | |||
| | cart_diagnostics_xml | |||
| |- | |- | ||
| | lart_pntSrc | | lart_pntSrc | ||
| | .FALSE. | | .FALSE. | ||
| | Enables addition of point sources for passive tracer | | Enables addition of point sources for passive tracer. | ||
| | The sources are controled via cart_pntSrc_xml. | |||
| | cart_pntSrc_xml | |||
| |- | |- | ||
| | lart_emiss_turbdiff | |||
| | lart_aerosol | |||
| | .FALSE. | | .FALSE. | ||
| | Switch if emissions should be included to the turbulence scheme as surface flux condition | |||
| | Main switch for the treatment of atmospheric aerosol. | |||
| | | | | ||
| | | |||
| | lart_diag_out | |||
| | .FALSE. | |||
| | If this switch is set to <code>.TRUE.</code>, diagnostic output fields are available. Set it to <code>.FALSE.</code> when facing memory problems. | |||
| |} | |||
| </div> | |||
| <div id="tab:art_nml_io"> | |||
| {| class="wikitable" style="margin:auto" | |||
| |+ Namelist parameters to control ART input. These switches are located inside art_nml. | |||
| ! cart_io_suffix(ndom) | |||
| ! ’grid-number’ | |||
| ! Specifies the grid specification in ART input file name convention (see section [[#sec:name_concept|[sec:name_concept]]]). With default grid-number it is replaced by the four character string due to ICON parameter number_of_grid_used . Any other string can be included for each domain. | |||
| |- | |- | ||
| | cart_input_folder | | cart_input_folder | ||
| |  | | - | ||
| | Absolute path where input  | | Absolute path where input folder of ART initialization and external files are located. | ||
| | | |||
| | | |||
| |- | |- | ||
| | cart_io_suffix | |||
| | cart_emiss_xml_file | |||
| | 'grid-nr' | |||
| | ” | |||
| | Specifies the grid specification in ART input file name convention. With default grid-number it is replaced by the four character string due to ICON parameter number_of_grid_used . Any other string can be included for each domain. | |||
| | Path and file name to the XML file for specifying emission metadata. | |||
| | | |||
| | | |||
| |- | |- | ||
| | iart_modeshift | |||
| | cart_chemtracer_xml | |||
| |  | | 1 | ||
| | Doing mode shift (only temporary switch for debug) | |||
| | Path and file name to the XML file for specifying chemical and passive tracer. | |||
| |  | |||
|  0 = off  | |||
|  1 = on | |||
| | | |||
| |- | |- | ||
| !rowspan="8" style="vertical-align:top;" |  Atmospheric Chemistry | |||
| | cart_mecca_xml | |||
| | lart_chem | |||
| | ” | |||
| | .FALSE. | |||
| | Path and file name to the XML file for specifying tracers of the MECCA chemical mechanism. | |||
| | Main switch to enable chemistry | |||
| |- | |||
| | | |||
| | cart_aerosol_xml | |||
| | lart_chemtracer = .TRUE. OR lart_mecca = .TRUE. | |||
| | ” | |||
| | 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. | |||
| |} | |||
| </div> | |||
| <div id="tab:art_nml_chem"> | |||
| {| class="wikitable" style="margin:auto" | |||
| |+ Namelist parameters related to atmospheric chemistry. For naming conventions, see . These switches art located inside art_nml. | |||
| ! | |||
| ! | |||
| ! '''Description''' | |||
| |- | |- | ||
| | lart_chemtracer | | lart_chemtracer | ||
| | .FALSE. | | .FALSE. | ||
| | Switch for chemical tracer processes | |||
| | Enables the computation of simplified chemistry and passive tracers. | |||
| | | |||
| | cart_chemtracer_xml | |||
| |- | |- | ||
| | lart_mecca | | lart_mecca | ||
| | .FALSE. | | .FALSE. | ||
| | Enables the computation of full chemistry via the MECCA package. | | Enables the computation of full chemistry via the MECCA package. | ||
| | | |||
| | cart_mecca_xml | |||
| |- | |||
| | lart_psc | |||
| | .FALSE. | |||
| | Switch if polar stratospheric clouds should be calculated | |||
| | | |||
| | | |||
| |- | |- | ||
| | cart_vortex_init_date | | cart_vortex_init_date | ||
| |  | | - | ||
| | Date of vortex initialization | | Date of vortex initialization | ||
| | | |||
| | | |||
| |- | |- | ||
| | cart_cheminit_file | | cart_cheminit_file(max_dom) | ||
| |  | | - | ||
| | Path to chemical initialization file | | Path to chemical initialization file | ||
| | | |||
| | | |||
| |- | |- | ||
| | cart_cheminit_coord | | cart_cheminit_coord | ||
| |  | | - | ||
| | Path to chemical initialization coordinate file | | Path to chemical initialization coordinate file | ||
| | | |||
| | | |||
| |- | |- | ||
| | cart_cheminit_type | | cart_cheminit_type | ||
| |  | | - | ||
| | Type of chemical initialization coordinate file | | Type of chemical initialization coordinate file | ||
| | | |||
| | | |||
| |- | |- | ||
| !rowspan="9" style="vertical-align:top;" |  XML configuration | |||
| | lart_psc | |||
| | cart_chemtracer_xml | |||
| | - | |||
| | Path to XML file for parametrised chemtracers | |||
| | | |||
| | | |||
| |- | |||
| | cart_mecca_xml | |||
| | - | |||
| | Path to XML file for MECCA chemistry tracers | |||
| | | |||
| | | |||
| |- | |||
| | cart_aerosol_xml | |||
| | - | |||
| | Path to XML file for aerosol tracers | |||
| | | |||
| | | |||
| |- | |||
| | cart_modes_xml | |||
| | - | |||
| | Path to XML file for modes | |||
| | | |||
| | | |||
| |- | |||
| | cart_pntSrc_xml | |||
| | - | |||
| | Path to XML file for point sources | |||
| | | |||
| | | |||
| |- | |||
| | cart_diagnostics_xml | |||
| | - | |||
| | Path to XML file for aerosol diagnostics (GRIB2 meta data) | |||
| | | |||
| | | |||
| |- | |||
| | cart_emiss_xml_file | |||
| | - | |||
| | Path and file name of the xml files for emission metadata | |||
| | | |||
| | | |||
| |- | |||
| | cart_ext_data_xml | |||
| | - | |||
| | Path to XML file for metadata of datasets prescribing tracers | |||
| | | |||
| | | |||
| |- | |||
| | cart_coag_xml | |||
| | - | |||
| | Path to XML file for coagulation processes | |||
| | | |||
| | | |||
| |- | |||
| !rowspan="9" style="vertical-align:top;" |  Atmospheric Aerosol | |||
| | lart_aerosol | |||
| | .FALSE. | | .FALSE. | ||
| | Main switch for the treatment of atmospheric aerosol | |||
| | Switch if polar stratospheric clouds should be calculated | |||
| | | | | ||
| | cart_aerosol_xml | |||
| </div> | |||
| <div id="tab:art_nml_aero"> | |||
| {| class="wikitable" style="margin:auto" | |||
| |+ Namelist parameters related to aerosol physics. For naming conventions, see . These switches are located in art_nml . | |||
| ! | |||
| ! | |||
| ! '''Description''' | |||
| |- | |- | ||
| | iart_seasalt | | iart_seasalt | ||
| | 0 | |||
| | Treatment of sea salt aerosol | |||
| |  | |||
|  0: No treatment. | |||
|  1: Initialization of seasalt emission. Add 6 to iart_ntracer. | |||
|  2: A second parameterization is used for the seasalt emission. Add 6 to iart_ntracer. | |||
| | | | | ||
| | Treatment of sea salt aerosol. Possible values: : No treatment. : As specified in . Add 6 to iart_ntracer . | |||
| |- | |- | ||
| | iart_dust | | iart_dust | ||
| | 0 | |||
| | Treatment of mineral dust aerosol | |||
| |  | |||
|  0: No treatment. | |||
|  1: Initialization of mineral dust aerosol (Vogel et al. 2006). | |||
|  2: Simplified version of emission fluxes of mineral dust aerosol (Vogel et al. 2006). | |||
| | | | | ||
| | Treatment of mineral dust aerosol. Possible values: : No treatment. : As specified in . : Simplified version of . | |||
| |- | |- | ||
| | iart_anthro | |||
| | iart_volcano | |||
| | 0 | |||
| | Treatment of anthropogenic aerosol | |||
| |  | |||
|  0: No treatment. | |||
|  1: With the anthropogenic aerosol. | |||
| | | | | ||
| | 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 . | |||
| |- | |- | ||
| | iart_fire | |||
| | cart_volcano_file | |||
| |  | | 0 | ||
| | Treatment of wildfire aerosol | |||
| | Path and filename of the input file for the geographical position and the type of volcanoes. | |||
| | | |||
|  0: Nothing to do, no biomass burning emissions | |||
|  1: Initialization of biomass burning tracer data | |||
| | | |||
| |- | |- | ||
| | iart_volcano | |||
| | iart_radioact | |||
| | 0 | |||
| | Treatment of volcanic ash aerosol | |||
| | | |||
|  0: No treatment. | |||
|  1: 1-moment treatment. Add 6 to iart ntracer. | |||
|  2: 2-moment treatment. Add 6 to iart_ntracer. | |||
| | | | | ||
| | 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 . | |||
| |- | |- | ||
| | iart_nonsph | |||
| | cart_radioact_file | |||
| |  | | 0 | ||
| | Treatment of nonspherical particles | |||
| | Path and filename of the input file for the dispersion of radioactive nuclei. | |||
| | | |||
|  0: USE Mie values | |||
|  1: Ellipsoid mixture | |||
| | | |||
| |- | |- | ||
| | iart_pollen | | iart_pollen | ||
| | 0 | |||
| | Treatment of pollen | |||
| | | |||
|  0: No treatment | |||
|  1: Initialization of pollen tracer data | |||
| | | | | ||
| | Treatment of pollen. Possible values: : No treatment. : | |||
| |} | |||
| </div> | |||
| <div id="tab:art_nml_iact"> | |||
| {| class="wikitable" style="margin:auto" | |||
| |+ Namelist parameters related to feedback processes between aerosols and meteorological variables. For naming conventions, see . | |||
| ! | |||
| ! | |||
| ! '''Description''' | |||
| |- | |- | ||
| | iart_radioact | |||
| | 0 | |||
| | Treatment of radioactive particles | |||
| | | |||
|  0: No treatment. | |||
|  1: As described in the ICON-ART technical documentation. An input file has to be specified via cart_radioact_file. Add 9 to iart_ntracer. | |||
| | | |||
| |- | |||
| !rowspan="3" style="vertical-align:top;" |  Feedback Processes | |||
| | iart_aci_warm | | iart_aci_warm | ||
| | 0 | |||
| | Nucleation of aerosol to cloud droplets | |||
| | | |||
|  0: Constant cloud droplet number inwp_gscp=4 | |||
|  1: Nucleation Warm ART | |||
| | | | | ||
| | Treatment of warm-phase activation. Note, that inwp_gscp = 6 is a prerequisite for aerosol-cloud-interactions. Possible values: : Constant <math display="inline">qni = 200\,\mathrm{cm}^{-3}</math> as for inwp_gscp = 4. :  with extensions . | |||
| |- | |- | ||
| | iart_aci_cold | | iart_aci_cold | ||
| | 0 | |||
| | Nucleation of aerosol to cloud ice | |||
| | | |||
|  0: Nucleation originial 2-moment scheme (1,2,3,4,5): Nucleation Cold ART | |||
|  6: With tracking of activated dust | |||
|  7: With prognostic dust as input and relaxation of activated dust | |||
| | | | | ||
| | 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 | | iart_ari | ||
| | 0 | |||
| | Direct interaction of aerosol with radiation | |||
| | | |||
|  0: No radiation feedback with ART aerosols | |||
|  1: Turn on radiation feedback with ART aerosols (ASH or DUST). Set irad_aero = 9 in radiation_nml | |||
| | | | | ||
| | Direct interaction of simulated aerosol with radiation (here default: irad_aero = 6 ).: no interaction : with interaction. Set irad_aero = 9 in radiation_nml | |||
| |} | |||
| </div> | |||
| <div id="tab:art_nml_physparam"> | |||
| {| class="wikitable" style="margin:auto"|+ Namelist parameters related to physics parameterizations in ICON. For naming conventions, see . These switches art located inside art_nml . | |||
| ! | |||
| ! | |||
| ! '''Description''' | |||
| |- | |- | ||
| !rowspan="3" style="vertical-align:top;" |  Emissions | |||
| | lart_conv | |||
| | cart_volcano_file | |||
| | .TRUE. | |||
| | - | |||
| | Consider tendencies due to the convection parameterization. | |||
| | Absolute path + filename of input file for volcanoes | |||
| | | |||
| | | |||
| |- | |- | ||
| | cart_radioact_file | |||
| | lart_turb | |||
| |  | | - | ||
| | Absolute path + filename of input for radioactive emissions | |||
| | Consider tendencies due to the turbulent diffusion parameterization. | |||
| | | |||
| | | |||
| |- | |||
| | Online emission module | |||
| | | |||
| | See oem namelist | |||
| | | |||
| | | |||
| |} | |} | ||
| </div> | |||
Latest revision as of 10:26, 29 June 2023
Recommended ICON Namelist Settings
It is necessary for the user to choose the ICON settings carefully. Part of the values listed in 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.
| Parameter | Value | Namelist | Description | 
|---|---|---|---|
| dtime | - | run_nml | If facing stability problems, it is recommended to use a shorter time step as recommended by operational setups (e.g. 0.5*dtime). | 
| inwp_gscp | 4 | nwp_phy_nml | Standard value is 1. Set this to 4 for aerosol-cloud-interactions within ICON-ART. Note, that you will still need to set iart_aci_warm and iart_aci_cold < 0 . | 
| irad_aero | 6 | radiation_nml | aerosol optical properties are taken from climatology | 
| 9 | optical properties depend on aerosol concentrations (set iart_ari = 1 in art_nml ) | 
ART Namelists
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 . Namelist parameters for ART input are listed within . Namelist parameters related to atmospheric chemistry are listed within . Namelist parameters related to aerosol physics are listed within . Namelist parameters related to feedback processes between aerosols and meteorological variables are listed in . Finally, namelist parameters related to physics parameterizations in ICON are listed in.
| Name | function | 
|---|---|
| General Variables | |
| iart_init_aero | Initialization of aerosol species | 
| iart_init_gas | Initialization of gaseous species | 
| lart_diag_out | Enable output of diagnostic fields | 
| lart_pntSrc | Enables point sources | 
| lart_emiss_turbdiff | Switch if emissions should be included as surface flux condition | 
| cart_input_folder | Absolute Path to ART Input Files | 
| cart_io_suffix | user given suffix instead of automatically generated grid number | 
| Atmospheric Chemistry | |
| lart_chem | Main switch to enable chemistry | 
| lart_chemtracer | Switch for parametrised chemtracers | 
| lart_mecca | Switch for MECCA chemistry | 
| lart_psc | Switch for computation of PSCs | 
| cart_vortex_init_date | Date of vortex initialization | 
| cheminit_file(max_dom) | Path to chemical initialization file | 
| cart_cheminit_coord | Path to chemical initialization coordinate file | 
| cart_cheminit_type | Type of chemical initialization coordinate file | 
| XML configuration | |
| cart_chemtracer_xml | Path to XML file for parametrised chemtracers | 
| cart_mecca_xml | Path to XML file for MECCA tracers | 
| cart_aerosol_xml | Path to XML file for aerosol tracers | 
| cart_modes_xml | Path to XML file for modes | 
| cart_pntSrc_xml | Path to XML file for point sources | 
| cart_diagnostics_xml | Path to XML file for aerosol diagnostics | 
| cart_emiss_xml_file | Path to XML file for emission metadata | 
| cart_ext_data_xml | Path to XML file for metadata of datasets prescribing tracers | 
| cart_coag_xml | Path to XML file for coagulation processes | 
| Atmospheric Aerosol | |
| lart_aerosol  | Main switch for the treatment of atmospheric aerosol | 
| iart_seasalt  | Treatment of sea salt aerosol interaction with radiation | 
| iart_dust  | Treatment of mineral dust aerosol interaction with radiation | 
| iart_anthro | Treatment of anthropogenic aerosol | 
| iart_fire  | Enables treatment of wildfire aerosol | 
| iart_volcano  | Enables treatment of volcanic ash aerosol | 
|  iart_isorropia | Treatment of aerosol gas partitioning | 
| iart_nonsph | Treatment of nonspherical particles | 
| iart_pollen  | Treatment of pollen | 
| iart_radioact | Treatment of radioactive particles | 
| cart_volcano_file  | Absolute path + filename of input file for volcanoes | 
| cart_radioact_file | Absolute path + filename of input for radioactive emissions | 
| Feedback Processes | |
| iart_aci_warm  | Nucleation of aerosol to cloud droplets | 
| iart_aci_cold  | Nucleation of aerosol to cloud ice | 
| iart_ari  | Direct interaction of aerosol with radiation | 
| Name | Default Value | Description | Details | Dependencies | |
|---|---|---|---|---|---|
| General Variables | iart_init_aero | 0 | Initialization of aerosol species. | 0: Initialization with 0 1: At this point climatological aerosol profiles may be included as standard initialization 2: Initialization with fixed value different from 0.0_wp (e.g. using 10.0_wp) 5: Set aerosol tracer initial values from file 6: Read background climatology from aes-ham | |
| iart_init_gas | 0 | Initialization of gaseous species. | 0: Nothing to do here, tracers are initialized with 0.0_wp automatically 1: At this point climatological gas profiles may be included as a standard initialization 4: Initializing chemical tracers using method given by .xml 5: Initializing from file | ||
| lart_diag_out | .FALSE. | Enable output of diagnostic fields. | If this switch is set to .TRUE., diagnostic output fields are available. Set it to .FALSE. when facing memory problems. | cart_diagnostics_xml | |
| lart_pntSrc | .FALSE. | Enables addition of point sources for passive tracer. | The sources are controled via cart_pntSrc_xml. | cart_pntSrc_xml | |
| lart_emiss_turbdiff | .FALSE. | Switch if emissions should be included to the turbulence scheme as surface flux condition | |||
| cart_input_folder | - | Absolute path where input folder of ART initialization and external files are located. | |||
| cart_io_suffix | 'grid-nr' | Specifies the grid specification in ART input file name convention. With default grid-number it is replaced by the four character string due to ICON parameter number_of_grid_used . Any other string can be included for each domain. | |||
| iart_modeshift | 1 | Doing mode shift (only temporary switch for debug) | 0 = off 1 = on | ||
| Atmospheric Chemistry | lart_chem | .FALSE. | Main switch to enable chemistry | lart_chemtracer = .TRUE. OR lart_mecca = .TRUE. | |
| lart_chemtracer | .FALSE. | Switch for chemical tracer processes | cart_chemtracer_xml | ||
| lart_mecca | .FALSE. | Enables the computation of full chemistry via the MECCA package. | cart_mecca_xml | ||
| lart_psc | .FALSE. | Switch if polar stratospheric clouds should be calculated | |||
| cart_vortex_init_date | - | Date of vortex initialization | |||
| cart_cheminit_file(max_dom) | - | Path to chemical initialization file | |||
| cart_cheminit_coord | - | Path to chemical initialization coordinate file | |||
| cart_cheminit_type | - | Type of chemical initialization coordinate file | |||
| XML configuration | cart_chemtracer_xml | - | Path to XML file for parametrised chemtracers | ||
| cart_mecca_xml | - | Path to XML file for MECCA chemistry tracers | |||
| cart_aerosol_xml | - | Path to XML file for aerosol tracers | |||
| cart_modes_xml | - | Path to XML file for modes | |||
| cart_pntSrc_xml | - | Path to XML file for point sources | |||
| cart_diagnostics_xml | - | Path to XML file for aerosol diagnostics (GRIB2 meta data) | |||
| cart_emiss_xml_file | - | Path and file name of the xml files for emission metadata | |||
| cart_ext_data_xml | - | Path to XML file for metadata of datasets prescribing tracers | |||
| cart_coag_xml | - | Path to XML file for coagulation processes | |||
| Atmospheric Aerosol | lart_aerosol | .FALSE. | Main switch for the treatment of atmospheric aerosol | cart_aerosol_xml | |
| iart_seasalt | 0 | Treatment of sea salt aerosol | 0: No treatment. 1: Initialization of seasalt emission. Add 6 to iart_ntracer. 2: A second parameterization is used for the seasalt emission. Add 6 to iart_ntracer. | ||
| iart_dust | 0 | Treatment of mineral dust aerosol | 0: No treatment. 1: Initialization of mineral dust aerosol (Vogel et al. 2006). 2: Simplified version of emission fluxes of mineral dust aerosol (Vogel et al. 2006). | ||
| iart_anthro | 0 | Treatment of anthropogenic aerosol | 0: No treatment. 1: With the anthropogenic aerosol. | ||
| iart_fire | 0 | Treatment of wildfire aerosol | 0: Nothing to do, no biomass burning emissions 1: Initialization of biomass burning tracer data | ||
| iart_volcano | 0 | Treatment of volcanic ash aerosol | 0: No treatment. 1: 1-moment treatment. Add 6 to iart ntracer. 2: 2-moment treatment. Add 6 to iart_ntracer. | ||
| iart_nonsph | 0 | Treatment of nonspherical particles | 0: USE Mie values 1: Ellipsoid mixture | ||
| iart_pollen | 0 | Treatment of pollen | 0: No treatment 1: Initialization of pollen tracer data | ||
| iart_radioact | 0 | Treatment of radioactive particles | 0: No treatment. 1: As described in the ICON-ART technical documentation. An input file has to be specified via cart_radioact_file. Add 9 to iart_ntracer. | ||
| Feedback Processes | iart_aci_warm | 0 | Nucleation of aerosol to cloud droplets | 0: Constant cloud droplet number inwp_gscp=4 1: Nucleation Warm ART | |
| iart_aci_cold | 0 | Nucleation of aerosol to cloud ice | 0: Nucleation originial 2-moment scheme (1,2,3,4,5): Nucleation Cold ART 6: With tracking of activated dust 7: With prognostic dust as input and relaxation of activated dust | ||
| iart_ari | 0 | Direct interaction of aerosol with radiation | 0: No radiation feedback with ART aerosols 1: Turn on radiation feedback with ART aerosols (ASH or DUST). Set irad_aero = 9 in radiation_nml | ||
| Emissions | cart_volcano_file | - | Absolute path + filename of input file for volcanoes | ||
| cart_radioact_file | - | Absolute path + filename of input for radioactive emissions | |||
| Online emission module | See oem namelist |