... | @@ -54,43 +54,44 @@ hermesv3_bu_data/ |
... | @@ -54,43 +54,44 @@ hermesv3_bu_data/ |
|
|
|
|
|
| **File** | **Description** |
|
|
| **File** | **Description** |
|
|
| :--------: | :---------- |
|
|
| :--------: | :---------- |
|
|
| cattle.tif, chicken.tif, goats.tif, pigs.tif, sheep.tif | Raster files that contain the [livestock population density information](https://dataverse.harvard.edu/dataverse/glw_3). |
|
|
| cattle.tif, chicken.tif, goats.tif, pigs.tif, sheep.tif | Raster files that contain the [livestock population density information](#livestock-density-files). |
|
|
| cattle.cdv, chicken.csv, goats.csv, pigs.csv, sheep.tcsv | CSV files that contain the [livestock subgroup split factors and adjusting factors to match the official statistics provided at the NUTS3 level](#correction-and-split-factors-file). A description of each livestock subcategory code is available [here](../examples/livestock_categories)|
|
|
| cattle.csv, chicken.csv, goats.csv, pigs.csv, sheep.csv | CSV files that contain the [livestock subgroup split factors and adjusting factors to match the official statistics provided at the NUTS3 level](#correction-and-split-factors-file). A description of each livestock subcategory code is available [here](../examples/livestock_categories)|
|
|
| denominator_yearly_factor_dir | Define the path to the NetCDF file that contains the yearly average daily factor per grid cell. |
|
|
| grassing_2016.nc, housing_closed_2016.nc, housing_open_2016.nc, storage_2016.nc | NetCDF files that contain the [yearly average daily temporal factor per grid cell and each livestock operation](#average-daily-factor-file). |
|
|
| nh3.csv, nox_no.csv, nmvoc.csv, pm.csv | CSV files that contain the [emission factors for each pollutant](#emission-factor-file).|
|
|
| nh3.csv, nox_no.csv, nmvoc.csv, pm.csv | CSV files that contain the [emission factors for each pollutant](#emission-factor-file).|
|
|
| monthly_profiles.csv | CSV file that contains the [monthly temporal profiles](#temporal-monthly-profiles)|
|
|
| monthly_profiles.csv | CSV file that contains the [monthly temporal profiles](#temporal-monthly-profiles)|
|
|
| weekly_profiles.csv | CSV file that contains the [weekly temporal profiles](#temporal-weekly-profiles)|
|
|
| weekly_profiles.csv | CSV file that contains the [weekly temporal profiles](#temporal-weekly-profiles)|
|
|
| hourly_profiles.csv | CSV file that contains the [hourly temporal profiles](#temporal-hourly-profiles)|
|
|
| hourly_profiles.csv | CSV file that contains the [hourly temporal profiles](#temporal-hourly-profiles)|
|
|
| speciation_profiles_base.csv, speciation_profiles_cmaq_cb05_aero5.csv | CSV file that contains the [speciation profiles](../examples/profiles_speciation_profiles) |
|
|
| speciation_profiles_base.csv, speciation_profiles_cmaq_cb05_aero5.csv | CSV file that contains the [speciation profiles](../examples/profiles_speciation_profiles) |
|
|
|
|
|
|
|
|
### Livestock density files
|
|
|
|
|
|
|
|
HERMESv3_BU uses the livestock population density Geotiff raster files reported by the Gridded Livestock of the World (GLW 3) database.
|
|
|
|
Original files can be downloaded from this [link](https://dataverse.harvard.edu/dataverse/glw_3) and directly used in HERMESv3_BU without performing any pre-processing.
|
|
|
|
User should cite the FAO data following the references provided in [here](https://www.nature.com/articles/sdata2018227).
|
|
|
|
|
|
|
|
|
|
### Correction and split factors file
|
|
### Correction and split factors file
|
|
|
|
|
|
The example below displays the first few lines of the correction and split factors CSV file used for Spain.
|
|
The example below displays the first few lines of the correction and split factors CSV file used in HERMESv3_BU for the cattle livestock category. The same file format is used for the rest of categories (chicken, goats, pigs, sheep ).
|
|
|
|
|
|
```csv
|
|
```csv
|
|
"NUT","nut_code","sheep_fact","sheep_01","sheep_02","sheep_03","sheep_04","sheep_05","sheep_06","sheep_07"
|
|
"nuts3_na","nuts3_id","cattle_fact","cattle_01","cattle_02","cattle_03","cattle_04","cattle_05","cattle_06","cattle_07","cattle_08","cattle_09","cattle_10","cattle_11"
|
|
"A Coruña","15",0.932198677861049,0.281808193376236,0.0621880395542301,0.0146287866896876,0.00367289279547952,0.000941767383456286,0.00141265107518443,0.635347669125726
|
|
"Barcelona","08",1,0.550146424410366,0.00351418584878924,0.0387442138741065,0.0297446232326731,0.0178921182731366,0.0515099033284,0.00702207387347671,0.00221053625972227,0.0237302012154801,0.138696980193343,0.136788739490506
|
|
"Álava","01",0.68414194639191,0.0556329784268911,0.0308081089618522,0.138339186502406,0.0812011074567516,0.0691603025066429,0.351152981399929,0.273705334745526
|
|
"Girona","17",1,0.437441333995914,0.00274694936778753,0.0435370769145823,0.0173927447407653,0.0210783501739274,0.0667550107669372,0.0153842968361769,0.00310584727513666,0.0345025122853514,0.198408425818563,0.159647451824858
|
|
"Albacete","02",0.854723802291495,0.156820555143839,0.023298019268342,0.0738395203126053,0.0204894563093714,0.031144731523277,0.252027470861686,0.44238024658088
|
|
"Lleida","25",1,0.723188848690372,0.00342070760343451,0.0215954758595308,0.0310163871938697,0.0131636452059161,0.0328729672091823,0.00444922007209445,0.00133082284283475,0.0141231520456883,0.0822185638285637,0.0726202094485136
|
|
"Alicante","03",0.80613829142684,0.230323883787021,0.0292293961528525,0.0251309392394955,0.000857270357235127,0.0560748761068182,0.0134932005542899,0.644890433802288
|
|
"Tarragona","43",1,0.791085207683467,0.00106714825151863,0.00656706616319159,0.0342308323756362,0.0283204728287638,0.00541782958463306,0.0240518798226892,0.0016417665407979,0.00870136266622886,0.000656706616319159,0.0982597274667542
|
|
"Almería","04",1.06545564602965,0.216675680252599,0.0304823087890657,0.0451717224689578,0.00171531271680406,0.0660395395969561,0.0162026035606396,0.623712832614978
|
|
|
|
"Asturias","33",1.27795630950995,0.162062537073129,0.0600161003304805,0.0155495297008728,0.00192780272858232,0.0525167358698415,0.0253156512159986,0.682611643081095
|
|
|
|
"Ávila","05",0.74571235762723,0.208336552150354,0.0201626698155894,0.00771412490481498,0.0112952887554766,0.0436471587961992,0.212326045931599,0.496518159645967
|
|
|
|
"Badajoz","06",1.00543087971275,0.237212109349514,0.0253603032831639,0.0442455350550971,0.00291667954383905,0.0487031828936208,0.036256966550257,0.605305223324508
|
|
|
|
"Baleares","07",1.03638401921415,0.273844288757016,0.0268884542738878,0.0139850772260251,0.000207632851535813,0.0487401374395521,0.00270592490388608,0.633628484548097
|
|
|
|
"Barcelona","08",0.828293624797435,0.333936921561282,0.018357407484494,0.0453384950533516,0.000457894517753819,0.0384076371255325,0.00670884846466581,0.556792795792921
|
|
|
|
```
|
|
```
|
|
|
|
|
|
| **Field** | **Description** |
|
|
| **Field** | **Description** |
|
|
| :--------: | :---------- |
|
|
| :--------: | :---------- |
|
|
| NUT | name of the NUTS3. |
|
|
| nuts3_na | name of the NUTS3. |
|
|
| nut_code | Code of the NUTS3. This code needs to be equal to the NUTS code defined in the [NUTS3 shapefile](../section_sectors). |
|
|
| nuts3_id | Code of the NUTS3. This code needs to be equal to the NUTS code defined in the [NUTS3 shapefile](../section_sectors). |
|
|
| \<animal>_fact | Adjusting factor to match original 2010 GLWv3 values to the official statistics provided at the NUTS3 level for another specific year. |
|
|
| \<animal>_fact | Adjusting factor to match original 2010 GLWv3 values to the official statistics provided at the NUTS3 level for another specific year. |
|
|
| \<animal>_\<animal_type_num> | Livestock subgroup split factor at NUTS3 level [0 : 1]. For each line, total sum need to be equal to 1. |
|
|
| \<animal>_\<animal_type_num> | Livestock subgroup split factor at NUTS3 level [0 : 1]. For each line, total sum need to be equal to 1. |
|
|
|
|
|
|
### NH3 emission factor file
|
|
### Emission factor file
|
|
|
|
|
|
The example below display the first few lines of the NH3 emission factors CSV files used in HERMESv3_BU.
|
|
#### NH3
|
|
|
|
|
|
```csv
|
|
```csv
|
|
Code,Nex,Xtan,Xhousing,Xyards,Xgraz,Xslurry,Xsolid,EF_hous_slurry,EF_hous_solid,EF_yard,f_imm,m_bedding_N,x_store_slurry,x_store_FYM,f_min,EF_storage_slurry_NH3,EF_storage_solid_NH3,EF_graz
|
|
Code,Nex,Xtan,Xhousing,Xyards,Xgraz,Xslurry,Xsolid,EF_hous_slurry,EF_hous_solid,EF_yard,f_imm,m_bedding_N,x_store_slurry,x_store_FYM,f_min,EF_storage_slurry_NH3,EF_storage_solid_NH3,EF_graz
|
... | @@ -154,7 +155,7 @@ chicken_02,0.7175473431,0.7,1,0,0,0,1,0,0.28,0,0.0067,0,0,1,0.1,0,0.17,0 |
... | @@ -154,7 +155,7 @@ chicken_02,0.7175473431,0.7,1,0,0,0,1,0,0.28,0,0.0067,0,0,1,0.1,0,0.17,0 |
|
| EF_storage_solid_NH3 | Emission factor associated to storage (solid) excreta (in kg NH3-N·kg N-1). |
|
|
| EF_storage_solid_NH3 | Emission factor associated to storage (solid) excreta (in kg NH3-N·kg N-1). |
|
|
| EF_graz | Emission factor associated to grazing (in kg NH3-N·kg N-1). |
|
|
| EF_graz | Emission factor associated to grazing (in kg NH3-N·kg N-1). |
|
|
|
|
|
|
### NMVOC emission factor file
|
|
#### NMVOC
|
|
|
|
|
|
```csv
|
|
```csv
|
|
"Code","Xhousing","EF_nmvoc"
|
|
"Code","Xhousing","EF_nmvoc"
|
... | @@ -202,7 +203,7 @@ chicken_02,1,0.108 |
... | @@ -202,7 +203,7 @@ chicken_02,1,0.108 |
|
| Xhousing | Fraction of time that animals spend in housing [0 : 1]. |
|
|
| Xhousing | Fraction of time that animals spend in housing [0 : 1]. |
|
|
| EF_nmvoc | NMVOC emission factor (in kg NMVOC·head-1). |
|
|
| EF_nmvoc | NMVOC emission factor (in kg NMVOC·head-1). |
|
|
|
|
|
|
### NOx_NO emission factor file
|
|
#### NOx
|
|
|
|
|
|
```csv
|
|
```csv
|
|
Code,Nex,Xtan,Xhousing,Xyards,Xgraz,Xslurry,Xsolid,EF_hous_slurry,EF_hous_solid,EF_yard,f_imm,m_bedding_N,x_store_slurry,x_store_FYM,f_min,EF_storage_slurry_NO,EF_storage_solid_NO
|
|
Code,Nex,Xtan,Xhousing,Xyards,Xgraz,Xslurry,Xsolid,EF_hous_slurry,EF_hous_solid,EF_yard,f_imm,m_bedding_N,x_store_slurry,x_store_FYM,f_min,EF_storage_slurry_NO,EF_storage_solid_NO
|
... | @@ -265,7 +266,7 @@ chicken_02,0.717547343,0.7,1,0,0,0,1,0,0.28,0,0.0067,0,0,1,0.1,0,0.01 |
... | @@ -265,7 +266,7 @@ chicken_02,0.717547343,0.7,1,0,0,0,1,0,0.28,0,0.0067,0,0,1,0.1,0,0.01 |
|
| EF_storage_slurry_NO | Emission factor associated to storage (slurry) excreta (in kg NOx-N·kg N-1). |
|
|
| EF_storage_slurry_NO | Emission factor associated to storage (slurry) excreta (in kg NOx-N·kg N-1). |
|
|
| EF_storage_solid_NO | Emission factor associated to storage (solid) excreta (in kg NOx-N·kg N-1). |
|
|
| EF_storage_solid_NO | Emission factor associated to storage (solid) excreta (in kg NOx-N·kg N-1). |
|
|
|
|
|
|
### PM emission factor file
|
|
#### PM
|
|
|
|
|
|
```csv
|
|
```csv
|
|
"Code","Xhousing","EF_pm10","EF_pm25"
|
|
"Code","Xhousing","EF_pm10","EF_pm25"
|
... | @@ -316,7 +317,7 @@ chicken_02,1,0.02,0.002 |
... | @@ -316,7 +317,7 @@ chicken_02,1,0.02,0.002 |
|
|
|
|
|
### Temporal monthly profiles
|
|
### Temporal monthly profiles
|
|
|
|
|
|
The example below shows the monthly factors CSV file used for Spain. The monthly factors only apply to PM and NMVOC emissions. NH3 and NOx emissions are directly distributed at the daily level using meteorological-dependent parametrisations.
|
|
The example below shows the monthly factors CSV file used in HERMESv3_BU. The monthly factors only apply to PM and NMVOC emissions. NH3 and NOx emissions are directly distributed at the daily level using meteorological-dependent parametrisations.
|
|
For each profile, the sum of all factors has to be equal to 1.
|
|
For each profile, the sum of all factors has to be equal to 1.
|
|
|
|
|
|
```csv
|
|
```csv
|
... | @@ -327,13 +328,6 @@ nmvoc,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333,0. |
... | @@ -327,13 +328,6 @@ nmvoc,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333,0. |
|
pmc,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333
|
|
pmc,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333
|
|
```
|
|
```
|
|
|
|
|
|
|P_month|January |February |March |April |May |June |July |August |September |October |November |December |
|
|
|
|
|-------|-----------|-----------|-----------|-----------|-----------|-----------|-----------|-----------|-----------|-----------|-----------|-----------|
|
|
|
|
|pm10 |0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|
|
|
|
|
|pm25 |0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|
|
|
|
|
|nmvoc |0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|
|
|
|
|
|pmc |0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|0.083333333|
|
|
|
|
|
|
|
|
| **Field** | **Description** |
|
|
| **Field** | **Description** |
|
|
| :--------: | :---------- |
|
|
| :--------: | :---------- |
|
|
| P_month | Pollutant name. Monthly profiles are associated to a pollutant. |
|
|
| P_month | Pollutant name. Monthly profiles are associated to a pollutant. |
|
... | @@ -352,7 +346,7 @@ pmc,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333,0.08 |
... | @@ -352,7 +346,7 @@ pmc,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333,0.083333333,0.08 |
|
|
|
|
|
### Temporal weekly profiles
|
|
### Temporal weekly profiles
|
|
|
|
|
|
The example below shows the weekly temporal profile CSV file used for Spain.
|
|
The example below shows the weekly temporal profile CSV file used in HERMESv3_BU.
|
|
For each profile, the sum of all factors has to be equal to 7. HERMESv3_BU includes a internal reweighting function to calculate the daily weight factor for each specific day of the month.
|
|
For each profile, the sum of all factors has to be equal to 7. HERMESv3_BU includes a internal reweighting function to calculate the daily weight factor for each specific day of the month.
|
|
The monthly factors only apply to PM and NMVOC emissions. NH3 and NOx emissions are directly distributed at the daily level using meteorological-dependent parametrisations.
|
|
The monthly factors only apply to PM and NMVOC emissions. NH3 and NOx emissions are directly distributed at the daily level using meteorological-dependent parametrisations.
|
|
|
|
|
... | @@ -377,7 +371,7 @@ pmc,1,1,1,1,1,1,1 |
... | @@ -377,7 +371,7 @@ pmc,1,1,1,1,1,1,1 |
|
|
|
|
|
### Temporal hourly profiles
|
|
### Temporal hourly profiles
|
|
|
|
|
|
The example below displays the first few lines of the hourly temporal profile CSV file used for Spain.
|
|
The example below displays the first few lines of the hourly temporal profile CSV file used in HERMESv3_BU.
|
|
For each profile, the sum of all factors has to be equal to 1. The profiles should be reported according to local time.
|
|
For each profile, the sum of all factors has to be equal to 1. The profiles should be reported according to local time.
|
|
|
|
|
|
```csv
|
|
```csv
|
... | | ... | |