HEMCO data directories: Difference between revisions

From Geos-chem
Jump to navigation Jump to search
 
(137 intermediate revisions by 2 users not shown)
Line 1: Line 1:
On this page we describe the directory tree from which the [[HEMCO|HEMCO emissions component]] can read emissions inventories and other atmospheric data sets.
== Overview ==
== Overview ==


The [[HEMCO|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.
On this page, we provide lists of data (chemistry inputs, emissions, initial conditions, and meteorology) that are read into GEOS-Chem by the [https://hemco.readthedocs.io Harmonized Emissions Component (HEMCO)].  These data reside at [http://geoschemdata.wustl.edu '''geoschemdata.wustl.edu'''] and at the '''s3://gcgrid''' Amazon S3 bucket.
 
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|''Downloading the HEMCO data directories'']] section below.
 
Please see [[Emissions_and_Deposition_Working_Group#Recommended_Default_Emission_Inventories|our list of recommended default emission inventories]], which has been compiled by the [[Emissions and Deposition Working Group]].
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|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:
 
{| border=1 cellpadding=5 cellspacing=0
|-bgcolor="#CCCCCC"                       
!width="175px"|GEOS-Chem versions
!width="350px"|Recommended download method
!width="350px"|Alternate download method
 
|-valign="top"
|[[GEOS-Chem 12#12.7.0|12.7.0]] and later
|[[Downloading_data_with_the_GEOS-Chem_dry-run_option|The GEOS-Chem dry-run option]]
|Manual download from either
*[[Downloading_data_from_Compute_Canada|Compute Canada]], or
*[[Downloading_data_from_Amazon_Web_Services_cloud_storage|Amazon Web Services <tt>s3://gcgrid</tt> storage]]
 
|-valign="top"
|[[GEOS-Chem 12#12.6.3|12.6.3]] and prior
|[[#The hemco_data_download package|The <tt>hemco_data_download</tt> package]]
|Manual download from either
*[[Downloading_data_from_Compute_Canada|Compute Canada]], or
*[[Downloading_data_from_Amazon_Web_Services_cloud_storage|Amazon Web Services <tt>s3://gcgrid</tt> storage]]
 
|}
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 17:07, 3 December 2020 (UTC)
 
== 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 <tt>$ROOT</tt>, the top-level HEMCO directory.  For example, on the Harvard disk server, <tt>$ROOT</tt> points to the directory <tt>/mnt/gcgrid/data/ExtData/HEMCO/</tt>.
 
:The '''Status''' column describes the current status of each data set:
 
:{| border=1 cellspacing=0 cellpadding=5
|-valign="top"
|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:
*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 one or more of the [[GEOS-Chem_chemistry_mechanisms#Specialty_simulations|GEOS-Chem specialty simulations]].
 
|-valign="top"
|bgcolor="#FFFF00"|OPTIONAL SETTING
|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.
 
|}
 
: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.
 
NOTE: The inventories are displayed in the same order as in the <tt>HEMCO_Config.rc</tt> version that ships with [[GEOS-Chem 13.0.0]].
 
=== Regional inventories ===
 
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
!width="250px"|Inventory
!width="90px"|More info
!width="275px"|Path
!width="75px"|Data size
!width="400px"|Status
 
|-valign="top"
|[[CAC_anthropogenic_emissions#Historical_Canadian_emissions|APEI Canadian emissions]]<br>(1989-2014)
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/APEI/v2016-11/README README]
|<tt>$ROOT/APEI/v2016-11/</tt>
|68 MB
|bgcolor="#FFFF00"|OPTIONAL
*Superseded by CEDS in [[GEOS-Chem 13.0.0|13.0.0]]
*Was default from [[GEOS-Chem v11-02#v11-02f|v11-02f]]&ndash;[[GEOS-Chem 13.0.0|13.0.0]]
 
|-valign="top"
|[[EPA/NEI11_North_American_emissions|NEI2011 hourly US emissions]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/NEI2011/v2015-03/README README]
|<tt>$ROOT/NEI2011/v2015-03</tt>
|248 GB
|bgcolor="#FFFF00"|OPTIONAL
*Superseded by CEDS in [[GEOS-Chem 13.0.0|13.0.0]]
*Was default from [[GEOS-Chem v11-02#v11-02f|v11-02f]]&ndash;[[GEOS-Chem 13.0.0|13.0.0]]
 
|-valign="top"
|[[EPA/NEI11_North_American_emissions|NEI2011 monthly mean US emissions]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/NEI2011/v2017-02-MM/README README]
|<tt>$ROOT/NEI2011/v2017-02-MM</tt>
|248 GB
|bgcolor="#FFFF00"|OPTIONAL
*Superseded by CEDS in [[GEOS-Chem 13.0.0|13.0.0]]
*Was default from [[GEOS-Chem v11-02#v11-02f|v11-02f]] &ndash; [[GEOS-Chem 13.0.0|13.0.0]]
 
|-valign="top"
|[[MIX Asian anthropogenic emissions]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MIX/v2015-03/README README]
|<tt>$ROOT/MIX/v2015-03</tt>
|623 MB
|bgcolor="#FFFF00"|OPTIONAL
*Superseded by CEDS in [[GEOS-Chem 13.0.0|13.0.0]]
*Was default from [[GEOS-Chem v11-02#v11-02f|v11-02f]] &ndash; [[GEOS-Chem 13.0.0|13.0.0]]
 
|-valign="top"
|[[DICE-Africa_anthropogenic_emissions_inventory|DICE-Africa anthropogenic emissions]]
||[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/DICE_Africa/v2016-10/README README]
|<tt>$ROOT/DICE_Africa/v2016-10</tt>
|202 MB
|bgcolor="#FFFF00"|OPTIONAL
*Superseded by CEDS in [[GEOS-Chem 13.0.0|13.0.0]]
*Was default from [[GEOS-Chem v11-02#v11-02f|v11-02f]] &ndash; [[GEOS-Chem 13.0.0|13.0.0]]
 
|}
 
=== Global inventories ===
 
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 [[Anthropogenic_emissions#Global_inventories|global inventories]] and [[Anthropogenic_emissions#Regional_inventories|regional inventories]].
 
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
!width="250px"|Inventory
!width="90px"|More info
!width="275px"|Path
!width="75px"|Data size
!width="400px"|Status
 
|-valign="top"
|[[CEDS anthropogenic emissions|CEDS anthropogenic emissions]]<br>(2020 version)
||[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CEDS/v2018-04/README README]
|<tt>$ROOT/CEDS/v2020-08</tt>
|73 GB
|bgcolor="#00FF00"|DEFAULT SETTING
*Introduced in [[GEOS-Chem 13.0.0|13.0.0]]
*Reference: McDuffie et al 2020, ESSD
 
|-valign="top"
|[[CEDS anthropogenic emissions|CEDS by fuel type]]<br>(2020 version)
||[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CEDS/v2018-04/README README]
|<tt>$ROOT/CEDS/v2020-08</tt>
|73 GB
|bgcolor="#FFFF00"|OPTIONAL SETTING
*This is the CEDS (2020 version) data split up into separate files by fuel sector.  Incurs additional I/O overhead.
*Introduced in [[GEOS-Chem 13.0.0|13.0.0]]
*Reference: McDuffie et al 2020, ESSD
 
|-valign="top"
|[[EDGAR v4.3 anthropogenic emissions]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/EDGARv43/v2016-11/README README]
|<tt>$ROOT/EDGARv43/v2016-11</tt>
|6.2 GB
|bgcolor="#FFFF00"|OPTIONAL
*Superseded by CEDS in [[GEOS-Chem 13.0.0|13.0.0]]
*Used for sectors not included in DICE-Africa inventory
*Turning on this option will also include trash burning emissions of NOx, SOx, CO, NH3, BC and OC from Wiedinmyer et al. (2014) and NMVOC emissions from CEDS
 
|-valign="top"
|[http://edgar.jrc.ec.europa.eu/htap_v2/index.php?SECURE=123 HTAP global anthro+biofuel]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/HTAP/v2015-03/README README]
|<tt>$ROOT/HTAP/v2015-03</tt>
|4.5 GB
|bgcolor="#FFFF00"|OPTIONAL
*NOTE: HTAP includes some regional emissions from other inventories.  If you select HTAP you might not need to select the other regional inventories in HEMCO. [http://edgar.jrc.ec.europa.eu/htap/EDGAR-HTAP_v1_final_jan2012.pdf See this document] for more information.
 
|-valign="top"
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/NH3/v2014-07/README GEIA NH3 (natural source)]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/NH3/v2014-07/README README]
|<tt>$ROOT/NH3/v2014-07</tt>
|8.1 MB
|bgcolor="#00FF00"|DEFAULT SETTING
 
|-valign="top"
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/NH3/v2018-04/README NH3 emissions from arctic sea birds]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/NH3/v2018-04/README README]
|<tt>HEMCO/NH3/v2018-04/</tt>
|104 MB
|bgcolor="#00FF00"|DEFAULT SETTING
 
|-valign="top"
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/POET/v2017-03/README POET (anthropogenic EOH inventory)]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/POET/v2017-03/README README]
|<tt>$ROOT/POET/v2017-03/</tt>
|38 MB
|bgcolor="#FFFF00"|OPTIONAL SETTING
*Was default setting from [[GEOS-Chem v11-02#v11-02a|v11-02a]] &ndash; [[GEOS-Chem 13.0.0|13.0.0]]
 
|-valign="top"
|[https://onlinelibrary.wiley.com/doi/full/10.1002/2016JD025767 Tzompa-Soza et al C2H6 global emissions (2017)]
||[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/C2H6_2010/v2019-06/README README]
|<tt>$ROOT/C2H6_2010/v2019-06</tt>
|536 KB
|bgcolor="#00FF00"|DEFAULT SETTING
*Overwrites the C2H6 emissions from the CEDS to address underestimates
 
|-valign="top"
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/XIAO/v2014-09/README C3H8 global emissions from Xiao et al. (2008)]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/XIAO/v2014-09/README README]
|<tt>$ROOT/XIAO/v2014-09</tt>
|308 KB
|bgcolor="#00FF00"|DEFAULT SETTING
*Overwrites the C3H8 emissions from CEDS to address underestimates
 
|-valign="top"
|[[Bromine_chemistry_mechanism#Source code and data files|Liang et al VSL emissions]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/BROMINE/v2015-02/README README]
|<tt>$ROOT/BROMINE/v2015-02</tt>
|156 KB
|bgcolor="#00FF00"|DEFAULT SETTING
 
|-valign="top"
|[[Halogen_chemistry_mechanism#Source_code_and_data_files|Ordonez et al Iodine emissions]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/IODINE/v2017-09/README README]
|<tt>$ROOT/IODINE/v2017-09</tt>
|4.4 MB
|bgcolor="#00FF00"|DEFAULT SETTING
 
|-valign="top"
|[[Aircraft_emissions#MIT_aviation_emissions_inventory|AEIC aircraft]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/AEIC/v2015-01/README README]
|<tt>$ROOT/AEIC/v2015-01</tt>
|2.0 GB
|bgcolor="#00FF00"|DEFAULT SETTING
 
|-valign="top"
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/ALD2/v2017-03/README ALD2 and EOH emissions from decaying plants]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/ALD2/v2017-03/README README]
|<tt>$ROOT/ALD2/v2017-03</tt>
|8.1 MB
|bgcolor="#00FF00"|DEFAULT SETTING
 
|-valign="top"
|[[Mineral_dust_aerosols#Anthropogenic_PM2.5_dust_source_in_GEOS-Chem|Anthropogenic PM2.5 dust source (AFCID)]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/AFCID/v2018-04/README README]
|<tt>$ROOT/AFCID/2018-04</tt>
|4.4 MB
|bgcolor="#00FF00"|DEFAULT SETTING
*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.
 
|}
 
=== Ship emissions ===
 
The following subdirectories of the HEMCO directory tree contain inventories of anthropogenic aircraft and ship emissions.
 
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
!width="250px"|Inventory
!width="90px"|More info
!width="275px"|Path
!width="75px"|Data size
!width="400px"|Status
 
|-valign="top"
|[[CEDS anthropogenic emissions|CEDS ship]] (2020 version)
||[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CEDS/v2018-04/README README]
|<tt>$ROOT/CEDS/v2020-08</tt>
|73 GB
|bgcolor="#00FF00"|DEFAULT SETTING
*Emissions are summed over all fuel sectors.
 
|-valign="top"
|[[CEDS anthropogenic emissions|CEDS ship by fuel type]] (2020 version)
||[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CEDS/v2018-04/README README]
|<tt>$ROOT/CEDS/v2020-08</tt>
|73 GB
|bgcolor="#FFFF00"|OPTIONAL SETTING
*Emissions are for individual fuel sectors.  Incurs additional I/O overhead.
 
|-valign="top"
|[http://edgar.jrc.ec.europa.eu/htap_v2/index.php?SECURE=123 HTAP ship (CO, NO, SO2)]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/HTAP/v2015-03/README README]
|<tt>$ROOT/HTAP/v2015-03</tt>
|4.5 GB
|bgcolor="#FFFF00"|OPTIONAL SETTING
*[http://edgar.jrc.ec.europa.eu/htap/EDGAR-HTAP_v1_final_jan2012.pdf See this document] for more information.
 
|-valign="top"
|[[Ship_emissions#ICOADS|ICOADS ship (CO)]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/ICOADS_SHIP/v2014-07/README README]
|<tt>$ROOT/ICOADS_SHIP/v2014-07</tt>
|4.2 MB
|bgcolor="#FFFF00"|OPTIONAL SETTING
*Was default setting until [[GEOS-Chem 12#12.1.0|GEOS-Chem 12.1.0]].
 
|-valign="top"
|[[Ship_emissions#ARCTAS|ARCTAS ship emissions (SO2)]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/ARCTAS_SHIP/v2014-07/README README]
|<tt>$ROOT/ARCTAS_SHIP/v2014-07</tt>
|508 KB
|bgcolor="#FFFF00"|OPTIONAL SETTING
*Was default setting until [[GEOS-Chem 12#12.1.0|GEOS-Chem 12.1.0]].
 
|-valign="top"
|[[Ship_emissions#Corbett|Corbett et al ship emissions (SO2)]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CORBETT_SHIP/v2014-07/README README]
|<tt>$ROOT/CORBETT_SHIP/v2014-07</tt>
|1.8 MB
|bgcolor="#FFFF00"|OPTIONAL SETTING
*Was default setting until [[GEOS-Chem 12#12.1.0|GEOS-Chem 12.1.0]].
 
|-valign="top"
|[[EPA/NEI11_North_American_emissions|NEI2011 ship (hourly)]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/NEI2011/v2015-03/README README]
|<tt>$ROOT/NEI2011/v2015-03</tt>
|248 GB
|bgcolor="#FFFF00"|OPTIONAL SETTING
*NOTE: Only extends a few km from land, so this is more of a coastal emissions inventory.
 
|-valign="top"
|[[EPA/NEI11_North_American_emissions|NEI2011 ship (monthly mean)]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/NEI2011/v2015-03/README README]
|<tt>$ROOT/NEI2011/v2017-02-MM</tt>
|248 GB
|bgcolor="#FFFF00"|OPTIONAL SETTING
*NOTE: Only extends a few km from land, so this is more of a coastal emissions inventory.
 
|}
 
NOTES about ship emissions:
#CEDS ship emissions are the default ship inventory in [[GEOS-Chem 12#12.1.0|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: <tt>$ROOT/CEDS/v2018-04/</tt>.
#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.
 
=== Future emissions ===
 
The following subdirectories of the HEMCO directory tree contain historical and future emissions inventories.
 
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
!width="250px"|Inventory
!width="90px"|More info
!width="275px"|Path
!width="75px"|Data size
!width="400px"|Status
 
|-valign="top"
|[[RCP_future_emissions_scenarios#RCP_scenarios_in_GEOS-Chem_v10-01_and_higher_versions|RCP future scenarios]]
*RCP_3PD
*RCP_45
*RCP_60
*RCP_85
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/RCP/v2015-02/README README]
|<tt>$ROOT/RCP/v2015-02</tt>
|368 MB
|bgcolor="#FFFF00"|OPTIONAL
*RCP emissions are not part of the standard GEOS-Chem emissions configuration but may be used as a research option.
|}
 
=== Biomass burning emissions (not implemented as extensions) ===
 
''NOTE: Some biomass burning inventories are implemented as HEMCO extensions.  See this section below for more information.''
 
The following subdirectories of the HEMCO directory tree contain inventories of biomass burning emissions.
 
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
!width="250px"|Inventory
!width="110px"|Data file info
!width="300px"|Path
!width="110px"|Directory size
!width="350px"|Status
 
|-valign="top"
|[[GFAS_biomass_burning_emissions|GFAS biomass burning emissions]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/GFAS/v2018-09/README README]
|<tt>$ROOT/GFAS/v2018-09</tt>
|49 GB
|bgcolor="#FFFF00"|OPTIONAL SETTING
*Monthly data are available from 2003-present and are updated monthly
 
|-valign="top"
|[[QFED_biomass_burning_emissions|QFED biomass burning (v2.5r1)]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/QFED/v2018-07/README README]
|<tt>$ROOT/QFED/v2018-07</tt>
|57 GB
|bgcolor="#FFFF00"|OPTIONAL SETTING
*QFED v2.5r1 data extends from 2000-2017 (at present)
 
|}
 
=== Offline grid-independent emissions ===
 
Offline grid-independent emissions were generated by running high-resolution (0.25&deg;x0.3125&deg; for GEOS-FP, 0.5&deg;x0.625&deg; for MERRA-2) simulations using the HEMCO standalone and online emissions from the [[#Emissions implemented as HEMCO extensions|HEMCO extensions]].
 
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
!width="250px"|Inventory
!width="110px"|Data file info
!width="300px"|Path
!width="110px"|Directory size
!width="350px"|Status
 
|-valign="top"
|[[Mineral_dust_aerosols#Offline_Dust_Emissions|Offline dust emissions]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OFFLINE_DUST/v2019-01/README README]
|<tt>$ROOT/OFFLINE_DUST/v2019-01</tt>
|18 GB
|bgcolor="#00FF00"|DEFAULT SETTING
*Introduced in [[GEOS-Chem 12#12.5.0|12.5.0]]
*You must also turn off the DustDead and DustGinoux extensions
 
|-valign="top"
|[[Grid-independent_emissions#Biogenic_emissions|Offline biogenic VOC emissions]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OFFLINE_BIOVOC/v2019-01/README README]
|<tt>$ROOT/OFFLINE_BIOVOC/v2019-01</tt>
|1006 GB
|bgcolor="#00FF00"|DEFAULT SETTING
*Introduced in [[GEOS-Chem 12#12.5.0|12.5.0]]
*NOTE: The MEGAN extension should remain on so that it can calculate biogenic emissions for some species not in this inventory.
 
|-valign="top"
|[[Grid-independent_emissions#Biogenic_emissions|Offline sea salt emissions]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OFFLINE_SEASALT/v2019-01/README README]
|<tt>$ROOT/OFFLINE_SEASALT/v2019-01</tt>
|848 GB
|bgcolor="#00FF00"|DEFAULT SETTING
*Introduced in [[GEOS-Chem 12#12.5.0|12.5.0]]
*To use this, turn off the SeaSalt extension
 
|-valign="top"
|[[Grid-independent_emissions#Biogenic_emissions|Offline soil NOx emissions]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OFFLINE_SOILNOX/v2019-01/README README]
|<tt>$ROOT/OFFLINE_SOILNOX/v2019-01</tt>
|46 GB
|bgcolor="#00FF00"|DEFAULT SETTING
*Introduced in [[GEOS-Chem 12#12.5.0|12.5.0]]
*You must also turn off the SoilNOx extension
|}
 
=== 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|Emissions implemented as HEMCO extensions]].''
 
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
!width="250px"|Inventory
!width="110px"|Data file info
!width="300px"|Path
!width="110px"|Directory size
!width="350px"|Status
 
|-valign="top"
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/SOA/v2014-07/README Secondary organic aerosols]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/SOA/v2014-07/README README]
|<tt>$ROOT/SOA/2014-07</tt>
|3.0 MB
|bgcolor="#00FF00"|DEFAULT SETTING
*Contain various inputs for SOA simulations.
 
|-valign="top"
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OMOC/v2018-01/README Spatially varying OM/OC ratios for SOA species]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OMOC/v2018-01/README README]
|<tt>$ROOT/OMOC/v2018-01</tt>
|8.6 MB
|bgcolor="#FFFF00"|OPTIONAL
*Controlled by a switch in <tt>input.geos</tt><br>(default is OFF)
 
|}
 
=== 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 biomass burning emissions|GFED3]], [[GFED4 biomass burning emissions|GFED4]] and [[FINNv1 biomass burning emissions|FINNv1]] are implemented as HEMCO extensions, but we have listed them with the other biomass burning inventories, for clarity.''
 
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
!width="250px"|Inventory
!width="110px"|Data file info
!width="300px"|Path
!width="110px"|Directory size
!width="350px"|Status
 
|-valign="top"
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/ACET/v2014-07/README Acetone ocean exchange]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/ACET/v2014-07/README README]
|<tt>$ROOT/ACET/v2014-07</tt>
|52 KB
|bgcolor="#00FF00"|DEFAULT SETTING
 
|-valign="top"
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/ALD2/v2017-03/README ALD2 ocean exchange]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/ALD2/v2017-03/README README]
|<tt>$ROOT/ALD2/v2017-03</tt>
|52 KB
|bgcolor="#00FF00"|DEFAULT SETTING
 
|-valign="top"
|DMS ocean exchange
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/DMS/v2015-07/README README]
|<tt>$ROOT/DMS/v2015-07</tt>
|3.0 MB
|bgcolor="#00FF00"|DEFAULT SETTING
*This is the default in [[GEOS-Chem v11-01|v11-01]] and higher versions
*Uses Lana 2011 climatology
 
|-valign="top"
|[[Lightning_NOx_emissions|NO from lightning]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OFFLINE_LIGHTNING/v2019-01/GEOSFP/README README]
|<tt>$ROOT/OFFLINE_LIGHTNING/v2019-01/</tt>
|47 GB
|bgcolor="#00FF00"|DEFAULT SETTING
*Introduced in [[GEOS-Chem 12#12.5.0|12.5.0]]
 
|-valign="top"
|[[Ship_emissions#PARANOX_ship_plume_model|PARANOX ship plume model]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/PARANOX/v2015-02/README README]
|<tt>$ROOT/PARANOX/v2015-02</tt>
|162 MB
|bgcolor="#00FF00"|DEFAULT SETTING
*Computes the aging of emissions in ship exhaust plumes.
 
|-valign="top"
|[[Volcanic_SO2_emissions|AeroCom volcanic emissions]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/VOLCANO/v2019-08/README README]
|<tt>$ROOT/VOLCANO/v2019-08</tt>
|660 MB
|bgcolor="#00FF00"|DEFAULT SETTING
*Updated in [[GEOS-Chem 12#12.6.0|12.6.0]]
 
|-valign="top"
!colspan="5" bgcolor="#CCFFFF"|Optional inventories (turned OFF by default in the standard emissions configuration)
 
|-valign="top"
|[[Mineral dust aerosols|DEAD dust model]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/DUST_DEAD/v2014-07/README README]
|<tt>$ROOT/DUST_DEAD/2014-07</tt>
|712 KB
|bgcolor="#FFFF00"|OPTIONAL
*May be used instead of offline dust emissions
 
|-valign="top"
|[[MEGAN_v2.1_plus_Guenther_2012_biogenic_emissions|MEGAN biogenic emissions]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MEGAN/v2018-05/README README]
|<tt>$ROOT/MEGAN/v2018-05</tt>
|12 MB
|bgcolor="#FFFF00"|OPTIONAL
*May be used instead of offline biogenic VOC emissions
 
|-valign="top"
|[[Hudman_et_al_2012_soil_NOx_emissions_algorithm|NO from soils/fertilizers]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/SOILNOX/v2014-07/README README]
|<tt>$ROOT/SOILNOX/v2014-07</tt>
|79 MB
|bgcolor="#FFFF00"|OPTIONAL
*May be used instead of offline soil NOx emissions
 
|-valign="top"
|[[Mineral dust aerosols|GINOUX dust model]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/DUST_GINOUX/v2014-07/README README]
|<tt>$ROOT/DUST_GINOUX/2014-07</tt>
|36 KB
|bgcolor="#FFFF00"|OPTIONAL
*You can use this in place of the DEAD dust model.


|}
== Data directories by GEOS-Chem version ==


=== GEOS-Chem specialty simulation data ===
Our [https://github.com/geoschem/input-data-catalogs/ '''input-data-catalogs'''] Github repository contains lists of input files needed to run GEOS-Chem simulations.  These are contained in the comma-separated files <tt>ChemistryInputs.csv</tt>, <tt>EmissionInputs.csv</tt> and <tt>InitialConditions.csv</tt>, and  [https://github.com/geoschem/input-data-catalogs/blob/main/MeteorologicalInputs.csv <tt>MeteorologicalInputs.csv</tt>]. 


The following subdirectories of the HEMCO directory tree input data (emissions, oxidants, etc.) for use with the [[GEOS-Chem_chemistry_mechanisms#Specialty_simulations|GEOS-Chem specialty simulations]].  If you do not regularly use these simulations, you may choose not to download these data directories.
Passing any of these files as input to the [https://github.com/LiamBindle/bashdatacatalog/wiki '''bashdatacatalog'''] utility will initiate a data transfer to your local disk storage.


{| border=1 cellspacing=0 cellpadding=5
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
|-bgcolor="#CCCCCC"
!width="250px"|Inventory
!width="150px"|Version
!width="110px"|Data file info
!width="200px"|Chemistry Inputs
!width="300px"|Path
!width="200px"|Emissions Inputs
!width="110px"|Directory size
!width="200px"|Initial Conditions
!width="350px"|Status


|-valign="top"
|-valign="top" align="center"
!colspan="5" bgcolor="#CCFFFF"|Active inventories (turned ON by default in the standard emissions configuration)
|[[GEOS-Chem 14.1.1]]
|[https://github.com/geoschem/input-data-catalogs/blob/2f9992f7c5d9285a18c8ff326a7eff6e04758ee4/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
|[https://github.com/geoschem/input-data-catalogs/blob/2f9992f7c5d9285a18c8ff326a7eff6e04758ee4/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
|[https://github.com/geoschem/input-data-catalogs/blob/2f9992f7c5d9285a18c8ff326a7eff6e04758ee4/InitialConditions.csv <tt>InitialConditions.csv</tt>]


|-valign="top"
|-valign="top" align="center"
|[[Aerosol-only simulation]]
|[[GEOS-Chem 14.1.0]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OFFLINE_AEROSOL/v2014-09/README README]
|[https://github.com/geoschem/input-data-catalogs/blob/fe46b1e55a07a26e5f7eefe9e79776bb83e20eed/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
|<tt>$ROOT/OFFLINE_AEROSOL/v2014-09</tt>
|[https://github.com/geoschem/input-data-catalogs/blob/fe46b1e55a07a26e5f7eefe9e79776bb83e20eed/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
|165 MB
|[https://github.com/geoschem/input-data-catalogs/blob/fe46b1e55a07a26e5f7eefe9e79776bb83e20eed/InitialConditions.csv <tt>InitialConditions.csv</tt>]
|bgcolor="#00FF00"|DEFAULT SETTING


|-valign="top"
|-valign="top" align="center"
|[[CH4 simulation]]
|[[GEOS-Chem 14.0.0]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CH4/v2017-10/README README1]<br>[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CH4/v2014-09/README README2]
|[https://github.com/geoschem/input-data-catalogs/blob/e61ca36cdbd1c1bfeb58ff20a5633c97dcc48164/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
|<tt>$ROOT/CH4/v2017-10</tt><br><tt>$ROOT/CH4/v2014-09</tt>
|[https://github.com/geoschem/input-data-catalogs/blob/e61ca36cdbd1c1bfeb58ff20a5633c97dcc48164/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
|274 MB
|[https://github.com/geoschem/input-data-catalogs/blob/e61ca36cdbd1c1bfeb58ff20a5633c97dcc48164/InitialConditions.csv <tt>InitialConditions.csv</tt>]
|bgcolor="#00FF00"|DEFAULT SETTING


|-valign="top"
|-valign="top" align="center"
|[[CO2 simulation]]
|[[GEOS-Chem 13.4.0]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CO2/v2015-04/README README1]<br>[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CO2/v2015-04/BIO/README README2]<br>[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CO2/v2015-04/BIOFUEL/README README3]<br>[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CO2/v2015-04/CHEM/README README4]<br>[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CO2/v2015-04/FOSSIL/README README5]<br>[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CO2/v2015-04/OCEAN/README README6]
|[https://github.com/geoschem/input-data-catalogs/blob/447e33da692d76aa044a590a0422ab3dd193f1b4/ChemistryInputs.csv <tt>ChemistryInputs.csv</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>
|[https://github.com/geoschem/input-data-catalogs/blob/447e33da692d76aa044a590a0422ab3dd193f1b4/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
|1033 MB
|[https://github.com/geoschem/input-data-catalogs/blob/447e33da692d76aa044a590a0422ab3dd193f1b4/InitialConditions.csv <tt>InitialConditions.csv</tt>]
|bgcolor="#00FF00"|DEFAULT SETTING


|-valign="top"
|-valign="top" align="center"  
|[[Mercury|Mercury simulation]]
|[[GEOS-Chem 13.3.0]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MERCURY/v2014-09/README README1]<br>[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MERCURY/v2014-09/ARTISANAL/README README2]<br>[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MERCURY/v2014-09/BrOx/README README3]<br>[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MERCURY/v2014-09/Hg2_PARTITION/README README4]<br>[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MERCURY/v2014-09/JVALUES/README README5]<br>[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MERCURY/v2014-09/NATURAL/README README6]<br>[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MERCURY/v2014-09/NEI2005/README README7]<br>[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MERCURY/v2014-09/OCEAN/README README8]<br>[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MERCURY/v2014-09/SOIL/README README9]<br>[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MERCURY/v2014-09/STREETS/README README10]
|[https://github.com/geoschem/input-data-catalogs/blob/ab638b19294d250a3cd5cca7092e23d98e207c13/ChemistryInputs.csv <tt>ChemistryInputs.csv</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>
|[https://github.com/geoschem/input-data-catalogs/blob/ab638b19294d250a3cd5cca7092e23d98e207c13/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
|342 MB
|[https://github.com/geoschem/input-data-catalogs/blob/ab638b19294d250a3cd5cca7092e23d98e207c13/InitialConditions.csv <tt>InitialConditions.csv</tt>]
|bgcolor="#00FF00"|DEFAULT SETTING


|-valign="top"
|-valign="top" align="center"
|[[POPs simulation]]
|[[GEOS-Chem 13.2.0]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/POPs/v2015-08/README README]
|[https://github.com/geoschem/input-data-catalogs/blob/a6decd86b2e974fbf2e934ad2391c28ee034d556/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
|<tt>$$ROOT/POPs/v2015-08</tt>
|[https://github.com/geoschem/input-data-catalogs/blob/a6decd86b2e974fbf2e934ad2391c28ee034d556/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
|809 MB
|[https://github.com/geoschem/input-data-catalogs/blob/a6decd86b2e974fbf2e934ad2391c28ee034d556/InitialConditions.csv <tt>InitialConditions.csv</tt>]
|bgcolor="#00FF00"|DEFAULT SETTING
*Data corresponds to the [[POPs_simulation#Updates_to_PAH_code|POPs simulation update in v11-01c]]


|-valign="top"
|-valign="top" align="center"
|[[Coupling GEOS-Chem with RRTMG|RRTMG radiative transfer model]]
|[[GEOS-Chem 13.1.0]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/RRTMG/v2018-11/README README]
|[https://github.com/geoschem/input-data-catalogs/blob/080450890278d9513895ef501ac142fe56ea9827/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
|<tt>$ROOT/RRTMG/v2018-11</tt>
|[https://github.com/geoschem/input-data-catalogs/blob/080450890278d9513895ef501ac142fe56ea9827/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
|19 MB
|[https://github.com/geoschem/input-data-catalogs/blob/080450890278d9513895ef501ac142fe56ea9827/InitialConditions.csv <tt>InitialConditions.csv</tt>]
|bgcolor="#00FF00"|DEFAULT SETTING
*Used in [[GEOS-Chem 12#12.1.0|GEOS-Chem 12.1.0]] and later versions
 
|-valign="top"
|[[Tagged CO simulation]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/TAGGED_CO/v2017-04/README README]
|<tt>$ROOT/TAGGED_CO/v2017-04</tt>
|260 KB
|bgcolor="#00FF00"|DEFAULT SETTING
*Contains files for the updated Tagged CO simulation in [[GEOS-Chem v11-02]]
 
|-valign="top"
|[[Tagged O3 simulation]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/TAGGED_O3/v2014-09/README README]
|<tt>$ROOT/TAGGED_O3/v2014-09</tt>
|372 MB
|bgcolor="#00FF00"|DEFAULT SETTING
 
|-valign="top"
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/O3/v2014-09/README O3 for offline simulations]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/O3/v2014-09/README README]
|<tt>$ROOT/O3/v2014-09</tt>
|130 MB
|bgcolor="#00FF00"|DEFAULT SETTING
 
|-valign="top"
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OH/v2014-09/README OH for offline simulations]
|<br>[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OH/v2014-09/v5-07-08/README README1]<br>[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OH/v2014-09/v7-02-03.GMI/README README2]
|<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
|bgcolor="#00FF00"|DEFAULT SETTING
 
|-valign="top"
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OXIDANTS/v2014-07/README H2O2 for offline simulations]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OXIDANTS/v2014-07/README README]
|<tt>$ROOT/OXIDANTS/v2014-07</tt>
|32 MB
|bgcolor="#00FF00"|DEFAULT SETTING
 
|-valign="top"
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CHLA/v2014-07/README Oceanic Chlorophyll-A for Hg simulations]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CHLA/v2014-07/README README]
|<tt>$ROOT/CHLA/v2014-07</tt>
|2.0 MB
|bgcolor="#00FF00"|DEFAULT SETTING
 
|-valign="top"
!colspan="5" bgcolor="#CCFFFF"|Obsolete inventories (superseded by newer developments)
 
|-valign="top"
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OXIDANTS/v2014-07/README CH3I simulation]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OXIDANTS/v2014-07/README README]
|<tt>$ROOT/CH3I/v2014-07</tt>
|280 KB
|bgcolor="#FF0000"|OBSOLETE
*This simulation is no longer used in GEOS-Chem (awaiting revival)
 
|-valign="top"
|[[POPs simulation]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/POPs/v2014-09/README README]
|<tt>$ROOT/POPs/v2014-09</tt>
|622 MB
|bgcolor="#FF0000"|OBSOLETE
*Superseded by <tt>v2015-08</tt>
 
|-valign="top"
|[[Tagged CO simulation]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/TAGGED_CO/v2014-08/README README]
|<tt>$ROOT/TAGGED_CO/v2014-08</tt>q
|260 KB
|bgcolor="#FF0000"|OBSOLETE
*Superseded by <tt>v2017-04</tt>
 
|}
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|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|Non-emissions data]] section for information about stratospheric bromine concentration data.''
 
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
!width="250px"|Inventory
!width="110px"|Data file info
!width="300px"|Path
!width="110px"|Directory size
!width="350px"|Status


|-valign="top" align="center"
|[[GEOS-Chem 13.0.0]]
|[https://github.com/geoschem/input-data-catalogs/blob/7a53a0c19b5972611486a91a4c45433da97ba7c9/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
|[https://github.com/geoschem/input-data-catalogs/blob/7a53a0c19b5972611486a91a4c45433da97ba7c9/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
|[https://github.com/geoschem/input-data-catalogs/blob/7a53a0c19b5972611486a91a4c45433da97ba7c9/InitialConditions.csv  <tt>InitialConditions.csv</tt>]


|}
|}


=== Natural emissions data ===
== Emissions reference ==
 
The following subdirectories of the HEMCO directory tree contain inventories natural emissions.
 
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
!width="250px"|Inventory
!width="110px"|Data file info
!width="300px"|Path
!width="110px"|Directory size
!width="350px"|Status
 
 
|}
 
----
 
=== 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.).
 
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
!width="250px"|Inventory
!width="110px"|Data file info
!width="300px"|Path
!width="110px"|Directory size
!width="350px"|Status
 
|-valign="top"
!colspan="5" bgcolor="#CCFFFF"|Active inventories (turned ON by default in the standard emissions configuration)
 
|-valign="top"
|Timezone offsets from UTC
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/TIMEZONES/v2015-02/README README]
|<tt>$ROOT/TIMEZONES/v2015-02</tt>
|264 KB
|bgcolor="#00FF00"|DEFAULT SETTING
*Used by HEMCO to compute emissions that depend on local time rather than on UTC time.
 
|-valign="top"
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/UVALBEDO/v2016-06/README UV surface albedoes]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/UVALBEDO/v2019-06/README README]
|<tt>$ROOT/UVALBEDO/v2019-06</tt>
|476 KB
|bgcolor="#00FF00"|DEFAULT SETTING
*Required inputs for the [[FAST-JX v7.0 photolysis mechanism]]
 
|-valign="top"
|TOMS/SBUV O3 columns
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/TOMS_SBUV/v2019-06/README README]
|<tt>$ROOT/TOMS_SBUV/v2019-06</tt>
|21 MB
|bgcolor="#00FF00"|DEFAULT SETTING
*Ignored if you are using [[GEOS-FP]] or [[MERRA-2]] meteorology. 
 
|-valign="top"
|[[Bromine_chemistry_mechanism#Source code and data files|Stratospheric Bry from CCM]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/STRAT/v2015-01/Bry/README README]
|<tt>$ROOT/STRAT/v2015-01/Bry</tt>
|385 MB
|bgcolor="#00FF00"|DEFAULT SETTING
*Required for the for the full-chemistry simulations.
 
|-valign="top"
|[[Stratospheric chemistry|GMI strat chem mechanism]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/GMI/v2015-02/README README]
|<tt>$ROOT/GMI/v2015-02</tt>
|16 GB
|bgcolor="#00FF00"|DEFAULT SETTING
*Used to compute P & L of species in the stratosphere.
 
|-valign="top"
|[[UCX chemistry mechanism]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/UCX/v2018-02/README README]
|<tt>$ROOT/UCX/v2018-02</tt>
|12 GB
|bgcolor="#00FF00"|DEFAULT SETTING
*Used to compute P & L of species in the stratosphere.
*Can be used instead of GMI.
 
|-valign="top"
|[[Leaf area indices in GEOS-Chem|MODIS XLAI<br>(leaf area index per land type)]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MODIS_XLAI/v2017-07/README README]
|<tt>$ROOT/MODIS_XLAI/v2017-07</tt>
|203 MB
|bgcolor="#00FF00"|TDEFAULT SETTING
*Added in [[GEOS-Chem 12#12.3.0|GEOS-Chem 12.3.0]]
 
|-valign="top"
|[[Olson land map|Olson land map<br>(masks for each land type)]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OLSON_MAP/v2019-02/README README]
|<tt>$ROOT/OLSON_MAP/v2019-02</tt>
|1.9 MB
|bgcolor="#00FF00"|TDEFAULT SETTING
*Added in [[GEOS-Chem 12#12.3.0|GEOS-Chem 12.3.0]]
*Used for regridding of MODIS_XLAI or Yuan_XLAI via HEMCO
 
|-valign="top"
|[[Leaf_area_indices_in_GEOS-Chem#Yuan_processed_MODIS_LAI|Yuan-processed MODIS XLAI<br>(leaf area index per land type)]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MODIS_XLAI/v2017-07/README README]
|<tt>$ROOT/Yuan_XLAI/v2019-03</tt>
|203 MB
|bgcolor="#00FF00"|TDEFAULT SETTING
*Added as option in [[GEOS-Chem 12#12.3.0|GEOS-Chem 12.3.0]]
 
|-valign="top"
!colspan="5" bgcolor="#CCFFFF"|Obsolete inventories (superseded by newer developments)
 
|-valign="top"
|TOMS/SBUV O3 columns
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/TOMS_SBUV/v2015-03/README README]
|<tt>$ROOT/TOMS_SBUV/v2015-03</tt>
|17 MB
|bgcolor="#FF0000"|OBSOLETE
*Superseded by <tt>v2016-11</tt>
 
|}
 
=== 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.
 
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
!width="250px"|Inventory
!width="110px"|Data file info
!width="300px"|Path
!width="110px"|Directory size
!width="350px"|Status
 
|-valign="top"
!colspan="5" bgcolor="#CCFFFF"|Active inventories (turned ON by default in the standard emissions configuration)
 
|-valign="top"
|[[Scale_factors_for_anthropogenic_emissions|Annual scale factors]]
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/AnnualScalar/v2014-07/README README]
|<tt>$ROOT/AnnualScalar/v2014-07</tt>
|3.0 MB
|bgcolor="#00FF00"|DEFAULT SETTING
*Used to scale NEI2005 and other emissions to years other than the inventory base year.
 
|-valign="top"
|[[EPA/NEI05_North_American_emissions|NEI2005 scale factors]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/NEI2005/v2014-09/README README]
|<tt>$ROOT/NEI2005/v2014-09</tt>
|8.1 MB
|bgcolor="#00FF00"|DEFAULT SETTING
 
|-valign="top"
|ID codes for each country
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/COUNTRY_ID/v2015-04/README README]
|<tt>$ROOT/COUNTRY_ID/v2015-04</tt>
|15 MB
|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&deg; x 0.1&deg; grid.  HEMCO can use these ID's to apply country-level scale factors to any emissions field.
 
|-valign="top"
|Mask files for regional emissions
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MASKS/v2014-07/README README]
|<tt>$ROOT/MASKS/v2014-07</tt>
|51 MB
|bgcolor="#00FF00"|DEFAULT SETTING
*Masks define the geographical regions where the various regional emissions (e.g. BRAVO, CAC, NEI) are to be applied.
 
|-valign="top"
|[[Regridding_in_GEOS-Chem|MAP_A2A regridding data]]
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MAP_A2A/v2014-07/README README]
|<tt>$ROOT/MAP_A2A/v2014-07</tt>
|152 KB
|bgcolor="#00FF00"|DEFAULT SETTING
 
|-valign="top"
!colspan="5" bgcolor="#CCFFFF"|Obsolete inventories (superseded by newer developments)
 
|-valign="top"
|[[Scale factors for anthropogenic emissions|Weekly scale factors]]
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/WEEKSCALE/v2014-07/README README]
|<tt>$ROOT/WEEKSCALE/v2014-07</tt>
|4.0 KB
|bgcolor="#FF0000"|OBSOLETE
*Not currently in use
|}
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 19:05, 2 July 2018 (UTC)
 
== The hemco_data_download package ==
 
=== Obtaining the hemco_data_download package ===
 
[[Image:Obsolete.jpg]]
 
<span style="color:red">'''''The hemco_data_download package will be retired in GEOS-Chem 12.7.0 in favor of the [[Downloading data with the GEOS-Chem dry-run option|GEOS-Chem dry run option]].'''''</span>
 
To obtain the hemco_data_download package, use Git to clone this repository
 
<nowiki>git clone https://github.com/GCST/hemco_data_download.git</nowiki>
 
This will create a directory named <tt>hemco_data_download</tt>, in which you should see the following files:
 
{| border=1 cellspacing=0 cellpadding=5
|-valign="top" bgcolor="#CCCCCC"
!width="200px"|File
!width="800px"|Description
 
|-valign="top"
|<tt>README</tt>
|File with an overall description of the directory contents
 
|-valign="top"
|<tt>hemcoDataDownload.pl</tt>
|Perl script to download HEMCO data directories
 
|-valign="top"
|<tt>hemcoDataDownload.rc</tt>
|Configuration file for the <tt>hemcoDataDownload.pl</tt> script.  In this file you can specify which HEMCO data directories you would like to download and which you would like to omit.
 
|-valign="top"
|<tt>forTesting.rc</tt>
|A configuration file that you can use for testing or debugging. This will tell <tt>hemcoDataDownload.pl</tt> only to download a couple of emissions inventories with files that do not take up much disk space.
 
|}
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 17:02, 5 December 2016 (UTC)
 
=== Setting up the configuration file ===
 
[[Image:Obsolete.jpg]]
 
<span style="color:red">'''''The hemco_data_download package will be retired in GEOS-Chem 12.7.0 in favor of the [[Downloading data with the GEOS-Chem dry-run option|GEOS-Chem dry run option]].'''''</span>
 
The configuration files (i.e. <tt>hemcoDataDownload.rc</tt> and <tt>forTesting.rc</tt>) 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.        #
#                                                                            #
###############################################################################
<nowiki>Remote HEMCO data path | ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO</nowiki>
Your HEMCO data path  | /as/scratch/bmy/HEMCO
Verbose output        | yes
Dryrun only?          | no
 
{| border=1 cellspacing=0 cellpadding=5
|-valign="top" bgcolor="#CCCCCC"
!width="200px"|Path
!width="800px"|Description
 
|-valign="top"
|<tt>Remote HEMCO data path</tt>
|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.
 
|-valign="top"
|<tt>Your HEMCO data path</tt>
|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.
 
|-valign="top"
|<tt>Verbose output</tt>
|Lets you specify if you want to print out extra output during the download process. This can be set to either "yes" or "no".
 
|-valign="top"
|<tt>Dryrun only</tt>
|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 <tt>$ROOT</tt> 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 ...
 
--[[User:Bmy|Bob Y.]] 13:55, 12 February 2015 (EST)
 
=== Downloading the data ===
 
[[Image:Obsolete.jpg]]
 
<span style="color:red">'''''The hemco_data_download package will be retired in GEOS-Chem 12.7.0 in favor of the [[Downloading data with the GEOS-Chem dry-run option|GEOS-Chem dry run option]].'''''</span>
 
Once you have [[#Setting up the configuration file|set up your configuration file]], you can run the <tt>hemcoDataDownload.pl</tt> 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 <tt>hemcoDataDownload.pl</tt> scriptwill read the default configuration file <tt>hemcoDataDownload.rc</tt> 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 <tt>forTesting.rc</tt>.  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.
 
--[[User:Bmy|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:
 
#''[[Preparing data files for use with HEMCO|''Preparing data files for use with HEMCO]]''
#''[[Submitting updates for inclusion in GEOS-Chem]]''


--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 22:24, 14 January 2020 (UTC)
For more information about the various emissions inventories used by GEOS-Chem, please see our [[GEOS-Chem emissions]] wiki page.

Latest revision as of 21:17, 30 March 2023

Overview

On this page, we provide lists of data (chemistry inputs, emissions, initial conditions, and meteorology) that are read into GEOS-Chem by the Harmonized Emissions Component (HEMCO). These data reside at geoschemdata.wustl.edu and at the s3://gcgrid Amazon S3 bucket.

Data directories by GEOS-Chem version

Our input-data-catalogs Github repository contains lists of input files needed to run GEOS-Chem simulations. These are contained in the comma-separated files ChemistryInputs.csv, EmissionInputs.csv and InitialConditions.csv, and MeteorologicalInputs.csv.

Passing any of these files as input to the bashdatacatalog utility will initiate a data transfer to your local disk storage.

Version Chemistry Inputs Emissions Inputs Initial Conditions
GEOS-Chem 14.1.1 ChemistryInputs.csv EmissionInputs.csv InitialConditions.csv
GEOS-Chem 14.1.0 ChemistryInputs.csv EmissionInputs.csv InitialConditions.csv
GEOS-Chem 14.0.0 ChemistryInputs.csv EmissionInputs.csv InitialConditions.csv
GEOS-Chem 13.4.0 ChemistryInputs.csv EmissionInputs.csv InitialConditions.csv
GEOS-Chem 13.3.0 ChemistryInputs.csv EmissionInputs.csv InitialConditions.csv
GEOS-Chem 13.2.0 ChemistryInputs.csv EmissionInputs.csv InitialConditions.csv
GEOS-Chem 13.1.0 ChemistryInputs.csv EmissionInputs.csv InitialConditions.csv
GEOS-Chem 13.0.0 ChemistryInputs.csv EmissionInputs.csv InitialConditions.csv

Emissions reference

For more information about the various emissions inventories used by GEOS-Chem, please see our GEOS-Chem emissions wiki page.

Retrieved from "https://wiki.seas.harvard.edu/geos-chem/index.php?title=HEMCO_data_directories&oldid=52309"