Changes between Version 2 and Version 3 of doc/app/iofiles/pids/chem

Timestamp:

Nov 20, 2019 3:53:35 PM (5 years ago)

Author:

ecchan

Comment:

--

doc/app/iofiles/pids/chem

@@ -1 +1 @@
 == [=#chem_input '''Chemistry input file'''] ==
 
-[[NoteBox(warn,'''Please note''' that input from chemistry input file is already implemented in PALM. A documentation will follow soon.)]]
+The chemistry input file contains information required to setup aerosol emissions.  The input data format varies depending on the level of detail (lod).  For chemistry settings, there are 
+three possibilities
+
+* '''LOD 0''' : This is known as '''parameterized''' mode.  All LOD 1 options are controlled from the namelist (_p3d file) alone and no chemistry data file is required
+
+* '''LOD 1''' : This is known as '''default''' mode, where localized emissions are estimated through annual mean values, as well as temporal, spatial and speciation profiles supplied by \the chemistry data file
+
+* '''LOD 2''' : This is known as '''pre-processed''' mode.  In this case the spatial and temporal emission levels are provided explicitly in the chemistry data file
+
+Please note that some of the below inputs are only required for LOD 1, while some others are common for both LOD 1 and LOD 2, but with slightly different specifications.
+
+||='''Variables'''  =||='''Type''' =||='''Explanation / Remarks'''  =||
+|----------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#emission_name '''emission_name''']\\
+(nspecies)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_CHAR(25)
+}}}
+{{{#!td
+List of all names of emitted species. The number of species (nspecies) varies depending on the employed chemistry scheme.\\
+
+''Coordinates''\\
+
+{{{nspecies}}}: number of emission species\\
+
+''Attributes''\\
+
+{{{long_name}}} char: emission species name\\
+{{{standard_name}}} char: emission name\\
+{{{units}}} char: empty string\\
+
+}}}
+|----------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#emission_index '''emission_index''']\\
+(nspecies)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_USHORT
+}}}
+{{{#!td
+Index of the emitted species\\
+
+''Coordinates''\\
+
+{{{nspecies}}} : number of emission species\\
+
+''Attributes''\\
+
+{{{long_name}}} char: "emission species name"\\
+{{{standard_name}}} char: "emission name"\\
+{{{units}}} char: empty string\\
+
+}}}
+|-------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#emission_values '''emission_values''']\\
+{{{lod = 1}}}(z,y,x,nspecies,ncat)\\
+{{{lod = 2}}}(dt_emission,z,y,x,nspecies)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_FLOAT
+}}}
+{{{#!td
+Index of the emitted species.\\
+
+''Coordinates''\\
+
+{{{dt_emission}}}: hourly time step (LOD=2 only)\\
+{{{z}}}: elevation[*] in m (LOD=2 only)\\
+{{{y}}}: northing in m\
+{{{x}}}: easting in m\\
+{{{nspecies}}}: emission values of the different emitted species\\
+{{{ncat}}}: number of emission categories (LOD=1 only)\\
+
+''Attributes''\\
+
+{{{lod}}} integer: 1 or 2\\
+{{{long_name}}} char: "emission species name"\\
+{{{standard_name}}} char: "emission name"\\
+{{{units}}} char: empty string\\
+{{{dt_emission}}} float: hourly interval (= 3600.0) between timesteps (LOD=2 only)\\
+{{{units}}} char: "kg/m2/year (LOD=1), "kg/m2/dt_emission" (LOD=2)\\
+{{{_FillValue}}} float: -9999.9f\\
+{{{coordinates}}} char: "E_UTM N_UTM lon lat"\\
+{{{grid_mapping}}} char: "crsUTM: E_UTM N_UTM crsETRS: lon lat"\\
+
+[*] Note the z dimension is retained for backward compatibility and contains only one level.  It is not used and will be depreciated in future releases.
+
+}}}
+|-------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#stack_height '''stack_height''']\\
+(y,x)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_FLOAT
+}}}
+{{{#!td
+Vertical position for elevated emission sources (stacks).\\
+
+''Coordinates''\\
+
+{{{y}}}: northing in m\\
+{{{x}}}: easting in m\\
+
+''Attributes''\\
+
+{{{long_name}}} char: "emission staack height"\\
+{{{standard_name}}} char: "emission_stack_height"\\
+{{{units}}} char: "m"\\
+{{{_FillValue}}} float: -9999.9f\\
+{{{coordinates}}} char: "E_UTM N_UTM lon lat"\\
+{{{grid_mapping}}} char: "crsUTM: E_UTM N_UTM crsETRS: lon lat"\\
+
+}}}
+|-------------
+
+The following variables are only required for LOD=1
+
+|-------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#emission_time_factors '''emission_time_factors''']\\
+(ncat, nmonthdayhour)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_FLOAT
+}}}
+{{{#!td
+Emission time scaling factors for emission_values.\\
+
+''Coordinates''\\
+
+{{{ncat}}}: number of mission categories\\
+{{{nmonthdayhour}}}: number of time scaling factors\\
+
+* '''1-12''' : scaling factor for the index month of the year (must be summed to 1)
+* '''13-19''' : scaling factor for the index day of the week (must be summed to 1)
+* '''20-43''' : scaling factor for the index day of the working day (must be summed to 1)
+* '''44-67''' : scaling factor for the index day of a Saturday (must be summed to 1)
+* '''68-91''' : scaling factor for the index day of a Sunday and public holiday (must be summed to 1)
+
+''Attributes''\\
+
+{{{lod}}} integer: 1\\
+{{{long_name}}} char: "emission time scaling factors"\\
+{{{standard_name}}} char: "emission_time_scaling_factors"\\
+{{{units}}} char: empty string\\
+
+}}}
+|-------------
+{{{#!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 inded of the emission quantity in question.\\
+
+''Coordinates''\\
+
+{{{ncat}}}: number of mission categories\\
+
+''Attributes''\\
+
+{{{long_name}}} char: "emission category index"\\
+{{{standard_name}}} char: "emission_cat_index"\\
+{{{units}}} char: empty string\\
+
+}}}
+|-------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#emission_category_name '''emission_category_name''']\\
+(ncat)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_CHAR(25)
+}}}
+{{{#!td
+Emission name for each category indicated in {{{emisison_category_index}}}.\\
+
+''Coordinates''\\
+
+{{{ncat}}}: number of mission categories\\
+
+''Attributes''\\
+
+{{{long_name}}} char: "emission category index"\\
+{{{standard_name}}} char: "emission_cat_index"\\
+{{{units}}} char: empty string\\
+
+}}}
+|-------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#emission_category_name '''emission_category_name''']\\
+(ncat)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_CHAR(25)
+}}}
+{{{#!td
+Emission name for each category indicated in {{{emisison_category_index}}}.\\
+
+''Coordinates''\\
+
+{{{ncat}}}: number of mission categories\\
+
+''Attributes''\\
+
+{{{long_name}}} char: "emission category name"\\
+{{{standard_name}}} char: "emission_cat_name"\\
+{{{units}}} char: empty string\\
+
+}}}
+|-------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#composition_nox '''composition_nox''']\\
+(ncat,1:2)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_FLOAT
+}}}
+{{{#!td
+Composition of species NOx (NO and NO2).  The sum under each {{{ncat}}} must be equal to one.\\
+
+''Coordinates''\\
+
+{{{ncat}}}: number of mission categories\\
+{{{1:2}}}: 1:NO, 2:NO2\\
+
+''Attributes''\\
+
+{{{long_name}}} char: "composition of NOx"\\
+{{{standard_name}}} char: "composition_nox"\\
+{{{units}}} char: empty string\\
+
+}}}
+|-------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#composition_sox '''composition_sox''']\\
+(ncat,1:2)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_FLOAT
+}}}
+{{{#!td
+Composition of species SOx (SO2 and SO4).  The sum under each {{{ncat}}} must be equal to one.\\
+
+''Coordinates''\\
+
+{{{ncat}}}: number of mission categories\\
+{{{1:2}}}: 1:SO2, 2:SO4\\
+
+''Attributes''\\
+
+{{{long_name}}} char: "composition of SOx"\\
+{{{standard_name}}} char: "composition_sox"\\
+{{{units}}} char: empty string\\
+
+}}}
+|-------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#emission_pm_name '''emission_pm_name''']\\
+(npm)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_CHAR(25)
+}}}
+{{{#!td
+List of all PM names.\\
+
+''Coordinates''\\
+
+{{{npm}}}: number of PM species\\
+
+''Attributes''\\
+
+{{{long_name}}} char: "PM name"\\
+{{{standard_name}}} char: "pm_name"\\
+{{{units}}} char: empty string\\
+
+}}}
+|-------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#composition_pm '''composition_pm''']\\
+(ncat,1:3)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_FLOAT
+}}}
+{{{#!td
+Composition of PM emission species (PM10, PM2.5, and PM1).  The sum under each {{{ncat}}} must be equal to one.\\
+
+''Coordinates''\\
+
+{{{ncat}}}: number of mission categories\\
+{{{1:2}}}: 1:PM10, 2:PM2.5, 3:PM1\\
+
+''Attributes''\\
+
+{{{long_name}}} char: "composition of PM"\\
+{{{standard_name}}} char: "composition_PM"\\
+{{{units}}} char: empty string\\
+
+}}}
+|-------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#emission_voc_name '''emission_voc_name''']\\
+(npm)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_CHAR(25)
+}}}
+{{{#!td
+List of all VOC names.\\
+
+''Coordinates''\\
+
+{{{npm}}}: number of PM species\\
+
+''Attributes''\\
+
+{{{long_name}}} char: "VOC name"\\
+{{{standard_name}}} char: "voc_name"\\
+{{{units}}} char: empty string\\
+
+}}}
+|-------------
+{{{#!td style="vertical-align:top;width: 150px"
+[=#composition_voc '''composition_voc''']\\
+(ncat,nvoc)
+}}}
+{{{#!td style="vertical-align:top;width: 50px"
+NC_FLOAT
+}}}
+{{{#!td
+Composition of VOC emission species.  The sum under each {{{ncat}}} must be equal to one.\\
+
+''Coordinates''\\
+
+{{{ncat}}}: number of mission categories\\
+{{{nvoc}}}: number of VOC species\\
+
+''Attributes''\\
+
+{{{long_name}}} char: "composition of PM"\\
+{{{standard_name}}} char: "composition_PM"\\
+{{{units}}} char: empty string\\
+
+}}}