AERODYN - Revision history

Admin 3: /* Aerosol Modes in AERODYN */

2026-02-25T12:54:47Z

Aerosol Modes in AERODYN

← Older revision		Revision as of 14:54, 25 February 2026
Line 27:		Line 27:
	\|-		\|-
	! mixed		! mixed
	\| mixed_ait \|\|mixed_acc \|\| mixed_coa \|\| ~~mixed_giant~~		\| mixed_ait \|\|mixed_acc \|\| mixed_coa \|\|
	\|-		\|-
	\|}		\|}

Admin 3: /* Aerosol Modes in AERODYN */

2026-02-25T12:53:10Z

Aerosol Modes in AERODYN

← Older revision		Revision as of 14:53, 25 February 2026
Line 21:		Line 21:
	\|-		\|-
	! soluble		! soluble
	\| ~~sol_aitken~~ \|\| sol_acc \|\| ~~sol_coarse~~ \|\| sol_giant		\| sol_ait \|\| sol_acc \|\| sol_coa \|\| sol_giant
	\|-		\|-
	! insoluble		! insoluble
	\|~~insol_aitken~~ \|\| insol_acc \|\| ~~insol_coarse~~ \|\| insol_giant		\|insol_ait \|\| insol_acc \|\| insol_coa \|\| insol_giant
	\|-		\|-
	! mixed		! mixed
	\| ~~mixed_aitken~~ \|\|mixed_acc \|\| ~~mixed_coarse~~ \|\| mixed_giant		\| mixed_ait \|\|mixed_acc \|\| mixed_coa \|\| mixed_giant
	\|-		\|-
	\|}		\|}

Luca R: syntaxhighlight for xmls

2023-08-09T08:41:54Z

syntaxhighlight for xmls

← Older revision		Revision as of 10:41, 9 August 2023
Line 91:		Line 91:
	<div class="toccolours mw-collapsible mw-collapsed">		<div class="toccolours mw-collapsible mw-collapsed">
	==== Example File of tracers.xml: ====		==== Example File of tracers.xml: ====
	<~~pre~~ class="mw-collapsible-content">		<syntaxhighlight class="mw-collapsible-content" lang=xml line>
	<tracers>		<tracers>
	<aerosol id="nmb">		<aerosol id="nmb">
Line 136:		Line 136:
	</aerosol>		</aerosol>
	</tracers>		</tracers>
			</syntaxhighlight>
	</pre>
	</div>		</div>

Line 185:		Line 185:
	<div class="toccolours mw-collapsible mw-collapsed">		<div class="toccolours mw-collapsible mw-collapsed">
	==== Example File of modes.xml: ====		==== Example File of modes.xml: ====
	<~~pre~~ class="mw-collapsible-content">		<syntaxhighlight class="mw-collapsible-content" lang=xml line>
	<modes>		<modes>
	<aerosol id="sol_acc">		<aerosol id="sol_acc">
Line 232:		Line 232:
	</aerosol>		</aerosol>
	</modes>		</modes>
			</syntaxhighlight>
	</pre>
	</div>		</div>

Line 260:		Line 260:
	<div class="toccolours mw-collapsible mw-collapsed">		<div class="toccolours mw-collapsible mw-collapsed">
	==== Example File of coag.xml: ====		==== Example File of coag.xml: ====
	<~~pre~~ class="mw-collapsible-content">		<syntaxhighlight class="mw-collapsible-content" lang=xml line>
	<coagulate>		<coagulate>
	<smallmode id="sol_acc">		<smallmode id="sol_acc">
Line 302:		Line 302:
	</smallmode>		</smallmode>
	</coagulate>		</coagulate>
			</syntaxhighlight>
	</pre>
	</div>		</div>
	=== Defining the Model Output ===		=== Defining the Model Output ===
Line 310:		Line 310:
	<div class="toccolours mw-collapsible mw-collapsed">		<div class="toccolours mw-collapsible mw-collapsed">
	==== Example File of diagnostics.xml: ====		==== Example File of diagnostics.xml: ====
	<~~pre~~ class="mw-collapsible-content">		<syntaxhighlight class="mw-collapsible-content" lang=xml line>
	<diagnostics>		<diagnostics>
	<aerosol id="diam_insol_acc">		<aerosol id="diam_insol_acc">
Line 340:		Line 340:
	</aerosol>		</aerosol>
	</diagnostics>		</diagnostics>
			</syntaxhighlight>
	</pre>
	</div>		</div>
	=== Defining the Aerosol Emissions ===		=== Defining the Aerosol Emissions ===
Line 375:		Line 375:
	<div class="toccolours mw-collapsible mw-collapsed">		<div class="toccolours mw-collapsible mw-collapsed">
	==== Example File of aero_emiss.xml: ====		==== Example File of aero_emiss.xml: ====
	<~~pre~~ class="mw-collapsible-content">		<syntaxhighlight class="mw-collapsible-content" lang=xml line>
	<emiss>		<emiss>
	<routine id="dust">		<routine id="dust">
Line 408:		Line 408:
	</routine>		</routine>
	</emiss>		</emiss>
			</syntaxhighlight>
	</pre>
	</div>		</div>

Luca R: /* Defining Tracers */ added Julias comment about moment

2023-07-13T07:54:39Z

Defining Tracers: added Julias comment about moment

← Older revision		Revision as of 09:54, 13 July 2023
Line 66:		Line 66:
	\|-		\|-
	! moment		! moment
			\| int \|\| this is the moment of the log-normal distribution (0 for number concentration and 3 for mass mixing ratio)\|\| 3
	\| int \|\| specifies which momentum scheme is used (???) \|\| 3
	\|-		\|-
	! mode		! mode
Line 138:		Line 138:
	</pre>		</pre>
	</div>		</div>


	=== Defining Modes ===		=== Defining Modes ===

Editor 2: made the expanding xml examples more intuitive

2023-06-07T08:08:00Z

made the expanding xml examples more intuitive

← Older revision		Revision as of 10:08, 7 June 2023
Line 89:		Line 89:


		⚫	<div class="toccolours mw-collapsible mw-collapsed">

	==== tracers.xml ====		==== Example File of tracers.xml: ====
	<pre class="mw-collapsible mw-~~collapsed~~">		<pre class="mw-collapsible-content">
	<tracers>		<tracers>
	<aerosol id="nmb">		<aerosol id="nmb">
Line 137:		Line 137:
	</tracers>		</tracers>
	</pre>		</pre>
			</div>


Line 183:		Line 184:


		⚫	<div class="toccolours mw-collapsible mw-collapsed">

	==== modes.xml ====		==== Example File of modes.xml: ====
	<pre class="mw-collapsible mw-~~collapsed~~">		<pre class="mw-collapsible-content">
	<modes>		<modes>
	<aerosol id="sol_acc">		<aerosol id="sol_acc">
Line 233:		Line 234:
	</modes>		</modes>
	</pre>		</pre>
			</div>


	=== Defining Coagulation ===		=== Defining Coagulation ===
Line 258:		Line 259:


		⚫	<div class="toccolours mw-collapsible mw-collapsed">
	==== coag.xml ====		==== Example File of coag.xml: ====
⚫	<~~pre~~ class="mw-collapsible mw-collapsed">
			<pre class="mw-collapsible-content">
	<coagulate>		<coagulate>
	<smallmode id="sol_acc">		<smallmode id="sol_acc">
Line 302:		Line 304:
	</coagulate>		</coagulate>
	</pre>		</pre>
			</div>

	=== Defining the Model Output ===		=== Defining the Model Output ===
	In the diagnostics.xml the diagnostic variables that can be written out are defined. Below are some examples, however this is a heavily shortened version of the diagnostics.xml used in ICON-ART.		In the diagnostics.xml the diagnostic variables that can be written out are defined. Below are some examples, however this is a heavily shortened version of the diagnostics.xml used in ICON-ART.


			<div class="toccolours mw-collapsible mw-collapsed">

		⚫	==== Example File of diagnostics.xml: ====

			<pre class="mw-collapsible-content">
⚫	==== diagnostics.xml ====
⚫	<~~pre~~ class="mw-collapsible mw-collapsed">
	<diagnostics>		<diagnostics>
	<aerosol id="diam_insol_acc">		<aerosol id="diam_insol_acc">
Line 341:		Line 342:
	</diagnostics>		</diagnostics>
	</pre>		</pre>
			</div>

	=== Defining the Aerosol Emissions ===		=== Defining the Aerosol Emissions ===

Line 373:		Line 374:


			<div class="toccolours mw-collapsible mw-collapsed">
	====aero_emiss.xml====		==== Example File of aero_emiss.xml: ====
⚫	<~~pre~~ class="mw-collapsible mw-collapsed">
			<pre class="mw-collapsible-content">
	<emiss>		<emiss>
	<routine id="dust">		<routine id="dust">
Line 408:		Line 410:
	</emiss>		</emiss>
	</pre>		</pre>
			</div>

Editor 2: Made .xml code samples collapsible as well as collapsed in their basic state

2023-05-25T07:00:37Z

Made .xml code samples collapsible as well as collapsed in their basic state

← Older revision		Revision as of 09:00, 25 May 2023
Line 88:		Line 88:



	<pre>

			==== tracers.xml ====
			<pre class="mw-collapsible mw-collapsed">
	<tracers>		<tracers>
	<aerosol id="nmb">		<aerosol id="nmb">
Line 134:		Line 137:
	</tracers>		</tracers>
	</pre>		</pre>



Line 179:		Line 181:



	<pre>


			==== modes.xml ====
			<pre class="mw-collapsible mw-collapsed">
	<modes>		<modes>
	<aerosol id="sol_acc">		<aerosol id="sol_acc">
Line 249:		Line 255:
	\|}		\|}


	<pre>


			==== coag.xml ====
			<pre class="mw-collapsible mw-collapsed">
	<coagulate>		<coagulate>
	<smallmode id="sol_acc">		<smallmode id="sol_acc">
Line 296:		Line 306:
	In the diagnostics.xml the diagnostic variables that can be written out are defined. Below are some examples, however this is a heavily shortened version of the diagnostics.xml used in ICON-ART.		In the diagnostics.xml the diagnostic variables that can be written out are defined. Below are some examples, however this is a heavily shortened version of the diagnostics.xml used in ICON-ART.


	<pre>


			==== diagnostics.xml ====
			<pre class="mw-collapsible mw-collapsed">
	<diagnostics>		<diagnostics>
	<aerosol id="diam_insol_acc">		<aerosol id="diam_insol_acc">
Line 358:		Line 372:
	\|}		\|}


	<pre>
			====aero_emiss.xml====
			<pre class="mw-collapsible mw-collapsed">
	<emiss>		<emiss>
	<routine id="dust">		<routine id="dust">

Editor 2: Added explainations and references for Condensation, Nucleation and coagulation

2023-05-03T11:46:49Z

Added explainations and references for Condensation, Nucleation and coagulation

← Older revision		Revision as of 13:46, 3 May 2023
Line 10:		Line 10:
	Since condensation can occur on a solid aerosol particle, as well as for a number of other reasons, it is possible to obtain aerosol modes which are a mixture of solid and liquid modes. To account for this, AERODYN combines 4 modes of aerosol size with the 3 modes soluble, insoluble and mixed.		Since condensation can occur on a solid aerosol particle, as well as for a number of other reasons, it is possible to obtain aerosol modes which are a mixture of solid and liquid modes. To account for this, AERODYN combines 4 modes of aerosol size with the 3 modes soluble, insoluble and mixed.
	A Visual Representation is given here:		A Visual Representation is given here:

	[[File:AERODYNModes.png]]		[[File:AERODYNModes.png]]

Line 29:		Line 30:
	\|-		\|-
	\|}		\|}

			== Condensation, Nucleation and Accumulation Processes ==
			Here is a quick reminder of the different aerosol processes:

			* Condensation is the process of a gas turning into a liquid. In practice, some sort of surface, or condensation nucleus is needed to enable the phase change.
			* Nucleation is the process of an aerosol particle forming from a gaseous phase by random collisions of the gas molecules. The produced aerosol sizes are in the Aitken mode.
			* Accumulation in the Process of the initial nucleus growing in size through collision and deposition Processes.

			A schematic overview of the different microphysical aerosol processes can be found in the following Figure from [https://doi.org/10.1016/S1352-2310(00)00239-9 Raes et. Al(2000)]:

			[[File:Raes2000.jpg\| Overview of Aerosol Processes.]]


			In AERODYN, some modes are treated differently with respect to the dynamic processes: Nucleation is only considered for the Aitken mode, and the Giant mode is not affected by condensation. This is done to save computing power while still retaining realism, and since Nucleation of larger Particles without first having Aitken mode Aerosols is highly unlikely, this is a good approximation. Also, as condensation highly prefers smaller modes to the giant mode, this also is a reasonable way to save computing power. For details how the processes are calculated, see [https://doi.org/10.1029/2018RG000615 Riemer et Al. (2003)] and [https://doi.org/10.5194/acp-9-8661-2009 Vogel et. Al. (2009)].

	== Defining Aerosols with AERODYN ==		== Defining Aerosols with AERODYN ==

Editor 2: fixed some typos

2023-04-18T11:41:58Z

fixed some typos

← Older revision		Revision as of 13:41, 18 April 2023
Line 1:		Line 1:
	AERODYN (AEROsol DYNamics) is a new aerosol dynamics module used in ICON-ART. With AERODYN, secondary aerosol formations (e.g. the accumulation of SO2 on a volcanic ash particle) can be accounted for.		AERODYN (AEROsol DYNamics) is a new aerosol dynamics module used in ICON-ART. With AERODYN, secondary aerosol formations (e.g. the accumulation of SO2 on a volcanic ash particle) can be accounted for.
	Aerosol dynamic processes are the processes which change an aerosols properties after it has been released into the atmosphere. This change of properties (omitting chemical reactions) occurs either via condensation or coagulation.		Aerosol dynamic processes are the processes which change an aerosols properties after it has been released into the atmosphere. This change of properties (omitting chemical reactions) occurs either via condensation or coagulation.
	Since it is not feasible to account for every individual aerosol to calculate their movement, AERODYN uses a total of 12 categories for aerosol modes.		Since it is not feasible to account for every individual aerosol to calculate their movement, coagulation and condensation, AERODYN uses a total of 12 categories for aerosol modes.


Line 40:		Line 40:
	=== Defining Tracers ===		=== Defining Tracers ===

	Below is ~~ther~~ tracers.xml, where the aerosols as well as their properties are defined. The properties to be defined are listed in the following table.		Below is the tracers.xml, where the aerosols as well as their properties are defined. The properties to be defined are listed in the following table.


Line 125:		Line 125:
	=== Defining Modes ===		=== Defining Modes ===

	In the modes.xml the modes ~~whiche~~ are going to be used in the simulation can be defined. The following .xml contains the same information as Figure 3.1, but in a way the computer can interpret it.		In the modes.xml the modes which are going to be used in the simulation can be defined. The following .xml contains the same information as Figure 3.1, but in a way the computer can interpret it.

	<div id="OutputTable"></div>		<div id="OutputTable"></div>
Line 162:		Line 162:


	Sometimes it is necessary for the type of an aerosol to change its given mode if its diameter gets too large ~~ore~~ a large amount of condensation occurs. The mass can then be ~~trensferred~~ to defined modes, as seen in the table above.		Sometimes it is necessary for the type of an aerosol to change its given mode if its diameter gets too large or a large amount of condensation occurs. The mass can then be transferred to defined modes, as seen in the table above.

Editor 2: /* Defining Aerosols with AERODYN */ added a lot of detailabout the individual AERODYN .xml's

2023-04-17T11:55:49Z

Defining Aerosols with AERODYN: added a lot of detailabout the individual AERODYN .xml's

Show changes

Editor 2: Created first draft of Page

2023-04-04T10:57:28Z

Created first draft of Page

New page

AERODYN (AEROsol DYNamics) is a new aerosol dynamics module used in ICON-ART. With AERODYN, secondary aerosol formations (e.g. the accumulation of SO2 on a volcanic ash particle) can be accounted for.
Aerosol dynamic processes are the processes which change an aerosols properties after it has been released into the atmosphere. This change of properties (omitting chemical reactions) occurs either via condensation or coagulation.
Since it is not feasible to account for every individual aerosol to calculate their movement, AERODYN uses a total of 12 categories for aerosol modes.

== Aerosol Modes in AERODYN ==

Traditionally, There are three categories to account for the aerosol sizes [https://www.sciencedirect.com/science/article/abs/pii/0004698178901968 Whitby et. Al. (1978)] : Aitken mode, accumulation mode and coarse mode. In AERODYN there is also a fourth mode, called giant mode, which accounts for especially large Aerosols, e.g. some species of pollen.

Since condensation can occur on a solid aerosol particle, as well as for a number of other reasons, it is possible to obtain aerosol modes which are a mixture of solid and liquid modes. To account for this, AERODYN combines 4 modes of aerosol size with the 3 modes soluble, insoluble and mixed.
A Visual Representation is given here:
[[File:AERODYNModes.png]]

when also adding the giant mode, the following configurations are possible:

<div id="OutputTable"></div>
::{| class="wikitable" style="text-align:left;"
|+ 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
|-
|}

== Defining Aerosols with AERODYN ==

AERODYN is meant to be as flexible as possible, allowing the user to quickly define their own aerosols and then use ICON-ART to simulate their dynamics.
Aerosols are defined in .xml files, which can then be included in the run by specifying their path in the runfile (see [[Input]] for more details)

<div id="OutputTable"></div>
::{| class="wikitable" style="text-align:left;"
|+ AERODYN XML Parameters
! Parameter || type || description || example
|-
! aerosol id
| char ||specifies name of the aerosol || "my_first_aerosol"
|-
! moment
| int || specifies which momentum scheme is used (???) || 3
|-
! mode
| char || mode name from AERODYN mode configurations (multiple modes can be given, seperated by a comma) || insol_giant,sol_aitken
|-
! unit
| char || specify what unit the aerosol will have || kg-1
|-
! mol_weight
| real || specify the molar mass || 30E-3
|-
! rho
| real || specify the density in terms of <code> unit </code> || 2e3
|-
! ...
|}