|
|
|
# Emission configuration file
|
|
|
|
The emission configuration file allows the user to select the base emission inventories, pollutant sectors and species to combine and overlay for their simulations, as well as the corresponding temporal, vertical and speciation profiles and scaling and masking factors.
|
|
|
|
|
|
|
|
Each line of the emission configuration file belongs to a specific emission inventory-pollutant sector-pollutant specie group (e.g. HTAPv2-transport-co). The definition of pollutant sectors and pollutant species is restricted to the format in which the original emission inventories are reported.
|
|
|
|
|
|
|
|
For each one of the emission inventory-pollutant sector-pollutant specie groups, the user can define:
|
|
|
|
* Country-specific scaling factors that multiply original emissions
|
|
|
|
* Country-specific masks that restrict the applicability of the original inventory to a given region
|
|
|
|
* A vertical profile to distribute original emissions across the vertical layers defined in the [vertical description](examples_vertical_description.md)
|
|
|
|
* Fixed or gridded temporal profiles to disaggregated original emissions to the monthly, weekly, daily and hourly level
|
|
|
|
* A speciation profile to remap original pollutants species to a specific chemical mechanism
|
|
|
|
|
|
|
|
## Example
|
|
|
|
|
|
|
|
```text
|
|
|
|
ei;sector;ref_year;active;factor_mask;regrid_mask;pollutants;path;frequency;source_type;coverage;p_vertical;p_month;p_week;p_hour;p_speciation;p_day
|
|
|
|
GFASv12;;2015;1;;;co,nox_no,pm25,oc,bc,so2,ch3oh,c2h5oh,c3h8,c2h4,c3h6,c5h8,terpenes,hialkenes,hialkanes,ch2o,c2h4o,c3h6o,nh3,c2h6s,c2h6,c7h8,c6h6,c8h10,c4h8,c5h10,c6h12,c8h16,c4h10,c5h12,c6h14,c7h16;<data_path>/ecmwf/gfas/daily_mean;daily;point;global;method=sovief,approach=uniform;;;H001;E001;
|
|
|
|
HTAPv2;energy;2010;1;;;co,nox_no2,pm10,pm25,oc,bc,so2,nh3,voc01,voc02,voc03,voc04,voc05,voc06,voc07,voc08,voc09,voc12,voc13,voc14,voc15,voc16,voc17,voc21,voc22,voc23,voc24;<data_path>/jrc/htapv2/monthly_mean;monthly;area;global;V001;;W002;H002;E002;
|
|
|
|
HTAPv2;industry;2010;1;;;co,nox_no2,pm10,pm25,oc,bc,so2,nh3,voc01,voc02,voc03,voc04,voc05,voc06,voc07,voc08,voc09,voc12,voc13,voc14,voc15,voc16,voc17,voc18,voc19,voc20,voc21,voc22,voc23,voc24;<data_path>/jrc/htapv2/monthly_mean;monthly;area;global;V002;;W003;H004;E003;
|
|
|
|
HTAPv2;residential;2010;1;;;co,nox_no2,pm10,pm25,oc,bc,so2,nh3,voc01,voc02,voc03,voc04,voc05,voc06,voc07,voc08,voc09,voc12,voc13,voc14,voc15,voc16,voc17,voc19,voc21,voc22,voc23,voc24;<data_path>/jrc/htapv2/monthly_mean;monthly;area;global;;;W003;H003;E004;
|
|
|
|
HTAPv2;transport;2010;1;;;co,nox_no2,pm10,pm25,oc,bc,so2,nh3,voc02,voc03,voc04,voc05,voc06,voc07,voc08,voc09,voc12,voc13,voc14,voc15,voc16,voc17,voc21,voc22,voc23;<data_path>/jrc/htapv2/monthly_mean;monthly;area;global;;;W005;weekday=H006, saturday=H009, sunday=H010;E005;
|
|
|
|
HTAPv2;agriculture;2010;1;;;nh3;<data_path>/jrc/htapv2/monthly_mean;monthly;area;global;;;W001;H007;E006;
|
|
|
|
HTAPv2;air_lto;2010;1;;;co,nox_no2,pm10,pm25,oc,bc,so2,voc02,voc03,voc05,voc06,voc07,voc08,voc09,voc12,voc13,voc14,voc15,voc17,voc21,voc22,voc23;<data_path>/jrc/htapv2/yearly_mean;yearly;area;global;V003;M001;W001;H001;E007;
|
|
|
|
HTAPv2;air_cds;2010;1;;;co,nox_no2,pm10,pm25,oc,bc,so2,voc02,voc03,voc05,voc06,voc07,voc08,voc09,voc12,voc13,voc14,voc15,voc17,voc21,voc22,voc23;<data_path>/jrc/htapv2/yearly_mean;yearly;area;global;V004;M001;W001;H001;E007;
|
|
|
|
HTAPv2;air_crs;2010;1;;;co,nox_no2,pm10,pm25,oc,bc,so2,voc02,voc03,voc05,voc06,voc07,voc08,voc09,voc12,voc13,voc14,voc15,voc17,voc21,voc22,voc23;<data_path>/jrc/htapv2/yearly_mean;yearly;area;global;V005;M001;W001;H001;E007;
|
|
|
|
HTAPv2;ships;2010;1;;;co,nox_no2,pm10,pm25,oc,bc,so2,voc01,voc02,voc03,voc04,voc05,voc06,voc07,voc08,voc09,voc12,voc13,voc14,voc15,voc16,voc17,voc18,voc19,voc21,voc22,voc23,voc24;<data_path>/jrc/htapv2/yearly_mean;yearly;area;global;;M001;W001;H001;E008;
|
|
|
|
wiedinmyer;;2010;1;;;bc,c2h2,c2h4,c3h6,c6h6,ch2o,ch3cooh,ch3oh,co,hcl,nh3,nox_no,oc,pm10,pm25,so2;<data_path>/ucar/wiedinmyer/yearly_mean;yearly;area;global;;M001;W001;H008;E009;
|
|
|
|
carn;;2015;1;;;so2;<data_path>/mtu/carnetal/yearly_mean;yearly;point;global;;M001;W001;H001;E086;
|
|
|
|
```
|
|
|
|
|
|
|
|
## Columns
|
|
|
|
|
|
|
|
| **Option** | **Details** |
|
|
|
|
| :--------: | :----- |
|
|
|
|
| _ei_ | Name of the emission inventory. Currently available emission inventories are: [HTAPv2](https://www.atmos-chem-phys.net/15/11411/2015/acp-15-11411-2015.html), [GFASv12](https://www.biogeosciences.net/9/527/2012/bg-9-527-2012.pdf), [ECLIPSEv5a](http://www.iiasa.ac.at/web/home/research/researchPrograms/air/ECLIPSEv5a.html), [Wiedinmyer](https://pubs.acs.org/doi/abs/10.1021/es502250z), [TNO_MACC_III](https://www.atmos-chem-phys.net/14/10963/2014/acp-14-10963-2014.pdf), [EMEP](http://www.ceip.at/new_emep-grid/01_grid_data_2015). A short description of each emission inventory is available [here](../user_guide/user_guide_emission_inventories). Additional emission inventories can be added on request. |
|
|
|
|
| _sector_ | Pollutant sector name for each [emission inventory](../user_guide/user_guide_emission_inventories). Not needed for GFAS12 and Wiedinmyer. |
|
|
|
|
| _ref_year_ | Reference year for each [emission inventory](../user_guide/user_guide_emission_inventories). Not needed for GFASv12. |
|
|
|
|
| _active_ | **0**: Do not use the emission inventory. |
|
|
|
|
| | **1**: Use the emission inventory. |
|
|
|
|
| _factor_mask_ | [**OPTIONAL**] This parameter allow the user to define country-specific scaling factors that multiply the original emissions. (More details below) |
|
|
|
|
| _regrid_mask_ | [**OPTIONAL**] This parameter allow the user to define country-specific masks that restrict the applicability of the original emissions to the defined region. (More details below) |
|
|
|
|
| _pollutants_ | List of pollutants to take into account for each [emission inventory](../user_guide/user_guide_emission_inventories). |
|
|
|
|
| _path_ | Path to the folder that contains the emission inventory files. HERMESv3_GR will complete the path with the "\<pollutant_sector>" folder and the "\<pollutant_date>.nc" file name taking into account the information provided by fields _sector_, _pollutants_ and _ref_year_. The "\<data_path>" string will be replaced with the data_path option of the configuration file. |
|
|
|
|
| _frequency_ | **yearly**: Applicable to the annual [emission inventories](../user_guide/user_guide_emission_inventories).|
|
|
|
|
| | **monthly**: Applicable to the monthly [emission inventories](../user_guide/user_guide_emission_inventories).|
|
|
|
|
| | **daily**: Applicable to the daily [emission inventories](../user_guide/user_guide_emission_inventories).|
|
|
|
|
| _source_type_ | **area** For area emission inventories. |
|
|
|
|
| | **point** For source point emission inventories. |
|
|
|
|
| _coverage_ | **global** For global emission inventories. |
|
|
|
|
| | **regional** For regional emission inventories. |
|
|
|
|
| _p_vertical_ | [**OPTIONAL**] Vertical profile ID defined in the [vertical profiles file](examples_profiles_vertical.md). For GFASv12, information on the method to obtain the injection height and the approach to distribute the emissions needs to be provided (details below). |
|
|
|
|
| _p_month_ | [**OPTIONAL**] Monthly profile ID defined in the [monthly profiles file](examples_profiles_monthly.md) or path to the [gridded monthly temporal profile file](examples_profiles_gridded.md). Mandatory only when the output_timestep_type option of the configuration file is set to monthly, daily or hourly. You can also provide a path to a netCDF file that contains the gridded monthly profile [examples](examples_profiles_gridded.md) |
|
|
|
|
| _p_week_ | [**OPTIONAL**] Weekly profile ID defined in the [weekly profiles file](examples_profiles_weekly.md) or path to the [gridded weekly temporal profile file](examples_profiles_gridded.md). Mandatory only when the output_timestep_type option of the configuration file is set to daily or hourly. |
|
|
|
|
| _p_day_ | [**OPTIONAL**] Daily profile ID defined in the [daily profiles file](examples_profiles_daily.md) or path to the [gridded daily temporal profile file](examples_profiles_gridded.md). Mandatory only when the output_timestep_type option of the configuration file is set to daily or hourly. |
|
|
|
|
| _p_hour_ | [**OPTIONAL**] Hourly profile ID that have to appear in the [hourly profiles file](examples_profiles_hourly.md) (More details bellow) or path to the [gridded hourly temporal profile file](examples_profiles_gridded.md). Mandatory only when the output_timestep_type option of the configuration file is set to hourly. |
|
|
|
|
| _p_speciation_ | Speciation profile ID defined in the [speciation profiles file](examples_profiles_speciation.md). |
|
|
|
|
| _comment_ | [**OPTIONAL**] User comment to explain the configuration line or dataset details. Not used inside de code. |
|
|
|
|
|
|
|
|
|
|
|
|
### Factor mask
|
|
|
|
This option allows the use to define country-specific scaling factors that multiply the original emission inventories.
|
|
|
|
|
|
|
|
A country-specific scaling factor is defined as follows:
|
|
|
|
[Country_specific_alphanumeric_ISO3_code](examples_profiles_world_info.md) + blank space + scaling factor.
|
|
|
|
|
|
|
|
Scaling factors for more than one country need to be separated by a comma.
|
|
|
|
|
|
|
|
For example, if you want to multiply Spanish emissions by 1.5 and Chinese emissions by 2.5, you need to add the following expression:
|
|
|
|
|
|
|
|
```text
|
|
|
|
ESP 1.5,CHN 2.5
|
|
|
|
```
|
|
|
|
|
|
|
|
The alphanumeric ISO3 codes are reported in the _tz_world_country_iso3166.csv_ file (HERMESv3/IN/data/profiles/temporal)
|
|
|
|
|
|
|
|
### Regrid Mask
|
|
|
|
This option allows the user to define a country-specific mask that restricts the applicability of the original emission inventory to a given region.
|
|
|
|
|
|
|
|
The country-specific mask is defined as follows:
|
|
|
|
"+" or "-" + [Country_specific_alphanumeric_ISO3_code](examples_profiles_world_info.md)
|
|
|
|
|
|
|
|
For example, if you want to mask out all the countries except for Spain (i.e. restrict the applicability of the inventory only to Spain), you need to add the following expression:
|
|
|
|
|
|
|
|
```text
|
|
|
|
+ ESP
|
|
|
|
```
|
|
|
|
|
|
|
|
On the contrary, if you want to mask out just Spain (i.e. restrict the applicability of the inventory to all the countries except for Spain), you need to add the following expression:
|
|
|
|
|
|
|
|
```text
|
|
|
|
- ESP
|
|
|
|
```
|
|
|
|
|
|
|
|
The mask that you create can involve more than one country. In this case, the alphanumeric ISO3 codes need to be separated with commas:
|
|
|
|
|
|
|
|
```text
|
|
|
|
+ ESP,CHN
|
|
|
|
```
|
|
|
|
```text
|
|
|
|
- ESP,CHN
|
|
|
|
```
|
|
|
|
|
|
|
|
This functionality can be very useful when combining two or more emission inventories. For example, masking out HTAPv2 emissions to all countries of EU:
|
|
|
|
```text
|
|
|
|
+ NPL,THA,IND,TJK,CHN,MNG,AFG,ARE,ARM,AZE,BEN,BFA,BHR,CAF,CIV,CMR,COD,COG,DJI,DZA,EGY,ERI,ESH,ETH,GAB,GEO,GHA,GIN,GMB,GNB,GNQ,IRN,IRQ,ISR,JOR,KAZ,KEN,KWT,LBN,LBR,LBY,MAR,MLI,MRT,NER,NGA,OMN,PAK,PSE,QAT,RUS,SAU,SDN,SEN,SLE,SOM,SSD,SYR,TCD,TGO,TKM,TUN,UGA,UZB,YEM
|
|
|
|
```
|
|
|
|
And use TNO emissions instead:
|
|
|
|
```text
|
|
|
|
- NPL,THA,IND,TJK,CHN,MNG,AFG,ARE,ARM,AZE,BEN,BFA,BHR,CAF,CIV,CMR,COD,COG,DJI,DZA,EGY,ERI,ESH,ETH,GAB,GEO,GHA,GIN,GMB,GNB,GNQ,IRN,IRQ,ISR,JOR,KAZ,KEN,KWT,LBN,LBR,LBY,MAR,MLI,MRT,NER,NGA,OMN,PAK,PSE,QAT,RUS,SAU,SDN,SEN,SLE,SOM,SSD,SYR,TCD,TGO,TKM,TUN,UGA,UZB,YEM
|
|
|
|
```
|
|
|
|
When using this functionality, user needs to be careful to not double count emissions.
|
|
|
|
|
|
|
|
### p_vertical for GFASv12
|
|
|
|
For GFASv12 the _p_vertical_ field does not have to filled with a vertical profile ID like the other emission inventories, but with two parameters that define: (i) the maximum altitude of the fire plume injection height (method) and (ii) how the emissions are distributed across the layers below this maximum height (approach).
|
|
|
|
|
|
|
|
The fire plume injection height information is reported by GFAS and varies per grid cell. For each grid cell, GFASv12 reports two values of fire plume injection height, which correspond to two different methods to obtain this value:
|
|
|
|
|
|
|
|
**method**
|
|
|
|
+ sovief: The semi-empirical IS4FIRES parameterisation is detailed in [Sofiev et al. (2012)](https://www.atmos-chem-phys.net/12/1995/2012/). Injection height is estimated as a function of the PBL height, the Brunt–Väisälä frequency of the free troposphere and the FRP of a fire.
|
|
|
|
+ prm: A plume rise model described by [Paugam et al. (2015)](https://www.atmos-chem-phys-discuss.net/acp-2014-1043/) that consists of a 1-D cloud-resolving model, forced at its base by satellite-derived fire parameters: convective heat flux (CHF) and active fire area (AF area).
|
|
|
|
|
|
|
|
Regarding the approach, two options exist as well:
|
|
|
|
|
|
|
|
**approach**
|
|
|
|
+ uniform: All the emissions are distributed uniformly across the layers below the maximum injection height
|
|
|
|
+ 50_top: 50% of all emissions are allocated in the vertical layer that intersects with the maximum injection height and the other 50% are distributed uniformly across the layers below the maximum injection height
|
|
|
|
+ surface: All the emissions are assigned to the first layer of the model. This option is conceived for those modellers that want to inject the forest fire emissions online in the atmospheric chemistry model (below the PBL)
|
|
|
|
|
|
|
|
The user has to select the method and the approach separated by a comma
|
|
|
|
|
|
|
|
Example:
|
|
|
|
```text
|
|
|
|
method=sovief,approach=uniform
|
|
|
|
```
|
|
|
|
|
|
|
|
### p_hour
|
|
|
|
The _p_hour_ field accepts specific hourly profiles for weekdays, saturdays and sundays.
|
|
|
|
|
|
|
|
Example:
|
|
|
|
```text
|
|
|
|
weekday=H006, saturday=H009, sunday=H010
|
|
|
|
```
|
|
|
|
If the user wants to apply the same hourly profile for all day types then only one profile needs to be added (following the cases of the _p_moth_ and _p_day_).
|
|
|
|
|
|
|
|
[Inventories selection](../user_guide/user_guide_section_inventories) |
|
|
|
\ No newline at end of file |