Repository navigation
HERMES_GR_InputFiles
This document defines the expected structure, required columns, validation rules, and examples for the input files used by HERMES_GR.
The configuration options that point to these files are documented in HERMES_GR How To Configure. The emission inventory configuration table itself is documented in the Cross Table (CSV) section.
This page focuses on the auxiliary input files used by the HERMES_GR configuration. For an in-depth explanation of the emission inventory datasets themselves, see Emission inventories description.
These files are referenced from the [DOMAIN] section of the HERMES_GR configuration file.
Some CTMs require the emissions NetCDF to follow model-specific metadata conventions. HERMES_GR can provide outputs for MONARCH, CMAQ and WRF-Chem, but only CMAQ and WRF-Chem require a global attributes file.
Choosing CMAQ in the output_model parameter of the DOMAIN section, the output provided by HERMES_GR will follow the IOAPIv3.1 conventions.
The majority of the global attributes are set automatically, but VGLVLS must appear in the global attributes file. If it is not provided, HERMES_GR fills it using the default configuration:
VGLVLS = 1., 0.
Choosing WRF_CHEM in the output_model parameter of the DOMAIN section, the output provided by HERMES_GR will follow the WRF-Chem conventions.
Some of the global attributes needed are automatically set. The following parameters of the global attributes files are the default options if them are not in that file:
attribute,value
BOTTOM-TOP_GRID_DIMENSION,45
GRIDTYPE,C
DIFF_OPT,1
KM_OPT,4
DAMP_OPT,3
DAMPCOEF,0.2
KHDIF,0.
KVDIF,0.
MP_PHYSICS,6
RA_LW_PHYSICS,4
RA_SW_PHYSICS,4
SF_SFCLAY_PHYSICS,2
SF_SURFACE_PHYSICS,2
BL_PBL_PHYSICS,8
CU_PHYSICS,0
SF_LAKE_PHYSICS,0
SURFACE_INPUT_SOURCE,1
SST_UPDATE,0
GRID_FDDA,0
GFDDA_INTERVAL_M,0
GFDDA_END_H,0
GRID_SFDDA,0
SGFDDA_INTERVAL_M,0
SGFDDA_END_H,0
BOTTOM-TOP_PATCH_START_UNSTAG,1
BOTTOM-TOP_PATCH_END_UNSTAG,44
BOTTOM-TOP_PATCH_START_STAG,1
BOTTOM-TOP_PATCH_END_STAG,45
GRID_ID,1
PARENT_ID,0
I_PARENT_START,1
J_PARENT_START,1
PARENT_GRID_RATIO,1
DT,18.
MMINLU,MODIFIED_IGBP_MODIS_NOAH
NUM_LAND_CAT,41
ISWATER,17
ISLAKE,-1
ISICE,15
ISURBAN,13
ISOILWATER,14
The vertical description file is a CSV with only two columns separated by semicolon.
Ilayer;height_magl
1;39
2;78
3;119
4;157
5;197
6;237
7;315
8;390
9;560
10;820
11;1250
12;1870
13;2850
14;5100
15;20100
That example belongs to the 15 layer CMAQ.
| Option | Details |
|---|---|
Ilayer |
Number of the layer starting by 1. |
height_magl |
Top level, in meters, of the selected layer. |
These files are referenced from the [EMISSION_INVENTORY_PROFILES] section of the HERMES_GR configuration file and by the profile columns of the Cross Table (CSV).
| File | Format | Main rule |
|---|---|---|
| Hourly profiles | CSV | Each row must sum to 24. |
| Daily profiles | CSV | Each row must sum to 365 or 366. |
| Weekly profiles | CSV | Each row must sum to 7. |
| Monthly profiles | CSV | Each row must sum to 12. |
| Vertical profiles | CSV | Each profile defines layer heights and weights. |
| Speciation profiles | CSV | Each profile defines output species formulas and metadata. |
| Molecular weights | CSV | Each input pollutant has one molecular weight. |
Temporal profile factors distribute emissions across time. Because the original emission inventories processed by HERMES_GR are reported in kg.m-2.s-1, temporal profile factors are normalized to the number of time steps represented by each profile.
HERMES_GR validates the profile sums during initialization and stops the simulation if a profile does not fulfil the expected total.
For all temporal profile files, the first column is the profile ID and the remaining columns contain numeric temporal factors. Values must be floats or integers.
The hourly profiles file defines the hourly temporal factors for each profile ID. For each profile, the sum of all factors must be equal to 24.
Despite the fact that HERMES_GR estimates emissions in UTC time, note that all the hourly temporal profiles are reported in local standard time. For each grid cell of the working domain, HERMES_GR internally converts the UTC time defined by the user to the corresponding local standard time.
For instance, if the user defines start_date = 2010/01/01 00:00:00 in the configuration file, HERMES_GR will select different hourly temporal factors according to the world time zone of each country/region:
- UK: 0 (UTC)
- ESP: 1 (UTC + 1h)
- MEX: 18 (UTC - 6h)
HERMES_GR also takes into account Daylight Saving Time (DST) changes, which do not necessarily occur on the same date every year and in every country. For instance, if the user defines start_date = 2010/07/01 00:00:00 in the configuration file, the selected hourly temporal factors will change as follows:
- UK: 1 (UTC + 1h)
- ESP: 2 (UTC + 2h)
- MEX: 19 (UTC - 5h)
ID,0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23
H001,1.,1.,1.,1.,1.,1.,1.,1.,1.,1.,1.,1.,1.,1.,1.,1.,1.,1.,1.,1.,1.,1.,1.,1.
H002,0.79,0.72,0.72,0.71,0.74,0.8,0.92,1.08,1.19,1.22,1.21,1.21,1.17,1.15,1.14,1.13,1.1,1.07,1.04,1.02,1.02,1.01,0.96,0.88
H003,0.38,0.36,0.36,0.36,0.37,0.69,1.19,1.53,1.57,1.56,1.35,1.16,1.07,1.06,1,0.98,0.99,1.12,1.41,1.52,1.39,1.35,1.19,0.42
H004,0.75,0.75,0.78,0.82,0.88,0.95,1.02,1.09,1.16,1.22,1.28,1.3,1.22,1.24,1.25,1.16,1.08,1.01,0.95,0.9,0.85,0.81,0.78,0.75
H005,0.5,0.35,0.2,0.1,0.1,0.2,0.75,1.25,1.4,1.5,1.5,1.5,1.5,1.5,1.5,1.5,1.5,1.4,1.25,1.1,1,0.9,0.8,0.7
H006,0.19,0.09,0.06,0.05,0.09,0.22,0.86,1.84,1.86,1.41,1.24,1.2,1.32,1.44,1.45,1.59,2.03,2.08,1.51,1.06,0.74,0.62,0.61,0.44
H007,0.6,0.6,0.6,0.6,0.6,0.65,0.75,0.9,1.1,1.35,1.45,1.6,1.65,1.75,1.7,1.55,1.35,1.1,0.9,0.75,0.65,0.6,0.6,0.6
H008,0.06,0.168,0.192,0.18,0.24,0.192,0.204,0.216,0.336,0.6,1.08,1.8,2.52,3.12,3.12,3.12,2.64,1.68,0.96,0.72,0.42,0.36,0.036,0.036
H009,0.597235,0.552995,0.497696,0.508756,0.575115,0.741014,0.917972,1.15023,1.32719,1.42673,1.45991,1.43779,1.39355,1.37143,1.36037,1.29401,1.24977,1.19447,1.09493,0.973272,0.829493,0.729954,0.685714,0.630415
H010,0.613383,0.557621,0.490706,0.468401,0.479554,0.568773,0.669145,0.814126,0.97026,1.12639,1.22677,1.27138,1.29368,1.3829,1.46097,1.47212,1.46097,1.46097,1.3829,1.23792,1.08178,0.936803,0.847584,0.724907
| Option | Details |
|---|---|
ID |
ID of the hourly profile that appears in the p_hour column of the Cross Table (CSV). The profile ID needs to follow the naming convention: HXXX. |
0 to 23
|
Hourly factor for each hour of the day. |
The daily profiles file defines the daily temporal factors for each profile ID. For each profile, the sum of all factors must be equal to 365 or 366, depending on whether the simulation year is leap or non-leap.
ID,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,137,138,139,140,141,142,143,144,145,146,147,148,149,150,151,152,153,154,155,156,157,158,159,160,161,162,163,164,165,166,167,168,169,170,171,172,173,174,175,176,177,178,179,180,181,182,183,184,185,186,187,188,189,190,191,192,193,194,195,196,197,198,199,200,201,202,203,204,205,206,207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222,223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238,239,240,241,242,243,244,245,246,247,248,249,250,251,252,253,254,255,256,257,258,259,260,261,262,263,264,265,266,267,268,269,270,271,272,273,274,275,276,277,278,279,280,281,282,283,284,285,286,287,288,289,290,291,292,293,294,295,296,297,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,317,318,319,320,321,322,323,324,325,326,327,328,329,330,331,332,333,334,335,336,337,338,339,340,341,342,343,344,345,346,347,348,349,350,351,352,353,354,355,356,357,358,359,360,361,362,363,364,365
D001,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1
D002,0.5,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1
D003,3.14427876472473,3.24422168731689,3.16431975364685,2.7415509223938,2.75758385658264,2.85272240638733,3.40248823165894,3.13399147987366,3.00567245483398,2.92604064941406,2.61825752258301,2.79310417175293,2.80736494064331,2.4142735004425,2.01011276245117,2.25339698791504,3.14531016349792,3.05528044700623,2.65034437179565,3.01638174057007,3.02531218528748,2.75312566757202,2.64230012893677,2.71385312080383,2.34908246994019,2.33163714408875,2.4130482673645,2.16486954689026,1.83078026771545,0.855960845947266,1.73355102539062,2.62159442901611,2.50417160987854,2.10799264907837,2.909827709198,2.92748069763184,3.12294292449951,3.13945364952087,3.18258881568909,2.77711272239685,2.41922330856323,2.24666810035706,1.9712278842926,1.85282206535339,1.49873316287994,1.23413383960724,1.7275767326355,1.72716128826141,2.07724213600159,2.10157537460327,2.58075046539307,1.66518247127533,1.6506724357605,1.48166179656982,1.99437737464905,1.80160796642303,1.19522142410278,1.21702098846436,1.35041439533234,0.981676995754242,0.848678171634674,0.817809879779816,1.18084990978241,1.95513951778412,1.85822868347168,1.43376362323761,0.966481685638428,1.15326988697052,0.932643532752991,0.862170517444611,0.921442627906799,0.99095344543457,1.71480429172516,2.25939893722534,2.19928216934204,1.72081315517426,1.85774409770966,1.35058057308197,1.23751902580261,1.3896244764328,1.18478202819824,1.71665954589844,1.25195288658142,2.02826404571533,1.39557802677155,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.741944074630737,0.935135722160339,1.58248388767242,0.811842501163483,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.546149432659149,0.393509566783905,0.771123230457306,0.910511672496796,0.431994199752808,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.74380624294281,0.72565495967865,0.463243246078491,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.596069037914276,0.832319855690002,0.474188029766083,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.850692689418793,0.719050705432892,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.449079424142838,0.745883047580719,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.677978336811066,0.696524262428284,0.570787310600281,0.393509566783905,0.393509566783905,0.393509566783905,0.393509566783905,0.566010653972626,0.760233819484711,1.03383255004883,1.07040524482727,0.989063501358032,1.03414416313171,1.26143002510071,1.34372019767761,1.56831312179565,1.6423237323761,1.05075860023499,0.654690384864807,1.05146467685699,2.26547002792358,2.32483911514282,2.22279858589172,1.27072727680206,1.14600789546967,1.22469127178192,1.73448550701141,2.40921306610107,2.67673373222351,2.86710786819458,2.28641819953918,2.02244210243225,1.86184930801392,1.60514187812805,2.09168982505798,2.11677074432373,1.59747850894928,1.74225282669067,1.57279908657074,1.53381741046906,1.59356713294983,1.85482966899872,1.19655060768127,0.99366021156311,1.78427350521088,1.83352160453796,1.76202404499054,2.11918663978577,2.0318706035614,2.0173192024231,2.22432851791382,2.41059064865112,2.46313381195068,2.8343358039856,2.76256823539734,2.26326179504395,1.65942275524139,1.71945631504059,1.97526383399963,1.31551706790924
| Option | Details |
|---|---|
ID |
ID of the daily profile that appears in the p_day column of the Cross Table (CSV). The profile ID needs to follow the naming convention: DXXX. |
1 to 365/366
|
Daily factor for each day of the year. Columns must be numbered from 1 to 365 for non-leap years or from 1 to 366 for leap years. |
The weekly profiles file defines the weekly temporal factors for each profile ID. For each profile, the sum of all factors must be equal to 7.
ID,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday,Sunday
W001,1,1,1,1,1,1,1
W002,1.06,1.06,1.06,1.06,1.06,0.85,0.85
W003,1.08,1.08,1.08,1.08,1.08,0.8,0.8
W004,1.2,1.2,1.2,1.2,1.2,0.5,0.5
W005,1.02,1.06,1.08,1.1,1.14,0.81,0.79
| Option | Details |
|---|---|
ID |
ID of the weekly profile that appears in the p_week column of the Cross Table (CSV). The profile ID needs to follow the naming convention: WXXX. |
Monday |
Weekly factor for Mondays. |
Tuesday |
Weekly factor for Tuesdays. |
Wednesday |
Weekly factor for Wednesdays. |
Thursday |
Weekly factor for Thursdays. |
Friday |
Weekly factor for Fridays. |
Saturday |
Weekly factor for Saturdays. |
Sunday |
Weekly factor for Sundays. |
The monthly profiles file defines the monthly temporal factors for each profile ID. For each profile, the sum of all factors must be equal to 12.
ID,January,February,March,April,May,June,July,August,September,October,November,December
M001,1,1,1,1,1,1,1,1,1,1,1,1
M002,1.2,1.15,1.05,1,0.9,0.85,0.8,0.875,0.95,1,1.075,1.15
M003,1.7,1.5,1.3,1,0.7,0.4,0.2,0.4,0.7,1.05,1.4,1.65
M004,1.1,1.075,1.05,1,0.95,0.9,0.93,0.95,0.97,1,1.025,1.05
M005,1.2,1.2,1.2,0.8,0.8,0.8,0.8,0.8,0.8,1.2,1.2,1.2
M006,0.95,0.96,1.02,1,1.01,1.03,1.03,1.01,1.04,1.03,1.01,0.91
M007,0.88,0.92,0.98,1.03,1.05,1.06,1.01,1.02,1.06,1.05,1.01,0.93
M008,0.88,0.92,0.98,1.03,1.05,1.06,1.01,1.02,1.06,1.05,1.01,0.93
M009,0.45,1.3,2.35,1.7,0.85,0.85,0.85,1,1.1,0.65,0.45,0.45
| Option | Details |
|---|---|
ID |
ID of the monthly profile that appears in the p_month column of the Cross Table (CSV). The profile ID needs to follow the naming convention: MXXX. |
January to December
|
Monthly factor for each month of the year. Month columns can use full names, abbreviations, or numeric values from 1 to 12. |
The vertical profiles file contains the vertical distribution profiles used to allocate emissions across model layers.
ID;layers;weights
V001;36,72,108,144,218,292,366,440,514,588,724,896,1050,1204,1358;0,0,0,0,0.1,0.32,0.31,0.15,0.06,0.03,0.03,0,0,0,0
V002;36,72,108,144,218,292,366,440,514,588,724,896,1050,1204,1358;0,0.18,0.47,0.25,0.08,0.02,0,0,0,0,0,0,0,0,0
V003;10,1000;0.6,0.4
V004;1000,9000;0,1
V005;9000,12000;0,1
V006;36,72,108,144,218,292,366,440,514,588,724,896,1050,1204,1358;0,0,0.02,0.26,0.56,0.13,0.03,0,0,0,0,0,0,0,0
| Option | Details |
|---|---|
ID |
ID of the vertical profile that appears in the p_vertical column of the Cross Table (CSV). |
layers |
List of top levels to distribute the emission on the vertical layers, separated by commas. |
weights |
Weight for each distributed emission. This parameter must have the same length as the layers parameter. |
The speciation profiles file is where the user defines the expressions to convert primary pollutant species to specific chemical mechanism species for each ID profile. HERMES_GR can map base pollutants to several gas-phase and aerosol chemical mechanisms, including CB05, CB05e51, RADM2, AERO5, AERO6 and MADE/SORGAM.
Note that the name and number of columns will vary according to the chemical mechanism. The names and units of the pollutants in the emission output file estimated by HERMES_GR will be the same as the ones defined in the file.
Example of the CMAQ CB05 and AERO5 speciation profile.
ID;NO;NO2;HONO;CO;SO2;NH3;ALD2;ALDX;BENZENE;ETH;ETHA;ETOH;FORM;IOLE;ISOP;MEOH;OLE;PAR;SESQ;TERP;TOL;XYL;DMS;HCL;SULF;POC;PEC;PNO3;PSO4;PMFINE;PMC
units;mol.s-1;mol.s-1;mol.s-1;mol.s-1;mol.s-1;mol.s-1;mol.s-1;mol.s-1;mol.s-1;mol.s-1;mol.s-1;mol.s-1;mol.s-1;mol.s-1;mol.s-1;mol.s-1;mol.s-1;mol.s-1;mol.s-1;mol.s-1;mol.s-1;mol.s-1;mol.s-1;mol.s-1;mol.s-1;g.s-1;g.s-1;g.s-1;g.s-1;g.s-1;g.s-1
short_description;nitrogen_monoxide;nitrogen_dioxide;nitrous_acid;carbon_monoxide;sulfur_dioxide;ammonia;acetaldehyde;higher_aldehydes;benzene;ethene;ethane;ethanol;formaldehyde;internal_olefin_carbon_bond;isoprene;methanol;terminal_olefin_carbon_bond;paraffin_carbon_bond;sesquiterpenes;terpene;toluene;xylene;dimethyl_sulfide;hydrogen_chloride;sulfuric_acid;primary_organic_carbon;primary_elemental_carbon;primary_nitrate_fine;primary_sulfate_fine;primary_others_fine;pm_coarse
E001;0.72*nox_no;0.18*nox_no;0.1*nox_no;co;so2;nh3;c2h4o;0;c6h6;c2h4;c2h6;c2h5oh;0;0.5*hialkenes;c5h8;ch3oh;c8h16+c5h10+c3h6+c4h8+c6h12+0.5*hialkanes;4*c4h10+6*c6h14+5*hialkanes+6*c8h16+3*c5h10+c3h6+3*c3h6o+2*c4h8+7*c7h16+4*c6h12+hialkenes+5*c5h12+1.5*c3h8;0;terpenes;ch2o+c7h8;c8h10;c2h6s;0;0;oc;5.9*bc;0;0;3.3*pm25-3*oc-5.9*bc;0
E002;0.9*nox_no2;0.1*nox_no2;0;co;so2;nh3;0.625*voc22;0.375*voc22;voc13;voc07;voc02;0.5*voc01;voc21;0.666*voc12;0;0.5*voc01;voc08+0.333*voc12;1.5*voc03+4*voc04+5*voc05+7.5*voc06+voc08+voc09+voc13+voc16+2.2*voc17+1.875*voc22+4*voc23+voc24;0;0;voc14+0.2*voc17;voc15+voc16+voc17;0;0;0;oc;bc;0;(pm25-oc-bc)*0.155;(pm25-oc-bc)*0.845;pm10-pm25
E003;0.9*nox_no2;0.1*nox_no2;0;co;so2;nh3;0.625*voc22;0.01*voc18+0.3*voc19+0.375*voc22;voc13;voc07;voc02;0.5*voc01;voc21;0.666*voc12;0;0.5*voc01;voc08+0.333*voc12;1.5*voc03+4*voc04+5*voc05+7.5*voc06+voc08+voc09+voc13+voc16+2.2*voc17+4.11*voc18+4*voc19+1.875*voc22+4*voc23+voc24;0;0;voc14+0.2*voc17;voc15+voc16+voc17;0;0;0;oc;bc;0;(pm25-oc-bc)*0.089;(pm25-oc-bc)*0.911;pm10-pm25
E004;0.9*nox_no2;0.1*nox_no2;0;co;so2;nh3;0.625*voc22;0.3*voc19+0.375*voc22;voc13;voc07;voc02;0.5*voc01;voc21;0.666*voc12;0;0.5*voc01;voc08+0.333*voc12;1.5*voc03+4*voc04+5*voc05+7.5*voc06+voc08+voc09+voc13+voc16+2.2*voc17+4*voc19+1.875*voc22+4*voc23+voc24;0;0;voc14+0.2*voc17;voc15+voc16+voc17;0;0;0;oc;bc;0;(pm25-oc-bc)*0.047;(pm25-oc-bc)*0.953;pm10-pm25
| Option | Details |
|---|---|
ID |
ID of the speciation profile that appears in the p_speciation column of the Cross Table (CSV). |
output_pollutant_name columns |
Formula to calculate the output pollutant using the input pollutant that appears in the pollutants column of the Cross Table (CSV). |
units |
Units of the output pollutants. |
short_description |
Description of the pollutant species. |
The molecular weights file contains the molecular weight of each input pollutant. HERMES_GR uses this information to perform mass-to-mole conversions for gas species. For aerosol species, the molecular weight is set to 1.
Specie;MW
nox_no;30.01
nox_no2;46.01
co;28.01
so2;64.06
nh3;17.03
pm10;1.0
pm25;1.0
pm25_bio;1
oc;1.0
bc;1.0
c2h6s;62.13
hcl;36.46
c2h2;26.04
ch3cooh;60.05
c2h4o;44.05
c4h10;58.12
c2h5oh;46.07
ch2o;30.03
c6h14;86.18
hialkanes;118.89
c5h8;68.12
c8h16;112.21
c5h10;70.13
c3h6;42.08
c7h8;92.14
c8h10;106.17
c3h6o;58.08
c6h6;78.11
c4h8;56.11
c2h6;30.07
c2h4;28.05
c7h16;100.2
c6h12;84.16
hialkenes;75.78
ch3oh;32.04
c5h12;72.15
c3h8;44.1
terpenes;160.0
voc01;46.2
voc02;30.07
voc03;44.1
voc04;58.12
voc05;72.15
voc06;106.8
voc07;28.05
voc08;42.08
voc09;26.04
voc10;68.12
voc11;136.24
voc12;67
voc13;78.11
voc14;92.14
voc15;106.17
voc16;120.0
voc17;126.8
voc18;104.7
voc19;81.5
voc20;138.8
voc21;30.03
voc22;68.8
voc23;75.3
voc24;59.1
voc25;86.9
| Option | Details |
|---|---|
Specie |
Name of the input pollutant. |
MW |
Molecular weight (g/mol). |
HERMES_GR can use gridded temporal profiles (i.e. temporal weights that vary per grid cell) to account for the variation of the temporal distribution of emissions across countries and/or regions due to climatological or sociodemographic factors, among others.
Gridded temporal profiles must be provided in NetCDF format and must follow the domain description (resolution and geographical area covered) defined in the DOMAIN section.
The weight factors must be reported under a variable called Fmonth for monthly profiles, Fweek for weekly profiles, Fday for daily profiles or Fhour for hourly profiles. The sum of all factors must be equal to 12, 7, 365/366 or 24, respectively.
During the initialization of the system, HERMES_GR verifies that the sum of the profiles and the domain description is correct. If one or more profiles do not fulfil the criterion, an error message will occur and the simulation will stop.
The world_info file used by previous HERMES_GR versions is deprecated in HERMES_GR v3.0.0 and is not required for regular model runs.
Some preprocessing tools may still expose a --world_info_path argument when they require legacy mapping input. In that case, follow the specific preprocessing page for that inventory.