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:

NAMELIST EXAMPLE
&output_nml
 filetype            =  4     ! output format: 2=GRIB2, 4=NETCDFv2
 dom                 =  1     ! write output for domain 1
 output_start        =  "JJJJ-MM-DDTHH:MM:SSZ" !put date in
 output_end          =  "JJJJ-MM-DDTHH:MM:SSZ" !put date in
 output_interval     =   "PT1H"  ! \href{ISO8601}{https://en.wikipedia.org/wiki/ISO_8601}  
 steps_per_file      =  1     ! max. num. of time steps within one file
 mode                =  1     ! 1: forecast mode (relative t-axis)
 include_last        = .TRUE. ! include the last time step
 output_filename     = '<INSERTFILENAME>' ! file name base
 ml_varlist          = 'seasa','seasb','seasc',
 'seasa0','seasb0','seasc0'
 remap               = 1      ! output is transferred to lat long grid
 reg_lon_def         = -180.,0.5,179.5   !start, incr., end, in deg.
 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 .

Finding the correct Mode description

The following table contains an overview of the possible output variables.

Currently there are two ways to specify Tracer in ICON-ART: The classical way and via AERODYN:

• Classical: : 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

Classical Tracer configurations

	dust	seasalt	ash	soot
a	dusta	seasa	asha	soota
b	dustb	seasb	ashb	sootb
c	dustc	seasc	ashc	sootc

• Using 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

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

Output Overview

	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