Output
General Remarks
In principle, output of ICON-ART variables works the same way as for ICON variables. As described in , the following five quantities of the output have to be specified:
- The time interval between two model outputs.
- The name of the output file.
- The name of the variable(s) and/or variable group(s).
- The type of vertical output grid.
- The type of horizontal output grid.
For the best results it is recommended to use NETCDF output on the icosahedral grid which ICON-ART is using. However in some applications remapping the grid to a latitude-longitude grid may be required, which can be set via the remap option. A corresponding output namelist for sea salt on model levels can be seen here:
1 NAMELIST EXAMPLE
2 &output_nml
3 filetype = 4 ! output format: 2=GRIB2, 4=NETCDFv2
4 dom = 1 ! write output for domain 1
5 output_start = 'JJJJ-MM-DDTHH:MM:SSZ' !put date in
6 output_end = 'JJJJ-MM-DDTHH:MM:SSZ' !put date in
7 output_interval = 'PT1H' ! see https://en.wikipedia.org/wiki/ISO_8601
8 steps_per_file = 1 ! max. num. of time steps within one file
9 mode = 1 ! 1: forecast mode (relative t-axis)
10 include_last = .TRUE. ! include the last time step
11 output_filename = 'INSERTFILENAME' ! file name base
12 ml_varlist = 'seasa','seasb','seasc',
13 'seasa0','seasb0','seasc0'
14 remap = 1 ! output is transferred to lat long grid
15 reg_lon_def = -180.,0.5,179.5 !start, incr., end, in deg.
16 reg_lat_def = 90.,-0.5, -90. !start, incr., end, in deg.
There is an option to obtain all diagnostic Variables of a certain Group without having to specifying all of them. For example, you may use the group ART_DIAGNOSTICS.
To include a group of Variables in the output file change the namelist variable ml_varlist from the example above to the following:
ml_varlist = 'group:ART_AEROSOL'
The output variables that are associated to this group will be written to the output file. You can check the groups of output variables in this Table .
Aerosol Naming Conventions
The following table contains an overview of the possible output variables.
There are several ways to choose the Naming of the output variables, depending on your application
- Externally mixed Aerosols: : The Tracers for Dust, Seasalt, Ash and Soot are combined with the three Possible modes a, b and c, which correspond to the different size bins of the particles
Externally mixed Tracer modes dust seasalt ash soot a dusta seasa asha soota b dustb seasb ashb - c dustc seasc ashc -
- Internally mixed Aerosols (AERODYN): Here a tracer is defined in a different way, with the goal being to have a more flexible framework for various applications. In this framework modes are created in a different way, as illustrated int the table below:
AERODYN mode configurations aitken accumulation coarse giant soluble sol_aitken sol_acc sol_coarse sol_giant insoluble insol_aitken insol_acc insol_coarse insol_giant mixed mixed_aitken mixed_acc mixed_coarse mixed_giant
The modes are then combined with The Tracername to obtain the name of the Variable using varname = 'Tracer' + '_' + 'mode from Table'.
Example : dust_insol_acc
- Monodisperse Aerosols
Available Output Variables
The following Table contains an overview over the diagnostic Icon-ART Variables. Expressions in Brackets are Placeholders which can be used to construct the name of the actual variables:
[aeronet wavelength] => [340, 380, 440, 500, 550, 675, 870, 1020, 1064]
[ceilo_wavelength] => [355,532,1064]
[pollen] => [ALNU,BETU,...] to be defined in diagnostics.xml
| varname | groups | unit | descripition | namelist switch | required xml | |
|---|---|---|---|---|---|---|
| Aerosols | diam_[mode] | ART_DIAGNOSTICS | m | with AERODYN : aerosol diameter | lart_aerosol=True and lart_diag_out=True | requires cart_diagnostics_xml file |
| diam_[aerosol][mode] | ART_DIAGNOSTICS | m | WITHOUT AERODYN: aerosol diameter | lart_aerosol=True and lart_diag_out=True | requires cart_diagnostics_xml file | |
| aod_[aerosol]_[aeronet wavelength]nm | ART_DIAGNOSTICS , ART_ROUTINE_DIAG | Layer-1 | [AEROSOL] optical depth | lart_aerosol=True and lart_diag_out=True | requires cart_diagnostics_xml file | |
| bsc_[arosol]_[ceilo_wavelength]nm | ART_DIAGNOSTICS | m-1 sr-1 | [AEROSOL] backscatter | lart_aerosol=True and lart_diag_out=True | requires cart_diagnostics_xml file | |
| ceil_[arosol]_[ceilo_wavelength]nm | ART_DIAGNOSTICS , ART_ROUTINE_DIAG | m-1 sr-1 | [AEROSOL] Attenuated Backscatter Ceilometer | lart_aerosol=True and lart_diag_out=True | requires cart_diagnostics_xml file | |
| sat_[arosol]_[ceilo_wavelength]nm | ART_DIAGNOSTICS | m-1 sr-1 | [AEROSOL] Attenuated Backscatter Satellite | lart_aerosol=True and lart_diag_out=True | requires cart_diagnostics_xml file | |
| AOD_550_so4_sol | ART_DIAGNOSTICS | layer-1 | SO4 sol Optical Depth | lart_aerosol=True and lart_diag_out=True | requires cart_diagnostics_xml file | |
| AOD_550_ash_insol | ART_DIAGNOSTICS | layer-1 | Ash insol Optical Depth | lart_aerosol=True and lart_diag_out=True | requires cart_diagnostics_xml file | |
| AOD_550_ash_mixed | ART_DIAGNOSTICS | layer-1 | Ash mixed Optical Depth | lart_aerosol=True and lart_diag_out=True | requires cart_diagnostics_xml file | |
| AOD_550_ash_giant | ART_DIAGNOSTICS | layer-1 | Ash giant Optical Depth | lart_aerosol=True and lart_diag_out=True | requires cart_diagnostics_xml file | |
| ustar_thres | ART_ROUTINE_DIAG | m s-1 | threshold friction velocity for dust emission' | lart_aerosol=True and lart_diag_out=True | requires cart_diagnostics_xml file | |
| ustar | ART_ROUTINE_DIAG | m s-1 | Friction velocity | lart_aerosol=True and lart_diag_out=True | requires cart_diagnostics_xml file | |
| acc_drydepo_[tracer] | ART_DIAGNOSTICS , ART_ROUTINE_DIAG | tracer-unit m-2 | accumulated dry deposition of tracer | lart_aerosol=True and lart_diag_out=True | requires cart_diagnostics_xml file | |
| acc_sedim_[tracer] | ART_DIAGNOSTICS , ART_ROUTINE_DIAG | tracer-unit m-2 | accumulated sedimentation of tracer | lart_aerosol=True and lart_diag_out=True | requires cart_diagnostics_xml file | |
| acc_wetdepo_gscp_[tracer] | ART_DIAGNOSTICS , ART_ROUTINE_DIAG | tracer-unit m-2 | accumulated wet deposition by grid scale precipitation of tracer | lart_aerosol=True and lart_diag_out=True | requires cart_diagnostics_xml file | |
| acc_wetdepo_con_[tracer] | ART_DIAGNOSTICS , ART_ROUTINE_DIAG | tracer-unit m-2 | accumulated wet deposition by convective precipitation of tracer | lart_aerosol=True and lart_diag_out=True | requires cart_diagnostics_xml file | |
| acc_wetdepo_rrsfc_[tracer] | ART_DIAGNOSTICS , ART_ROUTINE_DIAG | tracer-unit m-2 | accumulated wet deposition of tracer if precipitation reaches surface | lart_aerosol=True and lart_diag_out=True | requires cart_diagnostics_xml file | |
| emiss_[tracer] | ART_DIAGNOSTICS , ART_ROUTINE_DIAG | tracer-unit m-2 s-1 | emission of tracer | lart_aerosol=True and lart_diag_out=True | requires cart_diagnostics_xml file | |
| acc_emiss_[tracer] | ART_DIAGNOSTICS , ART_ROUTINE_DIAG | tracer-unit m-2 | accumulated emission of tracer | lart_aerosol=True and lart_diag_out=True | requires cart_diagnostics_xml file | |
| Pollen | [pollen]rprec | ART_ROUTINE_DIAG | m-2 | precipitation reservoir of [pollen] | iart_pollen>0 | REQUIRES diagnostics.xml |
| [pollen]reso | ART_ROUTINE_DIAG | m-2 | Pollen reservoir (previous timestep) of [pollen] | iart_pollen>0 | REQUIRES diagnostics.xml | |
| [pollen]ress | ART_ROUTINE_DIAG | m-2 | Pollen reservoir (daily sum) of [pollen] | iart_pollen>0 | REQUIRES diagnostics.xml | |
| [pollen]sdes | ART_ROUTINE_DIAG | - | State of pollen season of [pollen] | iart_pollen>0 | REQUIRES diagnostics.xml | |
| [pollen]ctsum | ART_ROUTINE_DIAG | K | Cumulated weighted 2m temperature sum of [pollen] | iart_pollen>0 | REQUIRES diagnostics.xml | |
| [pollen]saisn | ART_ROUTINE_DIAG | days | Number of days since start of pollen season of [pollen] | iart_pollen>0 | REQUIRES diagnostics.xml | |
| [pollen]saisl | ART_ROUTINE_DIAG | days | length of pollen season of [pollen] | iart_pollen>0 | REQUIRES diagnostics.xml | |
| [pollen]saisa | ART_ROUTINE_DIAG | days | Number of days since the start of pollen season of [pollen]. if present day is out of the season: length of current season | REQUIRES diagnostics.xml | ||
| [pollen]fe | ART_ROUTINE_DIAG | m-2 s-1 | Emission flux of [pollen] | iart_pollen>0 | REQUIRES diagnostics.xml | |
| Chemistry | reac_rates | ART_DIAGNOSTICS | s-1 | MECCA reaction rates | lart_mecca=True, lart_diag_out=True | |
| art_o3 | kg/kg | Ozone mass mixing ratio | lart_chem =True, lart_diag_out=True | |||
| OH_Nconc | # / cm3 | OH number concentration | lart_chem =TRUE | |||
| photo | - | s-1 | photolysis rates | lart_chem=TRUE, lart_mecca=TRUE | ||
| art_full_chemistry_o3_col | - | DU | Ozone column | lart_chem=TRUE, lart_mecca=TRUE | ||
| sts_liqsur | ART_DIAGNOSTICS | cm2 cm-3 | liquid area density of STS | lart_chem=TRUE , lart_psc=TRUE | ||
| cgaml | ART_DIAGNOSTICS | - | STS uptake coefficient of the reaction | lart_chem=TRUE , lart_psc=TRUE | ||
| dens_ice | ART_DIAGNOSTICS | m-3 | number density of ice particles | lart_chem=TRUE , lart_psc=TRUE | ||
| radius_ice | ART_DIAGNOSTICS | m | radius of ice particles | lart_chem=TRUE , lart_psc=TRUE | ||
| radius_STS | ART_DIAGNOSTICS | m | radius of STS particles | lart_chem=TRUE , lart_psc=TRUE | ||
| dens_NAT | ART_DIAGNOSTICS | m-3 | number density of NAT particles | lart_chem=TRUE , lart_psc=TRUE | ||
| radius_NAT | ART_DIAGNOSTICS | m | radius of NAT particles | lart_chem=TRUE , lart_psc=TRUE | ||
| HNO3_Nconc_s | ART_DIAGNOSTICS | cm-3 | number concentration of HNO3 in NAT | lart_chem=TRUE , lart_psc=TRUE | ||
| HNO3_Nconc_l | ART_DIAGNOSTICS | cm-3 | number concentration of HNO3 in STS | lart_chem=TRUE , lart_psc=TRUE | ||
| ice_vmr_Marti | ART_DIAGNOSTICS | mol mol-1 | volume mixing ratio of solid water by Marti and Mauersberger | lart_chem=TRUE , lart_psc=TRUE | ||
| NAT_sedi_rel_difference | ART_DIAGNOSTICS | - | relative difference of NAT mass bef and aft sedi (aft - bef) * 2 / (aft + bef) | lart_chem=TRUE , lart_psc=TRUE | ||
| NAT_sedi_vel | ART_DIAGNOSTICS | m s-1 | sedimentation velocity of NAT particles | lart_chem=TRUE , lart_psc=TRUE | ||
| art_so2_col | ART_DIAGNOSTICS | DU | SO2 column | lat_chem=TRUE , lart_chemtracer=TRUE | ||
| Radioactive Tracer Diagnostics | wet deposition of xml defined tracer | ART_DIAGNOSTICS, ART_ROUTINE_DIAG | Bq m-2 | wet deposition of xml defined tracer | lart_aerosol=True and iart_radioact=1 | |
| dry deposition of xml defined tracer | ART_DIAGNOSTICS, ART_ROUTINE_DIAG | Bq m-2 | dry deposition of xml defined tracer | lart_aerosol=True and iart_radioact=1 | ||
| Averaged air concentration of xml defined traer | ART_DIAGNOSTICS, ART_ROUTINE_DIAG | Bq m-3 | Averaged air concentration of xml defined traer | lart_aerosol=True and iart_radioact=1 | ||
| FPLUME Output | plume_height | ART_FPLUME | m | plume height | iart_fplume/=0 | |
| plume_MFR | ART_FPLUME | kg s-1 | plume MFR | iart_fplume/=0 | ||
| MER_transport | ART_FPLUME | kg s-1 | Amount of very fine ash for transport | iart_fplume/=0 | ||
| solution_with | ART_FPLUME | - | FPlume off, Mastin, or FPlume | iart_fplume/=0 |
