Skip to content
GitLab

user_guide_sector_residential · Changes

Page history
Wiki update authored by Carles Tena's avatar Carles Tena
Hide whitespace changes
Inline Side-by-side
user_guide_sector_residential.md 0 → 100644
View page @ e6f7b3d9
# Residential combustion sector
This section of the configuration file is used to define all the parameters needed for the calculation of the residential/commercial sector.
It is important to note that, in its current version, energy consumptions from agricultural small combustion appliances are not considered.
DESCRIPTION
```text
[RESIDENTIAL]
fuel_list = HD_res, LPG_res, NG_res, HD_com, LPG_com, NG_com, B_res, B_com
residential_source_pollutants = nox_no2, so2, co, nh3, pm10, pm25, nmvoc
energy_consumption_nuts3 = <input_dir>/residential/energy_consumption_nuts3.csv
energy_consumption_nuts2 = <input_dir>/residential/energy_consumption_nuts2.csv
residential_spatial_proxies = <input_dir>/residential/spatial_proxies.csv
residential_ef_files_path = <input_dir>/residential/ef/ef.csv
residential_heating_degree_day_path = <data_path>/ecmwf/era5/yearly/heatingdegreeday/hdd_<year>.nc
residential_hourly_profiles = <input_dir>/profiles/temporal/residential/hourly_profiles.csv
residential_speciation_profiles = <input_dir>/profiles/speciation/residential/speciation_profiles_base.csv
```
## Options description
| **Option** | **Details** |
| :--------: | :---------- |
| fuel_list | List of fuel types considered for the calculation of the sector. (HD = heating diesel, LPG = liquefied petroleum gas, NG = natural gas; B = biomass, res = residential, com = commercial). |
| residential_source_pollutants | List of pollutants considered for the calculation of the residential/commercial sector. |
| energy_consumption_nuts3 | Defines the path to the CSV file that contains the [annual amount of energy consumed per fuel type and NUTS3](#energy-consumption-by-province-file). |
| energy_consumption_nuts2 | Defines the path to the CSV file that contains the [annual amount of energy consumed per fuel type and NUTS2](#energy-consumption-by-ccaa-file).|
| residential_spatial_proxies | Defines the path to the CSV file that contains the [type of population (urban, rural) assigned to each fuel for its spatial mapping](#spatial-proxies-file).|
| residential_ef_files_path | Defines the path to the CSV file that contains the [emission factors for each fuel type](#emission-factors-file). |
| residential_heating_degree_day_path | Define the path to the NetCDF file that contains the yearly average HDD factor per grid cell. |
| residential_hourly_profiles | Defines the path to the CSV file that contains the [hourly temporal profiles per fuel type](#temporal-hourly-profiles). |
| residential_speciation_profiles | Defines the path to the CSV file that contains the [speciation profiles](examples_profiles_speciation_profiles). |
### Energy consumption by province file
The example below display the first few lines of the residential/commercial energy consumption at NUTS3 level CSV file used in HERMESv3_BU.
```csv
nuts3_na,nuts3_id,HD_res,LPG_res,NG_res,HD_com,LPG_com,NG_com,HD_agr,LPG_arg,NG_agr
A Coruña,15,1973657.836,1689920.694,2043982.152,958987.3498,232699.236,3151863.576,160862.3942,15735.72,1102.392
Álava,1,396571.7555,89896.884,1975736.736,192691.6053,14461.062,2189699.244,32322.46283,2029.566,347.796
Albacete,2,732211.1538,553915.362,959082.264,355776.5794,58621.332,664661.7,59678.65204,28564.074,3957.012
Alicante,3,1206361.879,2272677.33,1241367.876,586163.2954,513353.61,1011989.232,98324.16568,32591.79,80320.752
Almería,4,408096.9795,585591.93,403468.344,198291.6358,166865.16,509130.864,33261.82278,41900.166,719742.636
Asturias,33,1467867.004,843264.114,4607926.236,713226.9143,154456.302,2312541.612,119638.063,2945.25,3445.884
Ávila,5,544029.8642,300704.712,132634.368,264340.5296,48718.824,750507.876,44340.99207,5678.442,80.64
Badajoz,6,387561.2982,1189726.23,455628.312,188313.4834,137832.618,2334995.568,31588.06819,34231.89,593218.44
Baleares,7,3744951.055,2336406.996,335072.016,1819647.064,819105.672,1804373.172,305231.1204,40079.424,417.456
Barcelona,8,3255942.044,1815207.24,28176031.62,1582040.805,326998.98,17325277.06,265374.5866,81695.46,94888.44
```
|nuts3_na |nuts3_id|HD_res |LPG_res |NG_res |HD_com |LPG_com |NG_com |HD_agr |LPG_arg |NG_agr |
|--------------------------------|----|----------------------|-----------|-----------|-----------|----------|-----------|-----------|----------|-----------|
|A Coruña |15 |1973657.836 |1689920.694|2043982.152|958987.3498|232699.236|3151863.576|160862.3942|15735.72 |1102.392 |
|Álava |1 |396571.7555 |89896.884 |1975736.736|192691.6053|14461.062 |2189699.244|32322.46283|2029.566 |347.796 |
|Albacete |2 |732211.1538 |553915.362 |959082.264 |355776.5794|58621.332 |664661.7 |59678.65204|28564.074 |3957.012 |
|Alicante |3 |1206361.879 |2272677.33 |1241367.876|586163.2954|513353.61 |1011989.232|98324.16568|32591.79 |80320.752 |
|Almería |4 |408096.9795 |585591.93 |403468.344 |198291.6358|166865.16 |509130.864 |33261.82278|41900.166 |719742.636 |
|Asturias |33 |1467867.004 |843264.114 |4607926.236|713226.9143|154456.302|2312541.612|119638.063 |2945.25 |3445.884 |
|Ávila |5 |544029.8642 |300704.712 |132634.368 |264340.5296|48718.824 |750507.876 |44340.99207|5678.442 |80.64 |
|Badajoz |6 |387561.2982 |1189726.23 |455628.312 |188313.4834|137832.618|2334995.568|31588.06819|34231.89 |593218.44 |
|Baleares |7 |3744951.055 |2336406.996|335072.016 |1819647.064|819105.672|1804373.172|305231.1204|40079.424 |417.456 |
|Barcelona |8 |3255942.044 |1815207.24 |28176031.62|1582040.805|326998.98 |17325277.06|265374.5866|81695.46 |94888.44 |
| **Option** | **Details** |
| :--------: | :---------- |
| nuts3_na | NUTS3 name. |
| nuts3_id | NUTS3 code. |
| HD_res | Heating diesel used in the residential sector (in GJ·year-1). |
| LPG_res | Liquified Petroleum Gas used in the residential sector (in GJ·year-1). |
| NG_res | Natural gas used in the residential sector (in GJ·year-1). |
| HD_com | Heating diesel used in the commercial sector (in GJ·year-1). |
| LPG_com | Liquified Petroleum Gas used in the commercial sector (in GJ·year-1). |
| NG_com | Natural gas used in the commercial sector (in GJ·year-1). |
| HD_agr | Heating diesel used in the agricultural sector (in GJ·year-1). |
| LPG_arg | Liquified Petroleum Gas used in the agricultural sector (in GJ·year-1). |
| NG_agr | Natural gas used in the agricultural sector (in GJ·year-1). |
### Energy consumption by CCAA file
The example below display the first few lines of the residential/commercial energy consumption at NUTS2 level CSV file used in HERMESv3_BU.
```nuts2_id,nuts2_na,B_res,B_com,B_agr
1,ANDALUCIA,23826392.76,766845.8752,654390.4
2,ARAGON,4288815.799,138034.3528,117792.1
3,ASTURIAS,5619041.886,180847.3123,154326.6
4,BALEARES,1228085.003,39525.57688,33729.3
6,CANTABRIA,1223966.809,39393.03393,33616.2
7,CASTILLA_LEON,11121467.36,357941.3575,305450.4
8,CASTILLA_LA_MANCHA,7027735.602,226185.7308,193016.3
9,CATALUNYA,7349546.596,236543.1288,201854.8
```
|nuts2_id|nuts2_na|B_res |B_com |B_agr |
|----|----|----------------------|-----------|-----------|
|1 |ANDALUCIA|23826392.76 |766845.8752|654390.4 |
|2 |ARAGON|4288815.799 |138034.3528|117792.1 |
|3 |ASTURIAS|5619041.886 |180847.3123|154326.6 |
|4 |BALEARES|1228085.003 |39525.57688|33729.3 |
|6 |CANTABRIA|1223966.809 |39393.03393|33616.2 |
|7 |CASTILLA_LEON|11121467.36 |357941.3575|305450.4 |
|8 |CASTILLA_LA_MANCHA|7027735.602 |226185.7308|193016.3 |
|9 |CATALUNYA|7349546.596 |236543.1288|201854.8 |
| **Option** | **Details** |
| :--------: | :---------- |
| nuts2_id | NUTS2 code. |
| nuts2_na | NUTS2 name. |
| B_res | Biomass used in the residential sector (in GJ·year-1). |
| B_com | Biomass used in the commercial sector (in GJ·year-1). |
| B_agr | Biomass used in the agricultural sector (in GJ·year-1). |
### Spatial proxies file
The example below displays the spatial proxy selection CSV file used for Spain.
It is important to note that in its current version, HERMESv3_BU do not have a definition of the "agriculture" proxy.
```csv
fuel_type,nuts_level,proxy
HD_res,3,all
LPG_res,3,all
NG_res,3,all
HD_com,3,all
LPG_com,3,all
NG_com,3,all
HD_agr,3,agriculture
LPG_agr,3,agriculture
NG_agr,3,agriculture
B_res,2,rural
B_com,2,rural
B_agr,2,agriculture
```
|fuel_type|nuts_level|proxy |
|---------|----------|-----------|
|HD_res |3 |all |
|LPG_res |3 |all |
|NG_res |3 |all |
|HD_com |3 |all |
|LPG_com |3 |all |
|NG_com |3 |all |
|HD_agr |3 |agriculture|
|LPG_agr |3 |agriculture|
|NG_agr |3 |agriculture|
|B_res |2 |rural |
|B_com |2 |rural |
|B_agr |2 |agriculture|
| **Option** | **Details** |
| :--------: | :---------- |
| fuel_type | Fuel type code. |
| nuts_level | NUTS level at which the energy consumption information is supplied. [2: NUTS2, 3: NUTS3 |
| proxy | Spatial proxy used to map the energy statistics onto the working domain [all: urban+rural population, rural: rural population, agriculture: NOT DEFINED. |
### Emission factors file
The examples below displays the emission factors CSV file used in HERMESv3_BU.
```csv
fuel_type,nox_no2,co,nmvoc,so2,nh3,pm10,pm25,co2,ch4,n2o
HD_res,69,3.7,0.17,79,0,1.5,1.5,74100,10,0.6
LPG_res,40,10,2,0.2,0,2,2,63100,5,0.1
NG_res,42,22,1.8,0.3,0,0.2,0.2,56100,5,0.1
B_res,63.2,3760.6,476.5,11.0,67.8,612.1,597.0,108000,266.67,3
HD_com,100,200,15,140,0,30,30,74100,10,0.6
LPG_com,100,200,15,140,0,30,30,74100,10,0.6
NG_com,40,30,2,0.3,0,0.45,0.45,56100,5,0.1
B_com,91,570,300,11,37,143,140,108000,266.67,3
HD_agr,942,130,50,48,0,30,30,74100,10,0.6
LPG_arg,942,130,50,48,0,30,30,63100,5,0.1
NG_agr,942,130,50,48,0,30,30,63100,5,0.1
B_agr,91,570,300,11,37,143,140,108000,266.67,3
```
|fuel_type|nox_no2|co |nmvoc|so2 |nh3 |pm10 |pm25 |co2 |ch4 |n2o|
|---------|-------|------|-----|----|----|-----|-----|------|------|---|
|HD_res |69 |3.7 |0.17 |79 |0 |1.5 |1.5 |74100 |10 |0.6|
|LPG_res |40 |10 |2 |0.2 |0 |2 |2 |63100 |5 |0.1|
|NG_res |42 |22 |1.8 |0.3 |0 |0.2 |0.2 |56100 |5 |0.1|
|B_res |63.2 |3760.6|476.5|11.0|67.8|612.1|597.0|108000|266.67|3 |
|HD_com |100 |200 |15 |140 |0 |30 |30 |74100 |10 |0.6|
|LPG_com |100 |200 |15 |140 |0 |30 |30 |74100 |10 |0.6|
|NG_com |40 |30 |2 |0.3 |0 |0.45 |0.45 |56100 |5 |0.1|
|B_com |91 |570 |300 |11 |37 |143 |140 |108000|266.67|3 |
|HD_agr |942 |130 |50 |48 |0 |30 |30 |74100 |10 |0.6|
|LPG_arg |942 |130 |50 |48 |0 |30 |30 |63100 |5 |0.1|
|NG_agr |942 |130 |50 |48 |0 |30 |30 |63100 |5 |0.1|
|B_agr |91 |570 |300 |11 |37 |143 |140 |108000|266.67|3 |
| **Option** | **Details** |
| :--------: | :---------- |
| fuel_type | Fuel type code. |
| nox_no2 | Emission factor for NOx expressed as NO2 (in g·GJ-1). |
| co | Emission factor for CO (in g·GJ-1). |
| nmvoc | Emission factor for HC (in g·GJ-1). |
| so2 | Emission factor for SO2 (in g·GJ-1). |
| nh3 | Emission factor for NH3 (in g·GJ-1). |
| pm10 | Emission factor for PM10 (in g·GJ-1). |
| pm25 | Emission factor for PM2.5 (in g·GJ-1). |
| co2 | Emission factor for CO2 (in g·GJ-1). |
| ch4 | Emission factor for CH4 (in g·GJ-1). |
| n2o | Emission factor for N2O (in g·GJ-1). |
### Temporal hourly profiles
The example below displays the first few lines of the hourly temporal profile CSV file used for Spain.
For each profile, the sum of all factors has to be equal to 1. The profiles should be reported according to local time.
```csv
P_hour,0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23
biomass,0.015941559,0.012546902,0.011122138,0.008264757,0.009168005,0.015402628,0.018693307,0.017026029,0.017433156,0.016606271,0.013684819,0.01232885,0.011485382,0.026066323,0.028383594,0.040938818,0.065174624,0.120792865,0.133847805,0.126023901,0.105390465,0.079090624,0.071197907,0.023389273
others,0.0158,0.0150,0.0150,0.0150,0.0154,0.0208,0.0496,0.0638,0.0654,0.0650,0.0563,0.0483,0.0446,0.0442,0.0417,0.0408,0.0413,0.0467,0.0588,0.0633,0.0579,0.0563,0.0417,0.0175
```
| **Option** | **Details** |
| :--------: | :---------- |
| P_hour | Fuel type. Hourly profiles are associated to a fuel. |
| 0 | Hourly weight factor for hour 00:00. [0 : 1] |
| 1 | Hourly weight factor for hour 01:00. [0 : 1] |
| 2 | Hourly weight factor for hour 02:00. [0 : 1] |
| 3 | Hourly weight factor for hour 03:00. [0 : 1] |
| 4 | Hourly weight factor for hour 04:00. [0 : 1] |
| 5 | Hourly weight factor for hour 05:00. [0 : 1] |
| 6 | Hourly weight factor for hour 06:00. [0 : 1] |
| 7 | Hourly weight factor for hour 07:00. [0 : 1] |
| 8 | Hourly weight factor for hour 08:00. [0 : 1] |
| 9 | Hourly weight factor for hour 09:00. [0 : 1] |
| 10 | Hourly weight factor for hour 10:00. [0 : 1] |
| 11 | Hourly weight factor for hour 11:00. [0 : 1] |
| 12 | Hourly weight factor for hour 12:00. [0 : 1] |
| 13 | Hourly weight factor for hour 13:00. [0 : 1] |
| 14 | Hourly weight factor for hour 14:00. [0 : 1] |
| 15 | Hourly weight factor for hour 15:00. [0 : 1] |
| 16 | Hourly weight factor for hour 16:00. [0 : 1] |
| 17 | Hourly weight factor for hour 17:00. [0 : 1] |
| 18 | Hourly weight factor for hour 18:00. [0 : 1] |
| 19 | Hourly weight factor for hour 19:00. [0 : 1] |
| 20 | Hourly weight factor for hour 20:00. [0 : 1] |
| 21 | Hourly weight factor for hour 21:00. [0 : 1] |
| 22 | Hourly weight factor for hour 22:00. [0 : 1] |
| 23 | Hourly weight factor for hour 23:00. [0 : 1] |
[Go to User guide page](user_guide)
[Go to Sectors page](user_guide_section_sectors)
\ No newline at end of file