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
emission_name (nspecies)	NC_CHAR(25)	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
emission_index (nspecies)	NC_USHORT	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
emission_values lod = 1(z,y,x,nspecies,ncat) lod = 2(dt_emission,z,y,x,nspecies)	NC_FLOAT	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.
stack_height (y,x)	NC_FLOAT	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

emission_time_factors (ncat, nmonthdayhour)	NC_FLOAT	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
emission_category_index (ncat)	NC_BYTE	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
emission_category_name (ncat)	NC_CHAR(25)	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
emission_category_name (ncat)	NC_CHAR(25)	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
composition_nox (ncat,1:2)	NC_FLOAT	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
composition_sox (ncat,1:2)	NC_FLOAT	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
emission_pm_name (npm)	NC_CHAR(25)	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
composition_pm (ncat,1:3)	NC_FLOAT	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
emission_voc_name (nvoc)	NC_CHAR(25)	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
composition_voc (ncat,nvoc)	NC_FLOAT	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