Changes between Version 91 and Version 92 of doc/app/iofiles/pids

Timestamp:

Jun 3, 2019 2:14:38 PM (6 years ago)

Author:

monakurppa

Comment:

Added information on aerosol module input data.

doc/app/iofiles/pids

@@ -3 +3 @@
 PALM provides a standardized way via the NetCDF data format to input e.g. global attributes, topography data or surface properties, vegetation properties, etc., as well as initialization data and boundary conditions for the prognostic variables. 
 
-Input variables are distinguished between [#static_input static], [#dynamic_input dynamic], [#rad_input radiation] and [#chem_input chemistry] input variables, while for each a separate input file exists. 
+Input variables are distinguished between [#static_input static], [#dynamic_input dynamic], [#rad_input radiation], [#chem_input chemistry] and [#salsa_input aerosol] input variables, while for each a separate input file exists. 
 The static input file, indicated by the filename suffix _STATIC, contains all static information, such as topography, geographical latitude and longitude, surface and vegetation information. 
 The dynamic input file, indicated by the filename suffix _DYNAMIC, contains dynamic information on the initial state of the atmosphere or time-dependent boundary conditions. 
 The radiation input file, indicated by suffix _RAD, contains static and dynamic information on radiation properties such as trace gas profiles or sky-view factors. 
-The chemistry input file, indicated by suffix _CHEM, contains static and dynamic information on chemical species and emissions.  
+The chemistry input file, indicated by suffix _CHEM, contains static and dynamic information on chemical species and emissions.
+The aerosol input file, indicated by suffix _SALSA (from the [../../salsa aerosol module] name "SALSA"),contains aerosol emission information.
 
 An example NCL-script to create a simple [[attachment:example_static|static input file]] can be found 
@@ -721 +722 @@
 {{{lod=2}}}: Initial volume data of any further species. 
 
-Input of this quantity becomes only effective if the [../../chempar chemistry model] is switched on. Please note, this quantity is currently not provided by [#inifor inifor].  
+Input of this quantity becomes only effective if the [../../chempar chemistry model] is switched on. Please note, this quantity is currently not provided by [#inifor inifor]. 
+}}}
+|----------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#init_atmosphere_aerosol '''init_atmosphere_aerosol''']//
+(z,Dmid)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_FLOAT
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+1
+}}}
+{{{#!td
+{{{lod=1}}}: Initial profile of aerosol number concentration per aerosol size bin (# m^-3^). The bin mean diameter ''Dmid'' given in nm. //
+
+Input of this quantity becomes only effective if the [../../../tec/aerosol aerosol module SALSA] is switched on. Please note, this quantity is currently not provided by [#inifor inifor].  
+}}}
+|----------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#init_atmosphere_mass_fracs_a '''init_atmosphere_mass_fracs_a''']//
+(z,composition_index)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_FLOAT
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+1
+}}}
+{{{#!td
+Vertical profile of the mass fractions of background/initial aerosol concentration: subrange a.
+
+Input of this quantity becomes only effective if the [../../../tec/aerosol aerosol module SALSA] is switched on. Please note, this quantity is currently not provided by [#inifor inifor].  
+}}}
+|----------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#composition_name '''composition_name''']//
+(composition_index,max_string_length)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_CHAR
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+
+}}}
+{{{#!td
+List of chemical components of aerosol particles. 
 }}}
 |----------------
@@ -1147 +1194 @@
 |----------------
 {{{#!td style="vertical-align:top;width: 150px"
-[=#ls_forcing_front_pt '''ls_forcing_front_pt''']//
+[=#ls_forcing_south_pt '''ls_forcing_south_pt''']//
 (time,z)
 }}}
@@ -1162 +1209 @@
 |----------------
 {{{#!td style="vertical-align:top;width: 150px"
-[=#ls_forcing_front_qv '''ls_forcing_front_qv''']//
+[=#ls_forcing_south_qv '''ls_forcing_south_qv''']//
 (time,z)
 }}}
@@ -1177 +1224 @@
 |----------------
 {{{#!td style="vertical-align:top;width: 150px"
-[=#ls_forcing_front_u '''ls_forcing_front_u''']//
+[=#ls_forcing_south_u '''ls_forcing_south_u''']//
 (time,z)
 }}}
@@ -1192 +1239 @@
 |----------------
 {{{#!td style="vertical-align:top;width: 150px"
-[=#ls_forcing_front_v '''ls_forcing_front_v''']//
+[=#ls_forcing_south_v '''ls_forcing_south_v''']//
 (time,z)
 }}}
@@ -1207 +1254 @@
 |----------------
 {{{#!td style="vertical-align:top;width: 150px"
-[=#ls_forcing_front_w '''ls_forcing_front_w''']//
+[=#ls_forcing_south_w '''ls_forcing_south_w''']//
 (time,z)
 }}}
@@ -1222 +1269 @@
 |----------------
 {{{#!td style="vertical-align:top;width: 150px"
-[=#ls_forcing_back_pt '''ls_forcing_back_pt''']//
+[=#ls_forcing_north_pt '''ls_forcing_north_pt''']//
 (time,z)
 }}}
@@ -1237 +1284 @@
 |----------------
 {{{#!td style="vertical-align:top;width: 150px"
-[=#ls_forcing_back_qv '''ls_forcing_back_qv''']//
+[=#ls_forcing_north_qv '''ls_forcing_north_qv''']//
 (time,z)
 }}}
@@ -1252 +1299 @@
 |----------------
 {{{#!td style="vertical-align:top;width: 150px"
-[=#ls_forcing_back_u '''ls_forcing_back_u''']//
+[=#ls_forcing_north_u '''ls_forcing_north_u''']//
 (time,z)
 }}}
@@ -1267 +1314 @@
 |----------------
 {{{#!td style="vertical-align:top;width: 150px"
-[=#ls_forcing_back_v '''ls_forcing_back_v''']//
+[=#ls_forcing_north_v '''ls_forcing_north_v''']//
 (time,z)
 }}}
@@ -1282 +1329 @@
 |----------------
 {{{#!td style="vertical-align:top;width: 150px"
-[=#ls_forcing_back_w '''ls_forcing_back_w''']//
+[=#ls_forcing_north_w '''ls_forcing_north_w''']//
 (time,z)
 }}}
@@ -1445 +1492 @@
 
 \\\\
+
+== [=#salsa_input '''Aerosol input file'''] ==
+
+The aerosol input file contains information needed to setup aerosol emissions. Aerosol emission value can be given applying two alternative level of detail (lod): 1 or 2. See [../../../tec/aerosol aerosol module documentation] for further details.
+
+||='''Variables'''  =||='''Type''' =||='''Explanation / Remarks'''  =||
+|----------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#aerosol_emission_values '''aerosol_emission_values''']//
+((time),y,x,(Dmid),(ncat))
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_FLOAT
+}}}
+{{{#!td
+Emission values of aerosol particles per size bin. The coordinates vary based on the chosen level of detail.\\
+
+{{{lod=1}}}: Emissions are provided per emission category and yearly as total PM in dimensions {{{aerosol_emission_values(y,x,ncat)}}}. They are then scaled by pre-defined rescaling factors '''emission_time_factors'''. Default categories are ''traffic exhaust'', ''road dust'', ''wood combustion'', ''other''.//
+
+{{{lod=2}}}: Emissions are provided per aerosol size bin for each surface point in space and at given points in time in dimensions {{{aerosol_emission_values(time,y,x,Dmid)}}} and in units # m^-2^ s^-1^. The bin mean diameter ''Dmid'' given in nm. 
+}}}
+|----------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#composition_name '''composition_name''']//
+(composition_index,max_string_length)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_CHAR
+}}}
+{{{#!td
+List of chemical components of aerosol particles. 
+}}}
+|----------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#emission_category_index '''emission_category_index''']//
+(ncat)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_BYTE
+}}}
+{{{#!td
+Category index of the emission quantity in question (e.g. 1 = traffic emissions). {{{lod=1}}} only.
+}}}
+|----------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#emission_category_name '''emission_category_name''']//
+(ncat,max_string_length)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_CHAR
+}}}
+{{{#!td
+Emission categories names (match to emission_category_index of the same index element). {{{lod=1}}} only.
+}}}
+|----------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#emission_mass_fracs '''emission_mass_fracs''']//
+((ncat),composition_index)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_FLOAT
+}}}
+{{{#!td
+Mass fractions of chemical components in aerosol emissions.
+}}}
+|----------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#emission_time_factors '''emission_time_factors''']//
+(ncat,(nhoursyear),(nmonthdayhour)) 
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_FLOAT
+}}}
+{{{#!td
+Emission time scaling factors for emission_values ({{{lod=1}}}). Two different time factors are possible: 1) Scaling according to month‑day‑hour classification ({{{emission_time_factors(ncat,nmonthdayhour)}}}), or scaling for each hour of the year ({{{emission_time_factors(ncat,nhoursyear)}}}).
+}}}
+
+\\\\
+
 == [=#virtual_measurement_input '''Virtual measurement input file'''] ==