Namelist: Difference between revisions

From icon-art guide
Jump to navigation Jump to search
(added table with xml related namelist switches)
No edit summary
 
(18 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="margin:auto"
{| 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. <math display="inline">\frac{3}{5}\cdot</math>dtime<math display="inline">_{oper}</math>).
| 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
| 6
| 4
| nwp_phy_nml
| 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 .
| 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="margin:auto"
{| 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 and file name of the xml files for emission metadata
| 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>
| Treatment of wildfire aerosol
| Enables treatment of wildfire aerosol
|-
|-
| <code>iart_volcano </code>
| <code>iart_volcano </code>
| Treatment of volcanic ash aerosol
| 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.
! Namelist parameter
! Default
! Description
! If .TRUE. then needs
|-
| <code>iart_modeshift</code>
| 1
|
|
|}


----

{| class="wikitable"
</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. The sources are controled via <code>cart_pntSrc_xml</code>.
| 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 files, like initialization files are located.
| 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
|
|-
| 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.
|
|
| 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'''
|-
|-
!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
| .TRUE.
| -
| Absolute path + filename of input for radioactive emissions
| Consider tendencies due to the turbulent diffusion parameterization.
|}
|
|


</div>



<div id="tab:art_nml-params">

{| class="wikitable" style="margin:auto"
|+ General art_nml namelist switches and respective parameters.
! Namelist parameter
! Default
! Description
! If .TRUE. then needs
|---
| <code>lart_chem</code>
| .FALSE.
| Enables chemistry.
| <code>lart_chemtracer = .TRUE.</code>OR <code>lart_mecca = .TRUE.</code>
|-
| <code>lart_chemtracer</code>
| .FALSE.
| Switch for simple OH chemistry
| <code>cart_chemtracer_xml</code>
|-
| <code>lart_mecca</code>
| .FALSE.
| Switch for kpp chemistry
| <code>cart_mecca_xml</code>
|-
| <code>lart_pntSrc</code>
| .FALSE.
| Enables addition of point sources
| <code>cart_pntSrc_xml</code>
|-
| <code>lart_aerosol</code>
| .FALSE.
| Main switch for the treatment of
| <code>cart_aerosol_xml</code>
|-
|-
| Online emission module
|
| See oem namelist
|
|
|
|
| atmospheric aerosol.
| and <code>cart_modes_xml</code>
|-
| <code>lart_diag_out</code>
| .FALSE.
| Enables diagnostic output fields
| <code>cart_diagnostics_xml</code>
|}
|}


</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.

Recommended ICON namelist settings for ART tracers.
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.




Art namelist parameters
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
Retrieved from "https://www.icon-art.kit.edu/userguide/index.php?title=Namelist&oldid=209"