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 |