Difference between revisions of "HEMCO data directories"
(→Emissions implemented as HEMCO extensions) |
(→HEMCO data directory structure) |
||
Line 94: | Line 94: | ||
:{| border=1 cellspacing=0 cellpadding=5 | :{| border=1 cellspacing=0 cellpadding=5 | ||
|-valign="top" | |-valign="top" | ||
− | |width="225px" bgcolor="#00FF00"| | + | |width="225px" bgcolor="#00FF00"|DEFAULT SETTING |
|width="785px"|Denotes that the data set is part of the standard emissions configuration for GEOS-Chem, that is: | |width="785px"|Denotes that the data set is part of the standard emissions configuration for GEOS-Chem, that is: | ||
*It is used in the GEOS-Chem 1-month and 1-year full-chemistry [http://acmg.seas.harvard.edu/geos/geos_benchmark.html benchmark simulations], or | *It is used in the GEOS-Chem 1-month and 1-year full-chemistry [http://acmg.seas.harvard.edu/geos/geos_benchmark.html benchmark simulations], or | ||
Line 120: | Line 120: | ||
|} | |} | ||
− | :If use GEOS-Chem, then we recommend that you download the data sets that are listed as | + | :If use GEOS-Chem, then we recommend that you download the data sets that are listed as DEFAULT SETTING, as these form the standard GEOS-Chem emissions configuration. You are free, however, to use any of the data sets listed below. Your choice of data sets will depend on your particular research needs. |
--[[User:Bmy|Bob Y.]] 10:53, 18 March 2015 (EDT) | --[[User:Bmy|Bob Y.]] 10:53, 18 March 2015 (EDT) | ||
Line 143: | Line 143: | ||
|<tt>$ROOT/SOA/2014-07</tt> | |<tt>$ROOT/SOA/2014-07</tt> | ||
|3.0 MB | |3.0 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Contain various inputs for SOA simulations. | *Contain various inputs for SOA simulations. | ||
Line 175: | Line 175: | ||
|<tt>$ROOT/AFCID/2018-04</tt> | |<tt>$ROOT/AFCID/2018-04</tt> | ||
|4.4 MB | |4.4 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Introduced in [[GEOS-Chem 12#12.1.0|GEOS-Chem 12.1.0]]. | *Introduced in [[GEOS-Chem 12#12.1.0|GEOS-Chem 12.1.0]]. | ||
*In [[GEOS-Chem 12#12.5.0|GEOS-Chem 12.5.0]] AFCID was separated from the DEAD dust emissions extension to allow for use with offline dust emissions as well. | *In [[GEOS-Chem 12#12.5.0|GEOS-Chem 12.5.0]] AFCID was separated from the DEAD dust emissions extension to allow for use with offline dust emissions as well. | ||
Line 185: | Line 185: | ||
|<tt>$ROOT/CEDS/v2020-08</tt> | |<tt>$ROOT/CEDS/v2020-08</tt> | ||
|73 GB | |73 GB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Introduced in [[GEOS-Chem 13.0.0|13.0.0]] | *Introduced in [[GEOS-Chem 13.0.0|13.0.0]] | ||
*Reference: McDuffie et al 2020, ESSD | *Reference: McDuffie et al 2020, ESSD | ||
Line 194: | Line 194: | ||
|<tt>$ROOT/C2H6_2010/v2019-06</tt> | |<tt>$ROOT/C2H6_2010/v2019-06</tt> | ||
|536 KB | |536 KB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Introduced in [[GEOS-Chem v11-02#v11-02f|v11-02f]] | *Introduced in [[GEOS-Chem v11-02#v11-02f|v11-02f]] | ||
*Overwrites the C2H6 emissions from the CEDS to address underestimates | *Overwrites the C2H6 emissions from the CEDS to address underestimates | ||
Line 204: | Line 204: | ||
|<tt>$ROOT/XIAO/v2014-09</tt> | |<tt>$ROOT/XIAO/v2014-09</tt> | ||
|308 KB | |308 KB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Overwrites the C3H8 emissions from CEDS to address underestimates | *Overwrites the C3H8 emissions from CEDS to address underestimates | ||
Line 301: | Line 301: | ||
|<tt>$ROOT/AEIC/v2015-01</tt> | |<tt>$ROOT/AEIC/v2015-01</tt> | ||
|2.0 GB | |2.0 GB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Default global aircraft emissions inventory. | *Default global aircraft emissions inventory. | ||
*Contains fuel burned, NO, CO, and hydrocarbons. | *Contains fuel burned, NO, CO, and hydrocarbons. | ||
Line 310: | Line 310: | ||
|<tt>$ROOT/CEDS/v2020-08</tt> | |<tt>$ROOT/CEDS/v2020-08</tt> | ||
|73 GB | |73 GB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Stored together w/ other CEDS data files. | *Stored together w/ other CEDS data files. | ||
Line 384: | Line 384: | ||
|<tt>$ROOT/GFED4/v2020-04</tt> | |<tt>$ROOT/GFED4/v2020-04</tt> | ||
|867 MB | |867 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*This is GFED v4.1, which is the default in [[GEOS-Chem v11-01|v11-01]] and higher versions | *This is GFED v4.1, which is the default in [[GEOS-Chem v11-01|v11-01]] and higher versions | ||
*Monthly-mean data is available from 1998-2019 | *Monthly-mean data is available from 1998-2019 | ||
Line 487: | Line 487: | ||
|<tt>$ROOT/OFFLINE_DUST/v2019-01</tt> | |<tt>$ROOT/OFFLINE_DUST/v2019-01</tt> | ||
|18 GB | |18 GB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Introduced in [[GEOS-Chem 12#12.5.0|12.5.0]] | *Introduced in [[GEOS-Chem 12#12.5.0|12.5.0]] | ||
Line 495: | Line 495: | ||
|<tt>$ROOT/OFFLINE_BIOVOC/v2019-01</tt> | |<tt>$ROOT/OFFLINE_BIOVOC/v2019-01</tt> | ||
|1006 GB | |1006 GB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Introduced in [[GEOS-Chem 12#12.5.0|12.5.0]] | *Introduced in [[GEOS-Chem 12#12.5.0|12.5.0]] | ||
Line 503: | Line 503: | ||
|<tt>$ROOT/OFFLINE_SEASALT/v2019-01</tt> | |<tt>$ROOT/OFFLINE_SEASALT/v2019-01</tt> | ||
|848 GB | |848 GB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Introduced in [[GEOS-Chem 12#12.5.0|12.5.0]] | *Introduced in [[GEOS-Chem 12#12.5.0|12.5.0]] | ||
Line 511: | Line 511: | ||
|<tt>$ROOT/OFFLINE_SOILNOX/v2019-01</tt> | |<tt>$ROOT/OFFLINE_SOILNOX/v2019-01</tt> | ||
|46 GB | |46 GB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Introduced in [[GEOS-Chem 12#12.5.0|12.5.0]] | *Introduced in [[GEOS-Chem 12#12.5.0|12.5.0]] | ||
Line 535: | Line 535: | ||
|<tt>$ROOT/ACET/v2014-07</tt> | |<tt>$ROOT/ACET/v2014-07</tt> | ||
|52 KB | |52 KB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
|-valign="top" | |-valign="top" | ||
Line 542: | Line 542: | ||
|<tt>$ROOT/ALD2/v2017-03</tt> | |<tt>$ROOT/ALD2/v2017-03</tt> | ||
|52 KB | |52 KB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
|-valign="top" | |-valign="top" | ||
Line 549: | Line 549: | ||
|<tt>$ROOT/DMS/v2015-07</tt> | |<tt>$ROOT/DMS/v2015-07</tt> | ||
|3.0 MB | |3.0 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*This is the default in [[GEOS-Chem v11-01|v11-01]] and higher versions | *This is the default in [[GEOS-Chem v11-01|v11-01]] and higher versions | ||
*Uses Lana 2011 climatology | *Uses Lana 2011 climatology | ||
Line 558: | Line 558: | ||
|<tt>$ROOT/OFFLINE_LIGHTNING/v2019-01/</tt> | |<tt>$ROOT/OFFLINE_LIGHTNING/v2019-01/</tt> | ||
|47 GB | |47 GB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Introduced in [[GEOS-Chem 12#12.5.0|12.5.0]] | *Introduced in [[GEOS-Chem 12#12.5.0|12.5.0]] | ||
Line 566: | Line 566: | ||
|<tt>$ROOT/PARANOX/v2015-02</tt> | |<tt>$ROOT/PARANOX/v2015-02</tt> | ||
|162 MB | |162 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Computes the aging of emissions in ship exhaust plumes. | *Computes the aging of emissions in ship exhaust plumes. | ||
Line 574: | Line 574: | ||
|<tt>$ROOT/VOLCANO/v2019-08</tt> | |<tt>$ROOT/VOLCANO/v2019-08</tt> | ||
|660 MB | |660 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Updated in [[GEOS-Chem 12#12.6.0|12.6.0]] | *Updated in [[GEOS-Chem 12#12.6.0|12.6.0]] | ||
Line 682: | Line 682: | ||
|<tt>$ROOT/OFFLINE_AEROSOL/v2014-09</tt> | |<tt>$ROOT/OFFLINE_AEROSOL/v2014-09</tt> | ||
|165 MB | |165 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
|-valign="top" | |-valign="top" | ||
Line 689: | Line 689: | ||
|<tt>$ROOT/CH4/v2017-10</tt><br><tt>$ROOT/CH4/v2014-09</tt> | |<tt>$ROOT/CH4/v2017-10</tt><br><tt>$ROOT/CH4/v2014-09</tt> | ||
|274 MB | |274 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
|-valign="top" | |-valign="top" | ||
Line 696: | Line 696: | ||
|<tt>$ROOT/CO2/v2015-04<br>$ROOT/CO2/v2015-04/BIO/<br>$ROOT/CO2/v2015-04/BIOFUEL/<br>$ROOT/CO2/v2015-04/CHEM/<br>$ROOT/CO2/v2015-04/FOSSIL/<br>$ROOT/CO2/v2015-04/OCEAN/</tt> | |<tt>$ROOT/CO2/v2015-04<br>$ROOT/CO2/v2015-04/BIO/<br>$ROOT/CO2/v2015-04/BIOFUEL/<br>$ROOT/CO2/v2015-04/CHEM/<br>$ROOT/CO2/v2015-04/FOSSIL/<br>$ROOT/CO2/v2015-04/OCEAN/</tt> | ||
|1033 MB | |1033 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
|-valign="top" | |-valign="top" | ||
Line 703: | Line 703: | ||
|<tt>$ROOT/MERCURY/v2014-09<br>$ROOT/MERCURY/v2014-09/ARTISANAL<br>$ROOT/MERCURY/v2014-09/BrOx<br>$ROOT/MERCURY/v2014-09/Hg2_PARTITION<br>$ROOT/MERCURY/v2014-09/JVALUES<br>$ROOT/MERCURY/v2014-09/NATURAL<br>$ROOT/MERCURY/v2014-09/NEI2005<br>$ROOT/MERCURY/v2014-09/OCEAN<br>$ROOT/MERCURY/v2014-09/SOIL<br>$ROOT/MERCURY/v2014-09/STREETS</tt> | |<tt>$ROOT/MERCURY/v2014-09<br>$ROOT/MERCURY/v2014-09/ARTISANAL<br>$ROOT/MERCURY/v2014-09/BrOx<br>$ROOT/MERCURY/v2014-09/Hg2_PARTITION<br>$ROOT/MERCURY/v2014-09/JVALUES<br>$ROOT/MERCURY/v2014-09/NATURAL<br>$ROOT/MERCURY/v2014-09/NEI2005<br>$ROOT/MERCURY/v2014-09/OCEAN<br>$ROOT/MERCURY/v2014-09/SOIL<br>$ROOT/MERCURY/v2014-09/STREETS</tt> | ||
|342 MB | |342 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
|-valign="top" | |-valign="top" | ||
Line 710: | Line 710: | ||
|<tt>$$ROOT/POPs/v2015-08</tt> | |<tt>$$ROOT/POPs/v2015-08</tt> | ||
|809 MB | |809 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Data corresponds to the [[POPs_simulation#Updates_to_PAH_code|POPs simulation update in v11-01c]] | *Data corresponds to the [[POPs_simulation#Updates_to_PAH_code|POPs simulation update in v11-01c]] | ||
Line 718: | Line 718: | ||
|<tt>$ROOT/RRTMG/v2018-11</tt> | |<tt>$ROOT/RRTMG/v2018-11</tt> | ||
|19 MB | |19 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Used in [[GEOS-Chem 12#12.1.0|GEOS-Chem 12.1.0]] and later versions | *Used in [[GEOS-Chem 12#12.1.0|GEOS-Chem 12.1.0]] and later versions | ||
Line 726: | Line 726: | ||
|<tt>$ROOT/TAGGED_CO/v2017-04</tt> | |<tt>$ROOT/TAGGED_CO/v2017-04</tt> | ||
|260 KB | |260 KB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Contains files for the updated Tagged CO simulation in [[GEOS-Chem v11-02]] | *Contains files for the updated Tagged CO simulation in [[GEOS-Chem v11-02]] | ||
Line 734: | Line 734: | ||
|<tt>$ROOT/TAGGED_O3/v2014-09</tt> | |<tt>$ROOT/TAGGED_O3/v2014-09</tt> | ||
|372 MB | |372 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
|-valign="top" | |-valign="top" | ||
Line 741: | Line 741: | ||
|<tt>$ROOT/O3/v2014-09</tt> | |<tt>$ROOT/O3/v2014-09</tt> | ||
|130 MB | |130 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
|-valign="top" | |-valign="top" | ||
Line 748: | Line 748: | ||
|<tt>$ROOT/OH/v2014-09<br>$ROOT/OH/v2014-09/v5-07-08<br>$ROOT/OH/v2014-09/v7-02-03.GMI</tt> | |<tt>$ROOT/OH/v2014-09<br>$ROOT/OH/v2014-09/v5-07-08<br>$ROOT/OH/v2014-09/v7-02-03.GMI</tt> | ||
|148 MB | |148 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
|-valign="top" | |-valign="top" | ||
Line 755: | Line 755: | ||
|<tt>$ROOT/OXIDANTS/v2014-07</tt> | |<tt>$ROOT/OXIDANTS/v2014-07</tt> | ||
|32 MB | |32 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
|-valign="top" | |-valign="top" | ||
Line 762: | Line 762: | ||
|<tt>$ROOT/CHLA/v2014-07</tt> | |<tt>$ROOT/CHLA/v2014-07</tt> | ||
|2.0 MB | |2.0 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
|-valign="top" | |-valign="top" | ||
Line 813: | Line 813: | ||
|<tt>$ROOT/BROMINE/v2015-02</tt> | |<tt>$ROOT/BROMINE/v2015-02</tt> | ||
|156 KB | |156 KB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
|-valign="top" | |-valign="top" | ||
Line 820: | Line 820: | ||
|<tt>$ROOT/IODINE/v2017-09</tt> | |<tt>$ROOT/IODINE/v2017-09</tt> | ||
|4.4 MB | |4.4 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Introduced in [[GEOS-Chem v11-02|v11-02]] | *Introduced in [[GEOS-Chem v11-02|v11-02]] | ||
Line 842: | Line 842: | ||
|<tt>$ROOT/NH3/v2014-07</tt> | |<tt>$ROOT/NH3/v2014-07</tt> | ||
|8.1 MB | |8.1 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
|-valign="top" | |-valign="top" | ||
Line 849: | Line 849: | ||
|<tt>HEMCO/NH3/v2018-04/</tt> | |<tt>HEMCO/NH3/v2018-04/</tt> | ||
|104 MB | |104 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Introduced in [[GEOS-Chem v11-02#v11-02f|v11-02f]] | *Introduced in [[GEOS-Chem v11-02#v11-02f|v11-02f]] | ||
Line 857: | Line 857: | ||
|<tt>$ROOT/ALD2/v2017-03</tt> | |<tt>$ROOT/ALD2/v2017-03</tt> | ||
|8.1 MB | |8.1 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
|} | |} | ||
Line 883: | Line 883: | ||
|<tt>$ROOT/TIMEZONES/v2015-02</tt> | |<tt>$ROOT/TIMEZONES/v2015-02</tt> | ||
|264 KB | |264 KB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Used by HEMCO to compute emissions that depend on local time rather than on UTC time. | *Used by HEMCO to compute emissions that depend on local time rather than on UTC time. | ||
Line 891: | Line 891: | ||
|<tt>$ROOT/UVALBEDO/v2019-06</tt> | |<tt>$ROOT/UVALBEDO/v2019-06</tt> | ||
|476 KB | |476 KB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Required inputs for the [[FAST-JX v7.0 photolysis mechanism]] | *Required inputs for the [[FAST-JX v7.0 photolysis mechanism]] | ||
Line 899: | Line 899: | ||
|<tt>$ROOT/TOMS_SBUV/v2019-06</tt> | |<tt>$ROOT/TOMS_SBUV/v2019-06</tt> | ||
|21 MB | |21 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Ignored if you are using [[GEOS-FP]] or [[MERRA-2]] meteorology. | *Ignored if you are using [[GEOS-FP]] or [[MERRA-2]] meteorology. | ||
Line 907: | Line 907: | ||
|<tt>$ROOT/STRAT/v2015-01/Bry</tt> | |<tt>$ROOT/STRAT/v2015-01/Bry</tt> | ||
|385 MB | |385 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Required for the for the full-chemistry simulations. | *Required for the for the full-chemistry simulations. | ||
Line 915: | Line 915: | ||
|<tt>$ROOT/GMI/v2015-02</tt> | |<tt>$ROOT/GMI/v2015-02</tt> | ||
|16 GB | |16 GB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Used to compute P & L of species in the stratosphere. | *Used to compute P & L of species in the stratosphere. | ||
Line 923: | Line 923: | ||
|<tt>$ROOT/UCX/v2018-02</tt> | |<tt>$ROOT/UCX/v2018-02</tt> | ||
|12 GB | |12 GB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Used to compute P & L of species in the stratosphere. | *Used to compute P & L of species in the stratosphere. | ||
*Can be used instead of GMI. | *Can be used instead of GMI. | ||
Line 932: | Line 932: | ||
|<tt>$ROOT/MODIS_XLAI/v2017-07</tt> | |<tt>$ROOT/MODIS_XLAI/v2017-07</tt> | ||
|203 MB | |203 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|TDEFAULT SETTING |
*Added in [[GEOS-Chem 12#12.3.0|GEOS-Chem 12.3.0]] | *Added in [[GEOS-Chem 12#12.3.0|GEOS-Chem 12.3.0]] | ||
Line 940: | Line 940: | ||
|<tt>$ROOT/OLSON_MAP/v2019-02</tt> | |<tt>$ROOT/OLSON_MAP/v2019-02</tt> | ||
|1.9 MB | |1.9 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|TDEFAULT SETTING |
*Added in [[GEOS-Chem 12#12.3.0|GEOS-Chem 12.3.0]] | *Added in [[GEOS-Chem 12#12.3.0|GEOS-Chem 12.3.0]] | ||
*Used for regridding of MODIS_XLAI or Yuan_XLAI via HEMCO | *Used for regridding of MODIS_XLAI or Yuan_XLAI via HEMCO | ||
Line 949: | Line 949: | ||
|<tt>$ROOT/Yuan_XLAI/v2019-03</tt> | |<tt>$ROOT/Yuan_XLAI/v2019-03</tt> | ||
|203 MB | |203 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|TDEFAULT SETTING |
*Added as option in [[GEOS-Chem 12#12.3.0|GEOS-Chem 12.3.0]] | *Added as option in [[GEOS-Chem 12#12.3.0|GEOS-Chem 12.3.0]] | ||
Line 985: | Line 985: | ||
|<tt>$ROOT/AnnualScalar/v2014-07</tt> | |<tt>$ROOT/AnnualScalar/v2014-07</tt> | ||
|3.0 MB | |3.0 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Used to scale NEI2005 and other emissions to years other than the inventory base year. | *Used to scale NEI2005 and other emissions to years other than the inventory base year. | ||
Line 993: | Line 993: | ||
|<tt>$ROOT/NEI2005/v2014-09</tt> | |<tt>$ROOT/NEI2005/v2014-09</tt> | ||
|8.1 MB | |8.1 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
|-valign="top" | |-valign="top" | ||
Line 1,000: | Line 1,000: | ||
|<tt>$ROOT/COUNTRY_ID/v2015-04</tt> | |<tt>$ROOT/COUNTRY_ID/v2015-04</tt> | ||
|15 MB | |15 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*[http://www.nationsonline.org/oneworld/country_code_list.htm ISO ALPHA-3 standard] country codes are contained on an 0.1° x 0.1° grid. HEMCO can use these ID's to apply country-level scale factors to any emissions field. | *[http://www.nationsonline.org/oneworld/country_code_list.htm ISO ALPHA-3 standard] country codes are contained on an 0.1° x 0.1° grid. HEMCO can use these ID's to apply country-level scale factors to any emissions field. | ||
Line 1,008: | Line 1,008: | ||
|<tt>$ROOT/MASKS/v2014-07</tt> | |<tt>$ROOT/MASKS/v2014-07</tt> | ||
|51 MB | |51 MB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
*Masks define the geographical regions where the various regional emissions (e.g. BRAVO, CAC, NEI) are to be applied. | *Masks define the geographical regions where the various regional emissions (e.g. BRAVO, CAC, NEI) are to be applied. | ||
Line 1,016: | Line 1,016: | ||
|<tt>$ROOT/MAP_A2A/v2014-07</tt> | |<tt>$ROOT/MAP_A2A/v2014-07</tt> | ||
|152 KB | |152 KB | ||
− | |bgcolor="#00FF00"| | + | |bgcolor="#00FF00"|DEFAULT SETTING |
|-valign="top" | |-valign="top" |
Revision as of 16:48, 3 December 2020
On this page we describe the directory tree from which the HEMCO emissions component can read emissions inventories and other atmospheric data sets.
Contents
- 1 Overview
- 2 Downloading the HEMCO data directories
- 3 Default GEOS-Chem emissions configurations
- 4 HEMCO data directory structure
- 4.1 Aerosol emissions
- 4.2 Anthropogenic and biofuel emissions
- 4.3 Anthropogenic aircraft and ship emissions
- 4.4 Biomass burning emissions
- 4.5 Offline grid-independent emissions
- 4.6 Emissions implemented as HEMCO extensions
- 4.7 Future and historical emissions
- 4.8 GEOS-Chem specialty simulation data
- 4.9 Halogen emissions
- 4.10 Natural emissions data
- 4.11 Non-emissions data
- 4.12 Other inputs for HEMCO
- 5 The hemco_data_download package
- 6 Submitting new data for use with HEMCO
Overview
The HEMCO emissions component can read several types of emission inventories, as well as other types atmospheric data sets, such as production and loss rates, or concentration data. We have collated all of this data into a comprehensive directory tree structure. Each folder of the HEMCO data directory tree represents a particular emissions inventory or other data set.
At present, the HEMCO data directory tree resides on the disk servers at Harvard University (and soon at Dalhousie University). We have created a package that will let you download this directory tree to your local disk storage space. For more information, please see the Downloading the HEMCO data directories section below.
Please see our list of recommended default emission inventories, which has been compiled by the Emissions and Deposition Working Group.
--Bob Yantosca (talk) 22:27, 7 September 2017 (UTC)
Downloading the HEMCO data directories
We recommend the following methods for downloading the HEMCO data directories, depending on which GEOS-Chem version you are using:
GEOS-Chem versions | Recommended download method | Alternate download method |
---|---|---|
12.7.0 and later | The GEOS-Chem dry-run option | Manual download from either |
12.6.3 and prior | The hemco_data_download package | Manual download from either |
--Bob Yantosca (talk) 15:24, 14 January 2020 (UTC)
Default GEOS-Chem emissions configurations
Christoph Keller and the GEOS-Chem Support Team have prepared documents describing the standard GEOS-Chem emissions configurations for recent GEOS-Chem versions. These emissions configurations are specified in the HEMCO configuration file (aka HEMCO_Config.rc), which is read by GEOS-Chem at startup.
Configuration | Released | Notes |
---|---|---|
Default emissions configuration for GEOS-Chem 12.6.0 | 21 Oct 2019 | |
Default emissions configuration for GEOS-Chem 12.3.0 | 01 Apr 2019 | Also applies to GEOS-Chem 12.3.1 |
Default emissions configuration for GEOS-Chem 12.2.0 | 19 Feb 2019 | Also applies to GEOS-Chem 12.2.1 |
Default emissions configuration for GEOS-Chem 12.1.0 | 26 Nov 2018 | Also applies to GEOS-Chem 12.1.1 |
Default emissions configuration for GEOS-Chem 12.0.0 | 10 Aug 2018 | Also applies to GEOS-Chem 12.0.1, 12.0.2, and 12.0.3 |
Information about each individual inventory or data source may be found in the following sections.
HEMCO data directory structure
The sections below describe each of the data sets contained in the HEMCO directory tree, grouped by type.
In each of the tables below:
- The Inventory column contains a link that describes each data set in more detail. Most of these links point to existing pages on the GEOS-Chem wiki.
- The Data file info column points to the README files that are stored with each data set. Each README provides a list of the files contained within a given folder, information about the data contained in each file, and (often) a description of how the files were created.
- The Path column shows the location of each data set, with respect to $ROOT, the top-level HEMCO directory. For example, on the Harvard disk server, $ROOT points to the directory /mnt/gcgrid/data/ExtData/HEMCO/.
- The Status column describes the current status of each data set:
DEFAULT SETTING Denotes that the data set is part of the standard emissions configuration for GEOS-Chem, that is: - It is used in the GEOS-Chem 1-month and 1-year full-chemistry benchmark simulations, or
- It is used in one or more of the GEOS-Chem specialty simulations.
OPTIONAL Denotes that the data set is not part of the the standard GEOS-Chem emissions configuration. - But you can still use the data set in your research applications if you wish.
TO BE ADDED SOON Denotes that the data set is not yet ready for use with HEMCO, but will be added soon. OBSOLETE Denotes that the data set has been removed from the standard GEOS-Chem emissions configuration. - In most cases, OBSOLETE means that a newer version of the data is available and should be used instead.
NOT USED Denotes that the data set is not used in the standard GEOS-Chem emissions configuration, even if it is current. - For example, another data source is being used in place of this data set for a particular reason.
- If use GEOS-Chem, then we recommend that you download the data sets that are listed as DEFAULT SETTING, as these form the standard GEOS-Chem emissions configuration. You are free, however, to use any of the data sets listed below. Your choice of data sets will depend on your particular research needs.
--Bob Y. 10:53, 18 March 2015 (EDT)
Aerosol emissions
The following subdirectories of the HEMCO directory tree contain aerosol emission inventories.
NOTE: AeroCom volcanic SO2 emissions are listed under the Emissions implemented as HEMCO extensions.
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
Secondary organic aerosols | README | $ROOT/SOA/2014-07 | 3.0 MB | DEFAULT SETTING
|
Spatially varying OM/OC ratios for SOA species | README | $ROOT/OMOC/v2018-01 | 8.6 MB | OPTIONAL
|
Anthropogenic and biofuel emissions
The following subdirectories of the HEMCO directory tree contain inventories of anthropogenic and biofuel emissions.
Please also see list of species included in each of these global inventories and regional inventories.
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
Anthropogenic PM2.5 dust source (AFCID) | README | $ROOT/AFCID/2018-04 | 4.4 MB | DEFAULT SETTING
|
CEDS anthropogenic emissions (2020 version) |
README | $ROOT/CEDS/v2020-08 | 73 GB | DEFAULT SETTING
|
Tzompa et al C2H6 global emissions (2017) | README | $ROOT/C2H6_2010/v2019-06 | 536 KB | DEFAULT SETTING
|
C3H8 global emissions from Xiao et al. (2008) | README | $ROOT/XIAO/v2014-09 | 308 KB | DEFAULT SETTING
|
APEI Canadian emissions (1989-2014) |
README | $ROOT/APEI/v2016-11/ | 68 MB | OPTIONAL |
DICE-Africa anthropogenic emissions | README | $ROOT/DICE_Africa/v2016-10 | 202 MB | OPTIONAL |
EDGAR v4.3 anthropogenic emissions | README | $ROOT/EDGARv43/v2016-11 | 6.2 GB | OPTIONAL
|
NEI2011 hourly US emissions | README | $ROOT/NEI2011/v2015-03 | 248 GB | OPTIONAL |
NEI2011 monthly mean US emissions | README | $ROOT/NEI2011/v2017-02-MM | 248 GB | OPTIONAL |
HTAP global anthro+biofuel | README | $ROOT/HTAP/v2015-03 | 4.5 GB | OPTIONAL
|
MIX Asian anthropogenic emissions | README | $ROOT/MIX/v2015-03 | 623 MB | OPTIONAL |
POET (anthropogenic EOH inventory) | README | $ROOT/POET/v2017-03/ | 38 MB | OPTIONAL |
--Bob Yantosca (talk) 15:41, 3 December 2020 (UTC)
Anthropogenic aircraft and ship emissions
The following subdirectories of the HEMCO directory tree contain inventories of anthropogenic aircraft and ship emissions.
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
AEIC aircraft | README | $ROOT/AEIC/v2015-01 | 2.0 GB | DEFAULT SETTING
|
CEDS ship (2020 version) | README | $ROOT/CEDS/v2020-08 | 73 GB | DEFAULT SETTING
|
ARCTAS ship emissions (SO2) | README | $ROOT/ARCTAS_SHIP/v2014-07 | 508 KB | OPTIONAL
|
ICOADS ship (CO) | README | $ROOT/ICOADS_SHIP/v2014-07 | 4.2 MB | OPTIONAL
|
Corbett et al ship emissions (SO2) | README | $ROOT/CORBETT_SHIP/v2014-07 | 1.8 MB | OPTIONAL
|
HTAP ship (CO, NO, SO2) | README | $ROOT/HTAP/v2015-03 | 4.5 GB | OPTIONAL
|
NEI2011 ship (several species) | README | $ROOT/NEI2011/v2015-03 | 248 GB | OPTIONAL
|
NOTES about ship emissions:
- CEDS ship emissions are the default ship inventory in GEOS-Chem 12.1.0 and later versions.
- Data files for CEDS ship emissions are stored with the other CEDS emission sector files in the HEMCO data path: $ROOT/CEDS/v2018-04/.
- If CEDS emissions are turned off above then:
- ARCTAS should be used over ICOADS, CORBETT, and HTAP for SO2
- ICOADS should be used for CO and NO.
- The NEI2011 ship inventory only goes a few km from land, so it isn’t a complete "ship inventory". This is turned off by default in the HEMCO configuration files that ship with GEOS-Chem.
Biomass burning emissions
The following subdirectories of the HEMCO directory tree contain inventories of biomass burning emissions.
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
GFED4 biomass burning (v4.1) | README | $ROOT/GFED4/v2020-04 | 867 MB | DEFAULT SETTING
|
GFAS biomass burning emissions | README | $ROOT/GFAS/v2018-09 | 49 GB | OPTIONAL
|
FINN biomass burning (v1.6) | README | $ROOT/FINN/v2018-04 | 1.1 GB | TO BE ADDED SOON
|
FINN biomass burning (v1.5) | README | $ROOT/FINN/v2015-02 | 689 MB | OPTIONAL
|
QFED biomass burning (v2.5r1) | README | $ROOT/QFED/v2018-07 | 57 GB | OPTIONAL
|
QFED biomass burning (v2.4r6) | README | $ROOT/QFED/v2014-09 | 57 GB | OPTIONAL
|
Obsolete inventories (superseded by newer developments) | ||||
GFED4 biomass burning (v4.0) | README | $ROOT/GFED4/v2015-06 | 115 MB | OBSOLETE
|
GFED3 biomass burning | README | $ROOT/GFED3/v2014-10 | 343 MB | OBSOLETE
|
GFED2 biomass burning | README | $ROOT/GFED2/v2014-07 | 196 KB | OBSOLETE
|
Duncan et al biomass burning | README | $ROOT/BIOBURN/v2014-07 | 925 MB | OBSOLETE
|
Offline grid-independent emissions
Offline grid-independent emissions were generated by running high-resolution (0.25°x0.3125° for GEOS-FP, 0.5°x0.625° for MERRA-2) simulations using the HEMCO standalone and online emissions from the HEMCO extensions.
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
Offline dust emissions | README | $ROOT/OFFLINE_DUST/v2019-01 | 18 GB | DEFAULT SETTING
|
Offline biogenic VOC emissions | README | $ROOT/OFFLINE_BIOVOC/v2019-01 | 1006 GB | DEFAULT SETTING
|
Offline sea salt emissions | README | $ROOT/OFFLINE_SEASALT/v2019-01 | 848 GB | DEFAULT SETTING
|
Offline soil NOx emissions | README | $ROOT/OFFLINE_SOILNOX/v2019-01 | 46 GB | DEFAULT SETTING
|
Emissions implemented as HEMCO extensions
The following subdirectories of the HEMCO directory tree contain input data used by various HEMCO extensions. These HEMCO extensions compute emissions for quantities that depend on meteorological variables (e.g. emissions from lighting, biogenic processes, etc.).
NOTE: GFED3, GFED4 and FINNv1 are implemented as HEMCO extensions, but we have listed them with the other biomass burning inventories, for clarity.
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
Acetone ocean exchange | README | $ROOT/ACET/v2014-07 | 52 KB | DEFAULT SETTING |
ALD2 ocean exchange | README | $ROOT/ALD2/v2017-03 | 52 KB | DEFAULT SETTING |
DMS ocean exchange | README | $ROOT/DMS/v2015-07 | 3.0 MB | DEFAULT SETTING
|
NO from lightning | README | $ROOT/OFFLINE_LIGHTNING/v2019-01/ | 47 GB | DEFAULT SETTING
|
PARANOX ship plume model | README | $ROOT/PARANOX/v2015-02 | 162 MB | DEFAULT SETTING
|
AeroCom volcanic emissions | README | $ROOT/VOLCANO/v2019-08 | 660 MB | DEFAULT SETTING
|
Optional inventories (turned OFF by default in the standard emissions configuration) | ||||
DEAD dust model | README | $ROOT/DUST_DEAD/2014-07 | 712 KB | OPTIONAL
|
MEGAN biogenic emissions | README | $ROOT/MEGAN/v2018-05 | 12 MB | OPTIONAL
|
NO from soils/fertilizers | README | $ROOT/SOILNOX/v2014-07 | 79 MB | OPTIONAL
|
GINOUX dust model | README | $ROOT/DUST_GINOUX/2014-07 | 36 KB | OPTIONAL
|
Obsolete inventories (superseded by newer developments) | ||||
NO from lightning | README | $ROOT/LIGHTNOX/v2017-09 | 8.5 MB | OBSOLETE
|
DMS ocean exchange | README | $ROOT/DMS/v2014-07 | 2.2 MB | OBSOLETE
|
MEGAN biogenic emissions | README | $ROOT/MEGAN/v2015-02 | 2.0 MB | OBSOLETE
|
Future and historical emissions
The following subdirectories of the HEMCO directory tree contain historical and future emissions inventories.
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
RCP future scenarios | README | $ROOT/RCP/v2015-02 | 368 MB | OPTIONAL
|
GEOS-Chem specialty simulation data
The following subdirectories of the HEMCO directory tree input data (emissions, oxidants, etc.) for use with the GEOS-Chem specialty simulations. If you do not regularly use these simulations, you may choose not to download these data directories.
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
Active inventories (turned ON by default in the standard emissions configuration) | ||||
Aerosol-only simulation | README | $ROOT/OFFLINE_AEROSOL/v2014-09 | 165 MB | DEFAULT SETTING |
CH4 simulation | README1 README2 |
$ROOT/CH4/v2017-10 $ROOT/CH4/v2014-09 |
274 MB | DEFAULT SETTING |
CO2 simulation | README1 README2 README3 README4 README5 README6 |
$ROOT/CO2/v2015-04 $ROOT/CO2/v2015-04/BIO/ $ROOT/CO2/v2015-04/BIOFUEL/ $ROOT/CO2/v2015-04/CHEM/ $ROOT/CO2/v2015-04/FOSSIL/ $ROOT/CO2/v2015-04/OCEAN/ |
1033 MB | DEFAULT SETTING |
Mercury simulation | README1 README2 README3 README4 README5 README6 README7 README8 README9 README10 |
$ROOT/MERCURY/v2014-09 $ROOT/MERCURY/v2014-09/ARTISANAL $ROOT/MERCURY/v2014-09/BrOx $ROOT/MERCURY/v2014-09/Hg2_PARTITION $ROOT/MERCURY/v2014-09/JVALUES $ROOT/MERCURY/v2014-09/NATURAL $ROOT/MERCURY/v2014-09/NEI2005 $ROOT/MERCURY/v2014-09/OCEAN $ROOT/MERCURY/v2014-09/SOIL $ROOT/MERCURY/v2014-09/STREETS |
342 MB | DEFAULT SETTING |
POPs simulation | README | $$ROOT/POPs/v2015-08 | 809 MB | DEFAULT SETTING
|
RRTMG radiative transfer model | README | $ROOT/RRTMG/v2018-11 | 19 MB | DEFAULT SETTING
|
Tagged CO simulation | README | $ROOT/TAGGED_CO/v2017-04 | 260 KB | DEFAULT SETTING
|
Tagged O3 simulation | README | $ROOT/TAGGED_O3/v2014-09 | 372 MB | DEFAULT SETTING |
O3 for offline simulations | README | $ROOT/O3/v2014-09 | 130 MB | DEFAULT SETTING |
OH for offline simulations | README1 README2 |
$ROOT/OH/v2014-09 $ROOT/OH/v2014-09/v5-07-08 $ROOT/OH/v2014-09/v7-02-03.GMI |
148 MB | DEFAULT SETTING |
H2O2 for offline simulations | README | $ROOT/OXIDANTS/v2014-07 | 32 MB | DEFAULT SETTING |
Oceanic Chlorophyll-A for Hg simulations | README | $ROOT/CHLA/v2014-07 | 2.0 MB | DEFAULT SETTING |
Obsolete inventories (superseded by newer developments) | ||||
CH3I simulation | README | $ROOT/CH3I/v2014-07 | 280 KB | OBSOLETE
|
POPs simulation | README | $ROOT/POPs/v2014-09 | 622 MB | OBSOLETE
|
Tagged CO simulation | README | $ROOT/TAGGED_CO/v2014-08q | 260 KB | OBSOLETE
|
--Bob Yantosca (talk) 19:01, 2 July 2018 (UTC)
Halogen emissions
The following subdirectories of the HEMCO directory tree contain inventories of bromine and iodine emissions.
NOTE: See our Non-emissions data section for information about stratospheric bromine concentration data.
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
Liang et al VSL emissions | README | $ROOT/BROMINE/v2015-02 | 156 KB | DEFAULT SETTING |
Ordonez et al Iodine emissions | README | $ROOT/IODINE/v2017-09 | 4.4 MB | DEFAULT SETTING
|
Natural emissions data
The following subdirectories of the HEMCO directory tree contain inventories natural emissions.
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
GEIA NH3 (natural source) | README | $ROOT/NH3/v2014-07 | 8.1 MB | DEFAULT SETTING |
NH3 emissions from arctic sea birds | README | HEMCO/NH3/v2018-04/ | 104 MB | DEFAULT SETTING
|
ALD2 and EOH emissions from decaying plants | README | $ROOT/ALD2/v2017-03 | 8.1 MB | DEFAULT SETTING |
Non-emissions data
The following subdirectories of the HEMCO directory tree input data contains non-emissions data sets. Most of these are used as inputs to GEOS-Chem's chemistry modules (i.e. photolysis, stratospheric chemistry, etc.).
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
Active inventories (turned ON by default in the standard emissions configuration) | ||||
Timezone offsets from UTC | README | $ROOT/TIMEZONES/v2015-02 | 264 KB | DEFAULT SETTING
|
UV surface albedoes | README | $ROOT/UVALBEDO/v2019-06 | 476 KB | DEFAULT SETTING
|
TOMS/SBUV O3 columns | README | $ROOT/TOMS_SBUV/v2019-06 | 21 MB | DEFAULT SETTING |
Stratospheric Bry from CCM | README | $ROOT/STRAT/v2015-01/Bry | 385 MB | DEFAULT SETTING
|
GMI strat chem mechanism | README | $ROOT/GMI/v2015-02 | 16 GB | DEFAULT SETTING
|
UCX chemistry mechanism | README | $ROOT/UCX/v2018-02 | 12 GB | DEFAULT SETTING
|
MODIS XLAI (leaf area index per land type) |
README | $ROOT/MODIS_XLAI/v2017-07 | 203 MB | TDEFAULT SETTING
|
Olson land map (masks for each land type) |
README | $ROOT/OLSON_MAP/v2019-02 | 1.9 MB | TDEFAULT SETTING
|
Yuan-processed MODIS XLAI (leaf area index per land type) |
README | $ROOT/Yuan_XLAI/v2019-03 | 203 MB | TDEFAULT SETTING
|
Obsolete inventories (superseded by newer developments) | ||||
TOMS/SBUV O3 columns | README | $ROOT/TOMS_SBUV/v2015-03 | 17 MB | OBSOLETE
|
Other inputs for HEMCO
The following subdirectories of the HEMCO directory tree input data for various HEMCO functions. These include regional masks, emission scale factors, and grid information.
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
Active inventories (turned ON by default in the standard emissions configuration) | ||||
Annual scale factors | README | $ROOT/AnnualScalar/v2014-07 | 3.0 MB | DEFAULT SETTING
|
NEI2005 scale factors | README | $ROOT/NEI2005/v2014-09 | 8.1 MB | DEFAULT SETTING |
ID codes for each country | README | $ROOT/COUNTRY_ID/v2015-04 | 15 MB | DEFAULT SETTING
|
Mask files for regional emissions | README | $ROOT/MASKS/v2014-07 | 51 MB | DEFAULT SETTING
|
MAP_A2A regridding data | README | $ROOT/MAP_A2A/v2014-07 | 152 KB | DEFAULT SETTING |
Obsolete inventories (superseded by newer developments) | ||||
Weekly scale factors | README | $ROOT/WEEKSCALE/v2014-07 | 4.0 KB | OBSOLETE
|
--Bob Yantosca (talk) 19:05, 2 July 2018 (UTC)
The hemco_data_download package
Obtaining the hemco_data_download package
The hemco_data_download package will be retired in GEOS-Chem 12.7.0 in favor of the GEOS-Chem dry run option.
To obtain the hemco_data_download package, use Git to clone this repository
git clone https://github.com/GCST/hemco_data_download.git
This will create a directory named hemco_data_download, in which you should see the following files:
File | Description |
---|---|
README | File with an overall description of the directory contents |
hemcoDataDownload.pl | Perl script to download HEMCO data directories |
hemcoDataDownload.rc | Configuration file for the hemcoDataDownload.pl script. In this file you can specify which HEMCO data directories you would like to download and which you would like to omit. |
forTesting.rc | A configuration file that you can use for testing or debugging. This will tell hemcoDataDownload.pl only to download a couple of emissions inventories with files that do not take up much disk space. |
--Bob Yantosca (talk) 17:02, 5 December 2016 (UTC)
Setting up the configuration file
The hemco_data_download package will be retired in GEOS-Chem 12.7.0 in favor of the GEOS-Chem dry run option.
The configuration files (i.e. hemcoDataDownload.rc and forTesting.rc) are pretty much self-explanatory.
At the top of the configuration file you will see this section:
############################################################################### # # # Specify the remote and local HEMCO data paths, plus other options. # # # ############################################################################### Remote HEMCO data path | ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO Your HEMCO data path | /as/scratch/bmy/HEMCO Verbose output | yes Dryrun only? | no
Path | Description |
---|---|
Remote HEMCO data path | Location on the FTP server from which you are going to download the data. This can be from either Harvard or from Dalhousie. (For now we will use the Harvard server). You can edit this accordingly. |
Your HEMCO data path | The root-level directory for HEMCO data on your own disk space. If you are not sure where to place this, then ask your sysadmin. |
Verbose output | Lets you specify if you want to print out extra output during the download process. This can be set to either "yes" or "no". |
Dryrun only | Allows you to print out the data download commands without actually downloading the data. This is useful for debugging. This can be set to either "yes" or "no". |
In the next section you specify all of the HEMCO inventories that you want to download. You will see this header:
############################################################################### # # # THE FOLLOWING DATA DIRECTORIES WILL BE DOWNLOADED. # # # # These data directories comprise the recommended emissions configuration # # for typical GEOS-Chem full-chemistry and specialty simulations. # # # # NOTE: In most cases, you only have to specify the top-level folder. # # All subfolders will be downloaded automatically. # # # ############################################################################### #=============================+================================================ # AEROSOLS | Directory paths #=============================+================================================ AEROCOM volcano emissions | $ROOT/VOLCANO/v2014-10 Bond et al BC/OC | $ROOT/BCOC_BOND/v2014-07 Cooke et al BC/OC | $ROOT/BCOC_COOKE/v2014-07 Secondary organic aerosols | $ROOT/SOA/v2014-07 ... etc ...
Each line specifies the name of a HEMCO emissions inventory and the data path where it can be found on disk, relative to the root data path. NOTE: The script will replace the $ROOT token with the value you gave to the "HEMCO remote data path" above. (Lines starting with the comment character # will be ignored.)
Any inventory found in this section will be downloaded. To prevent an inventory from being downloaded you can either comment it out (i.e. place a # in the first column) or move the inventory to the next section.
The final section specifies HEMCO emission inventories that you do not wish to download. The section looks like this:
############################################################################### # # # THE FOLLOWING DATA DIRECTORIES WILL NOT BE DOWNLOADED. # # # # These data directories contain are optional emissions inventories that # # are not used in typical GEOS-Chem simulations. If you wish to download # # any of these inventories, simply move the corresponding entry for each # # inventory to the previous section. # # # ############################################################################### CH3I simulation (obsolete) | $ROOT/CH3I/v2014-07 Chlorophyll A | $ROOT/CHLA/v2014-07 ... etc ...
--Bob Y. 13:55, 12 February 2015 (EST)
Downloading the data
The hemco_data_download package will be retired in GEOS-Chem 12.7.0 in favor of the GEOS-Chem dry run option.
Once you have set up your configuration file, you can run the hemcoDataDownload.pl script to start downloading the HEMCO data to your local server. To run the script you can type:
hemcoDataDownload.pl
If you do not specify a configuration file name, then the hemcoDataDownload.pl scriptwill read the default configuration file hemcoDataDownload.rc configuration file. If you wish to specify a different configuration file name, simply pass that as an argument to the script, e.g.
hemcoDataDownload.pl myNewConfigFile.rc
Before you start downloading GB's of data, we recommend that you run a short test to make sure that the data directories are being copied to the proper locations on your disk server. For this purpose, we have provided a configuration file named forTesting.rc. Typing
hemcoDataDownload.pl forTesting.pl
will only download a couple of data inventories that do not take up much disk space. This allows you to ensure that the data transfer is sucessful without making you wait a long time.
--Bob Y. 13:57, 12 February 2015 (EST)
Submitting new data for use with HEMCO
If you have a new emissions inventory or other atmospheric data set that you would like to add to the HEMCO data directories, then please contact the GEOS-Chem Support Team. Data files must be in COARDS-compliant or CF-compliant netCDF format. Please see the following pages for more information:
--Bob Yantosca (talk) 22:24, 14 January 2020 (UTC)