README.md 15.8 KB
Newer Older
mguevara's avatar
mguevara committed
## HERMESv3_BU input and benchmark data

This project contains input and benchmark comparison data to test the build of the HERMESv3_BU model.

### Internal input data
This dataset refers to those files that are not dependent on the domain of study (e.g. emission factors).
Users can modify the existing files if needed (e.g. temporal profiles) or add new ones (e.g. speciation profiles for a new chemical mechanism) but it is not mandatory in order to correctly run the model.

```
hermesv3_bu_data/
├── agriculture
│   ├── agriculture_fertilizers
│   │   ├── ef
│   │   │   └── f_fertilizers.csv
│   ├── agricultural_machinery
│   │   ├── load_factor.csv
│   │   ├── deterioration_factor.csv
│   │   └── ef.csv
│   ├── agriculture_crop_operations
│   │   └── ef
│   │       ├── pm10.csv
│   │       └── pm25.csv
│   └── map_crops_landuse.csv
├── aviation
│   ├── ef
│   │   ├── ef_approach.csv
│   │   ├── ef_apu.csv
│   │   ├── ef_climbout.csv
│   │   ├── ef_landing.csv
│   │   ├── ef_landing_wear.csv
│   │   ├── ef_takeoff.csv
│   │   └── ef_taxi.csv
│   ├── planes.csv
│   └── times.csv
├── livestock
│   └── ef
│       ├── nh3.csv
│       ├── nmvoc.csv
│       ├── nox_no.csv
│       └── pm.csv
├── recreational_boats
│   └── ef_recreational_boats.csv
├── residential
│   ├── ef
│   │   └── ef.csv
│   └── spatial_proxies.csv
├── shipping_port
│   ├── ef
│   │   ├── engines_fuel_EF.csv
│   │   └── ship_perc_engines.csv
│   ├── ship_phase_LF_time.csv
│   └── ship_power_ME_AE.csv
├── traffic
│   └── ef
│       ├── brake_pm.csv
│       ├── cold_ch4.csv
│       ├── cold_co2.csv
│       ├── cold_co.csv
│       ├── cold_nh3.csv
│       ├── cold_nox_no2.csv
│       ├── cold_pm.csv
│       ├── cold_so2.csv
│       ├── cold_voc.csv
│       ├── hot_ch4.csv
│       ├── hot_co2.csv
│       ├── hot_co.csv
│       ├── hot_nh3.csv
│       ├── hot_nox_no2.csv
│       ├── hot_pm.csv
│       ├── hot_so2.csv
│       ├── hot_voc.csv
│       ├── mcorr_co.csv
│       ├── mcorr_nox_no2.csv
│       ├── mcorr_voc.csv
│       ├── resuspension_pm.csv
│       ├── road_pm.csv
│       └── tyre_pm.csv
├── traffic_area
│   └── ef
│       └── small_cities.csv
├── profiles
│   ├── speciation
│   │   ├── MolecularWeights.csv
│   │   ├── map_base.csv
│   │   ├── map_cmaq_cb05_aero5.csv
│   │   ├── agricultural_machinery
│   │   │   ├── speciation_profiles_base.csv
│   │   │   └── speciation_profiles_cmaq_cb05_aero5.csv
│   │   ├── agriculture_crop_operations
│   │   │   ├── speciation_profiles_base.csv
│   │   │   └── speciation_profiles_cmaq_cb05_aero5.csv
│   │   ├── agriculture_fertilizers
│   │   │   ├── speciation_profiles_base.csv
│   │   │   └── speciation_profiles_cmaq_cb05_aero5.csv
│   │   ├── aviation
│   │   │   ├── speciation_profiles_base.csv
│   │   │   └── speciation_profiles_cmaq_cb05_aero5.csv
│   │   ├── livestock
│   │   │   ├── speciation_profiles_base.csv
│   │   │   └── speciation_profiles_cmaq_cb05_aero5.csv
│   │   ├── recreational_boats
│   │   │   ├── speciation_profiles_base.csv
│   │   │   └── speciation_profiles_cmaq_cb05_aero5.csv
│   │   ├── residential
│   │   │   ├── speciation_profiles_base.csv
│   │   │   └── speciation_profiles_cmaq_cb05_aero5.csv
│   │   ├── shipping_port
│   │   │   ├── speciation_profiles_base.csv
│   │   │   └── speciation_profiles_cmaq_cb05_aero5.csv
│   │   ├── traffic
│   │   │   ├── brake_base.csv
│   │   │   ├── brake_cmaq_cb05_aero5.csv
│   │   │   ├── hot_cold_base.csv
│   │   │   ├── hot_cold_cmaq_cb05_aero5.csv
│   │   │   ├── resuspension_base.csv
│   │   │   ├── resuspension_cmaq_cb05_aero5.csv
│   │   │   ├── road_base.csv
│   │   │   ├── road_cmaq_cb05_aero5.csv
│   │   │   ├── tyre_base.csv
│   │   │   └── tyre_cmaq_cb05_aero5.csv
│   │   └── traffic_area
│   │       ├── evaporative_base.csv
│   │       ├── evaporative_cmaq_cb05_aero5.csv
│   │       ├── small_cities_base.csv
│   │       └── small_cities_cmaq_cb05_aero5.csv
│   └── temporal
│       ├── agricultural_machinery
│       │   ├── hourly_profiles.csv
│       │   ├── monthly_profiles.csv
│       │   └── weekly_profiles.csv
│       ├── agriculture_crop_operations
│       │   ├── hourly_profiles.csv
│       │   ├── monthly_profiles.csv
│       │   └── weekly_profiles.csv
│       ├── agriculture_fertilizers
│       │   └── hourly_profiles.csv
│       ├── livestock
│       │   ├── hourly_profiles.csv
│       │   ├── monthly_profiles.csv
│       │   └── weekly_profiles.csv
│       ├── recreational_boats
│       │   ├── hourly_profiles.csv
│       │   ├── monthly_profiles.csv
│       │   └── weekly_profiles.csv
│       ├── residential
│       │   └── hourly_profiles.csv
│       ├── shipping_port
│       │   ├── hourly_profiles.csv
│       │   ├── monthly_profiles.csv
│       │   └── weekly_profiles.csv
│       ├── traffic_area
│       │   ├── small_cities_hourly_profiles.csv
│       │   ├── small_cities_monthly_profiles.csv
│       │   └── small_cities_weekly_profiles.csv
│       └── tz_world_country_iso3166.csv
└── writing
    ├── global_attributes_CMAQ.csv
    └── global_attributes_WRF-Chem.csv
```

### User-dependent input data

This dataset refers to those files that contain local information for the domain of study (e.g. energy consumption statistics, cultivated crop areas) and that need to be provided by the user.
The user-dependent input dataset provided in the current project covers the region of Catalonia (Spain) and has been created only for testing purposes (original values have been randomly modified).
In order to run HERMESv3_BU in another region of study, the files that the user will have to provide are as follows:

```
hermesv3_bu_data/
├── agriculture
│   ├── agricultural_machinery
│   │   ├── crops_nuts3.csv
│   │   ├── power_equipment.csv
│   │   ├── technology_equipment.csv
│   │   ├── units_equipment.csv
│   │   └── workhours.csv
│   ├── agriculture_fertilizers
│   │   ├── ef
│   │   │   └── crop_fertilizer_types.csv
│   │   ├── fertilized_cultivated_ratio.csv
│   │   └── fertilizer_rate.csv
│   ├── crops_nuts2.csv
│   ├── land_uses_nuts2.csv
│   └── map_crops_landuse.csv
├── aviation
│   ├── airplane_operations.csv
│   ├── Airports.shp
│   ├── Air_Trajectory.shp
│   ├── Runway_Corners.shp
│   └── Runways.shp
├── livestock
│   ├── cattle.csv
│   ├── chicken.csv
│   ├── goats.csv
│   ├── pigs.csv
│   └── sheep.csv
├── point_sources
│   ├── point_sources_catalog.shp
│   ├── plumerise_meteo
│   │   └── hourly
│   │       ├── layer_thickness
│   │       │   └── layer_thickness_2016112900.nc
│   │       ├── mixed_layer_height
│   │       │   └── mixed_layer_height_2016112900.nc
│   │       ├── rmol
│   │       │   └── rmol_2016112900.nc
│   │       ├── t
│   │       │   └── t_2016112900.nc
│   │       ├── t2
│   │       │   └── t2_2016112900.nc
│   │       ├── u
│   │       │   └── u_2016112900.nc
│   │       ├── u10
│   │       │   └── u10_2016112900.nc
│   │       ├── ustar
│   │       │   └── ustar_2016112900.nc
│   │       ├── v
│   │       │   └── v_2016112900.nc
│   │       └── v10
│   │           └── v10_2016112900.nc
│   └── measured_emis
│       └── ENER-090_measured_emissions.csv
├── recreational_boats
│   ├── recreational_boats_area.tif
│   └── recreational_boats.csv
├── residential
│   ├── energy_statistics_nuts2.csv
│   ├── energy_statistics_nuts3.csv
│   ├── population_nuts2.csv
│   └── population_nuts3.csv
├── shipping_port
│   ├── Hotelling.shp
│   ├── Maneuvering.shp
│   └── ship_operations_GT.csv
├── traffic
│   ├── fleet_compo
│   │   └── fleet_compo_profiles.csv
│   └── road_links
│       └── road_network.shp
├── traffic_area
│   ├── gasoline_vehicles_nuts3.csv
│   ├── small_cities.shp
│   └── population_nuts3.csv
├── profiles
│   ├── speciation
│   │   ├── point_sources
│   │   │   ├── speciation_profiles_base.csv
│   │   │   └── speciation_profiles_cmaq_cb05_aero5.csv
│   ├── temporal
│   │   ├── agriculture_fertilizers
│   │   │   └── crop_calendar.csv
│   │   ├── aviation
│   │   │   ├── hourly_profiles.csv
│   │   │   └── weekly_profiles.csv
│   │   ├── point_sources
│   │   │   ├── hourly_profiles.csv
│   │   │   ├── monthly_profiles.csv
│   │   │   └── weekly_profiles.csv
│   │   ├── shipping_port
│   │   │   ├── hourly_profiles.csv
│   │   │   ├── monthly_profiles.csv
│   │   │   └── weekly_profiles.csv
│   │   ├── traffic
│   │   │   ├── aadt_h_mn.csv
│   │   │   ├── aadt_h_sat.csv
│   │   │   ├── aadt_h_sun.csv
│   │   │   ├── aadt_h_wd.csv
│   │   │   ├── aadt_m_mn.csv
│   │   │   ├── aadt_week.csv
│   │   │   └── speed_hourly.csv
│   │   └── traffic_area
│   │       ├── small_cities_hourly_profiles.csv
│   │       ├── small_cities_monthly_profiles.csv
│   │       └── small_cities_weekly_profiles.csv
│   └── vertical
│       └── DEFAULT_5layers_vertical_description.csv
├── meteo_dependent_tempo
│   ├── dailyfactorfertilizer
│   │   ├── alfalfa_2016.nc
│   │   ├── almond_2016.nc
│   │   ├── apple_2016.nc
│   │   ├── apricot_2016.nc
│   │   ├── barley_2016.nc
│   │   ├── cherry_2016.nc
│   │   ├── cotton_2016.nc
│   │   ├── fig_2016.nc
│   │   ├── grape_2016.nc
│   │   ├── lemonlime_2016.nc
│   │   ├── maize_2016.nc
│   │   ├── melonetc_2016.nc
│   │   ├── oats_2016.nc
│   │   ├── olive_2016.nc
│   │   ├── orange_2016.nc
│   │   ├── pea_2016.nc
│   │   ├── peachetc_2016.nc
│   │   ├── pear_2016.nc
│   │   ├── potato_2016.nc
│   │   ├── rice_2016.nc
│   │   ├── rye_2016.nc
│   │   ├── sunflower_2016.nc
│   │   ├── tangetc_2016.nc
│   │   ├── tomato_2016.nc
│   │   ├── triticale_2016.nc
│   │   ├── vetch_2016.nc
│   │   ├── watermelon_2016.nc
│   │   └── wheat_2016.nc
│   ├── dailyfactorlivestock
│   │   ├── grassing_2016.nc
│   │   ├── housing_closed_2016.nc
│   │   ├── housing_open_2016.nc
│   │   └── storage_2016.nc
│   ├── growingdegreeday
│   │   ├── spring_crop_2016.nc
│   │   └── winter_crop_2016.nc
│   └── heatingdegreeday
│       └──hdd_2016.nc
└──  shapefiles
    ├── nuts2
    │   └── nuts2.shp
    └── nuts3
       └── nuts3.shp
```

### External input data

This dataset refers to those open source files that contain global or regional information (e.g. population density, land use map) and that are obtained from third parties.
The external input dataset provided in the current project are clips of the original files and only cover the region of Catalonia (Spain).
In order to run HERMESv3_BU in another region of study, the user will have to download the original files from the following sites:
* Copernicus CORINE Land cover v18_5a 250m (registration is needed)
* FAO Global Livestock World population version 3  
* ISRIC soil grid 
* ECMWF ERA5 datasets 

```
hermesv3_bu_data/
├── agriculture
│   └── agriculture_fertilizers
│       └── isric
│           └── soildgrids250m
│               ├── cec.tif
│               └── ph.tif
├── livestock
│   └── fao
│       └── glwv3
│           ├── cattle.tif
│           ├── chicken.tif
│           ├── goats.tif
│           ├── pigs.tif
│           └── sheep.tif
└── common
    ├── ecmwf
    │   ├── clcv18_5a_g250
    │   │   └── land_uses.tif
    │   └── era5
    │       ├── 1hourly
    │       │   ├── prlr
    │       │   │   └── prlr_201611.nc
    │       │   └── tas
    │       │       └── tas_201611.nc
    │       └── daily_mean
    │           ├── sfcWind
    │           │   └── sfcWind_201611.nc
    │           └── tas
    │               └── tas_201611.nc
    └── jrc
        └── ghsl
            ├── population_density.tif
            └── population_type.tif
```
### Benchmark data

The benchmark comparison data to test the build of the model can be downloaded from here[TO DO LINK].
This dataset contains:
* The hermes_test_case.conf file that needs to be used for executing HERMESv3_BU. This file should replace the hermes.conf file that you get when you download the HERMESv3_BU code[LINK].
* The NetCDF output data file (to be used for comparison with the output you obtain).