== [=#chem_input '''Chemistry input file'''] ==

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''']\\
(nvoc)
}}}
{{{#!td style="vertical-align:top;width: 50px"
NC_CHAR(25)
}}}
{{{#!td
List of all VOC names.\\

''Coordinates''\\

{{{nvoc}}}: number of VOC 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\\

}}}