Namelist: Difference between revisions
Jump to navigation
Jump to search
m (fixed broken formatting in table after adding a row) |
m (renamed table coloumn to "Dependencies" from "dependent xml") |
||
| Line 204: | Line 204: | ||
! Description |
! Description |
||
! Details |
! Details |
||
! Dependencies |
|||
! Dependent xml |
|||
|- |
|- |
||
!rowspan="11" style="vertical-align:top;" | General Variables |
!rowspan="11" style="vertical-align:top;" | General Variables |
||
Revision as of 10:59, 2 March 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 | lart | .FALSE. | Main switch which enables the treatment of atmospheric aerosol and trace gases (the ART modules) | Located in the namelist run_nml | |
| cart_input_folder | - | Absolute path where input folder of ART initialization and external files are located. | |||
| 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_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 |
||
| inwp_gscp | 1 | Cloud microphysics and precipitation. |
1 : one_moment bulk microphysics by Doms and Schaettler(2004) and Seifert and Beheng(2006) 2 : one-moment graupel scheme 3 : two-moment cloud ice scheme of Koehler (2013) 4 : two-moment bulk microphysics by Seifert and Beheng (2006) with prognostic cloud droplet number 5 : two-moment bulk microphysics by Seifert and Beheng (2006) with prognostic cloud droplet number and some aerosol, CCN and IN tracers 6 : two-moment bulk microphysics by Seifert and Beheng (2006) incorporating prognostic aerosol as CCN and IN from the ART extension. Note, that you will still need to set iart_aci_warm and iart_aci_cold 9 : a simple Kessler-type warm rain scheme |
||
| irad_aero | 2 | Aerosols |
0: No aerosol 1: prognostic variable 2: global constant 3: externally specified 5: Tanre aerosol climatology for iforcing = 3 (NWP) 6: Tegen aerosol climatology for iforcing = 3 (NWP) .AND. itopo =1 9: ART online aerosol radiation interaction, uses Tegen for aerosols not chosen to be represented in ART for iforcing = 3 (NWP) .AND. itopo =1 .AND. lart=TRUE .AND. iart_ari=1 12: Perpetual background Kinne aerosols 13: Tropospheric aerosol optical properties after S. Kinne 14: Stratospheric aerosol optical properties 15: Tropospheric aerosols after S. Kinne and stratospheric aerosol optical properties 18: Tropospheric background aerosols (Kinne) and stratospheric aerosols (CMIP6) + simple plumes 19: Tropospheric background aerosols (Kinne), no stratospheric aerosols + simple plumes |
||
| 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 |