Difference between revisions of "HEMCO data directories"

From Geos-chem
Jump to: navigation, search
(Obtaining the hemco_data_download package)
(Data directories by GEOS-Chem version)
 
(427 intermediate revisions by 3 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 dataWe 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.
+
== Data directories by GEOS-Chem version ==
  
--[[User:Bmy|Bob Y.]] 10:22, 13 February 2015 (EST)
+
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>]
  
== HEMCO data directory structure ==
+
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.
 
+
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"|CURRENTLY USED
+
|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
+
|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.
+
 
+
|-valign="top"
+
|bgcolor="#FFFF00"|TO BE ADDED SOON
+
|Denotes that the data set is not yet ready for use with HEMCO, but will be added soon.
+
 
+
|-valign="top"
+
|bgcolor="#FF0000"|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. 
+
 
+
|-valign="top"
+
|bgcolor="#FF0000"|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 CURRENTLY USED, 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)
+
 
+
=== Aerosol emissions ===
+
 
+
The following subdirectories of the HEMCO directory tree contain aerosol emission inventories.
+
  
 
{| 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"
|[[Volcanic_SO2_emissions_from_Aerocom|AEROCOM volcanic emissions]]
+
|[[GEOS-Chem 14.1.1]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/VOLCANO/v2015-02/README README]
+
|[https://github.com/geoschem/input-data-catalogs/blob/2f9992f7c5d9285a18c8ff326a7eff6e04758ee4/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
|<tt>$ROOT/VOLCANO/v2015-02</tt>
+
|[https://github.com/geoschem/input-data-catalogs/blob/2f9992f7c5d9285a18c8ff326a7eff6e04758ee4/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
|1.6 GB
+
|[https://github.com/geoschem/input-data-catalogs/blob/2f9992f7c5d9285a18c8ff326a7eff6e04758ee4/InitialConditions.csv <tt>InitialConditions.csv</tt>]
|bgcolor="#00FF00"|CURRENTLY USED
+
*Default global inventory for volcanic SO2.
+
  
|-valign="top"
+
|-valign="top" align="center"
|[[Carbonaceous_aerosols#EC_and_OC_emissions|Tami Bond et al (2007) BC and OC emissions]]
+
|[[GEOS-Chem 14.1.0]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/BCOC_BOND/v2014-07/README README]
+
|[https://github.com/geoschem/input-data-catalogs/blob/fe46b1e55a07a26e5f7eefe9e79776bb83e20eed/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
|<tt>$ROOT/BCOC_BOND/v2014-07</tt>
+
|[https://github.com/geoschem/input-data-catalogs/blob/fe46b1e55a07a26e5f7eefe9e79776bb83e20eed/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
|3.0 MB
+
|[https://github.com/geoschem/input-data-catalogs/blob/fe46b1e55a07a26e5f7eefe9e79776bb83e20eed/InitialConditions.csv <tt>InitialConditions.csv</tt>]
|bgcolor="#00FF00"|CURRENTLY USED
+
*Default global inventory for black carbon (BC) and organic carbon (OC).
+
  
|-valign="top"
+
|-valign="top" align="center"
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/SOA/v2014-07/README Secondary organic aerosols]
+
|[[GEOS-Chem 14.0.0]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/SOA/v2014-07/README README]
+
|[https://github.com/geoschem/input-data-catalogs/blob/e61ca36cdbd1c1bfeb58ff20a5633c97dcc48164/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
|<tt>$ROOT/HEMCO/SOA/2014-07</tt>
+
|[https://github.com/geoschem/input-data-catalogs/blob/e61ca36cdbd1c1bfeb58ff20a5633c97dcc48164/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
|3.0 MB
+
|[https://github.com/geoschem/input-data-catalogs/blob/e61ca36cdbd1c1bfeb58ff20a5633c97dcc48164/InitialConditions.csv <tt>InitialConditions.csv</tt>]
|bgcolor="#00FF00"|CURRENTLY USED
+
*Contain various inputs for SOA simulations.
+
  
|-valign="top"
+
|-valign="top" align="center"
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/BCOC_COOKE/v2014-07/README Cooke et al BC and OC emissions]
+
|[[GEOS-Chem 13.4.0]]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/BCOC_COOKE/v2014-07/README README]
+
|[https://github.com/geoschem/input-data-catalogs/blob/447e33da692d76aa044a590a0422ab3dd193f1b4/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
|<tt>$ROOT/BCOC_COOKE/v2014-07</tt>
+
|[https://github.com/geoschem/input-data-catalogs/blob/447e33da692d76aa044a590a0422ab3dd193f1b4/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
|744 KB
+
|[https://github.com/geoschem/input-data-catalogs/blob/447e33da692d76aa044a590a0422ab3dd193f1b4/InitialConditions.csv <tt>InitialConditions.csv</tt>]
|bgcolor="#FFFF00"|OPTIONAL
+
*Can be used in place of Bond et al (2007).
+
  
|}
+
|-valign="top" align="center"
 +
|[[GEOS-Chem 13.3.0]]
 +
|[https://github.com/geoschem/input-data-catalogs/blob/ab638b19294d250a3cd5cca7092e23d98e207c13/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
 +
|[https://github.com/geoschem/input-data-catalogs/blob/ab638b19294d250a3cd5cca7092e23d98e207c13/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
 +
|[https://github.com/geoschem/input-data-catalogs/blob/ab638b19294d250a3cd5cca7092e23d98e207c13/InitialConditions.csv <tt>InitialConditions.csv</tt>]
  
--[[User:Bmy|Bob Y.]] 10:15, 18 March 2015 (EDT)
+
|-valign="top" align="center"
 +
|[[GEOS-Chem 13.2.0]]
 +
|[https://github.com/geoschem/input-data-catalogs/blob/a6decd86b2e974fbf2e934ad2391c28ee034d556/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
 +
|[https://github.com/geoschem/input-data-catalogs/blob/a6decd86b2e974fbf2e934ad2391c28ee034d556/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
 +
|[https://github.com/geoschem/input-data-catalogs/blob/a6decd86b2e974fbf2e934ad2391c28ee034d556/InitialConditions.csv <tt>InitialConditions.csv</tt>]
  
=== Anthropogenic and biofuel emissions ===
+
|-valign="top" align="center"
 +
|[[GEOS-Chem 13.1.0]]
 +
|[https://github.com/geoschem/input-data-catalogs/blob/080450890278d9513895ef501ac142fe56ea9827/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
 +
|[https://github.com/geoschem/input-data-catalogs/blob/080450890278d9513895ef501ac142fe56ea9827/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
 +
|[https://github.com/geoschem/input-data-catalogs/blob/080450890278d9513895ef501ac142fe56ea9827/InitialConditions.csv <tt>InitialConditions.csv</tt>]
  
The following subdirectories of the HEMCO directory tree contain inventories of anthropogenic and biofuel emissions.
+
|-valign="top" align="center"
 
+
|[[GEOS-Chem 13.0.0]]
Please also see list of species included in each of these [[Anthropogenic_emissions#Global_inventories|global inventories]] and [[Anthropogenic_emissions#Regional_inventories|regional inventories]].
+
|[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>]
{| border=1 cellspacing=0 cellpadding=5
+
|[https://github.com/geoschem/input-data-catalogs/blob/7a53a0c19b5972611486a91a4c45433da97ba7c9/InitialConditions.csv <tt>InitialConditions.csv</tt>]
|- bgcolor="#cccccc"
+
!width="250px"|Inventory
+
!width="110px"|Data file info
+
!width="300px"|Path
+
!width="110px"|Directory size
+
!width="350px"|Status
+
 
+
|-valign="top"
+
|[[EDGAR v4.2 anthropogenic emissions|EDGAR v4.2 global anthropogenic]]
+
||[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/EDGARv42/v2015-02/README README]
+
|<tt>$ROOT/EDGARv42/v2015-02<br>$ROOT/EDGARv42/v2015-02/CO<br>$ROOT/EDGARv42/v2015-02/NH3<br>$ROOT/EDGARv42/v2015-02/NO<br>$ROOT/EDGARv42/v2015-02/SO2<br>$ROOT/EDGARv42/v2015-02/VOCv2</tt>
+
|4.5 GB
+
|bgcolor="#00FF00"|CURRENTLY USED
+
*Default global inventory for NOx, CO, SO2, and NH3 (replaces [[EDGAR v3 anthropogenic emissions|EDGAR v3]]).
+
*The following sectors are not used:
+
**EDGAR v4.2 ship emissions
+
**EDGAR v4.2 soil NO emissions
+
**EDGAR v4.2 biomass emissions
+
*NAP is still taken from EDGAR v2 data.
+
 
+
|-valign="top"
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/NH3/v2014-07/README GEIA NH3 (anthro, biofuel, 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"|CURRENTLY USED
+
*Default global inventory for biofuel & natural NH3.
+
*Anthro NH3 is overwritten by [[EDGAR v4.2 anthropogenic emissions|EDGAR v4.2]]
+
*Slated for replacement after [[GEOS-Chem v10-01]] ships.
+
 
+
|-valign="top"
+
|[[Implementation_of_RETRO_Anthropogenic_Emissions|RETRO VOC emissions]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/RETRO/v2014-07/orig_kgC/README README]
+
|<tt>$ROOT/RETRO/v2014-07/orig_kgC</tt>
+
|38 MB
+
|bgcolor="#00FF00"|CURRENTLY USED
+
*Default global inventory for VOC species.
+
*[[Implementation_of_RETRO_Anthropogenic_Emissions#RETRO_anthropogenic_ethane_emissions_are_too_low|C2H6 is replaced by Y. Xiao et al emissions]].
+
 
+
|-valign="top"
+
|[[Biofuel_emissions#Yevich_.26_Logan_inventory|Yevich & Logan biofuels]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/BIOFUEL/v2014-07/README README]
+
|<tt>$ROOT/BIOFUEL/v2014-07</tt>
+
|1.1 MB
+
|bgcolor="#00FF00"|CURRENTLY USED
+
*Default global biofuel emissions inventory.
+
 
+
|-valign="top"
+
|[[Anthropogenic_emissions#BRAVO|BRAVO regional anthropogenic]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/BRAVO/v2014-07/README README]
+
|<tt>$ROOT/BRAVO/v2014-07</tt>
+
|68 KB
+
|bgcolor="#00FF00"|CURRENTLY USED
+
*Overwrites CO, NO, and SO2 over Mexico.
+
 
+
|-valign="top"
+
|rowspan="2"|[[Anthropogenic_emissions#CAC|CAC regional anthropogenic]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/CAC/v2016-09/README README]
+
|<tt>$ROOT/CAC/v2016-09</tt>
+
|29 MB
+
|bgcolor="#FFFF00"|TO BE ADDED SOON
+
*Overwrites CO, NO, NH3, and SOx over Canada.
+
*NEW: Includes data at 0.1&deg; x 0.1&deg; resolution
+
*NEW: Will be used by default starting with [[GEOS-Chem v11-01#v11-01j|v11-01j]]
+
 
+
|-valign="top"
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CAC/v2014-07/README README]
+
|<tt>$ROOT/CAC/v2014-07</tt>
+
|384 KB
+
|bgcolor="#00FF00"|CURRENTLY USED
+
*Overwrites CO, NO, NH3, and SOx over Canada.
+
 
+
|-valign="top"
+
|[[EMEP_European_anthropogenic_emissions|EMEP regional anthropogenic]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/EMEP/v2015-03/README README]
+
|<tt>$ROOT/EMEP/v2015-03</tt>
+
|24 MB
+
|bgcolor="#00FF00"|CURRENTLY USED
+
*Overwrites CO, NH3, NO, SO2, PRPE, ALK4, C2H6, ALD2, and MEK over Europe.
+
 
+
|-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="#00FF00"|CURRENTLY USED
+
*Replaces David Streets et al emissions.
+
*The base years for MIX is 2008 and 2010, as opposed to 2006 for Streets.
+
 
+
|-valign="top"
+
|[[EPA/NEI05_North_American_emissions|NEI2005 regional anthro/biofuel]]
+
|[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"|CURRENTLY USED
+
*Overwrites ACET, ALK4, ALD2, BC, C2H6, C3H8, CO, CH2O, MEK, NH3, NIT, NO, OC, PRPE, SO2, and SO4 over the USA.
+
*Use NEI2011 for simulations covering the period 2006-2013; otherwise use NEI2005.
+
*NOTE: NEI2005 is eventually going to be retired.
+
 
+
|-valign="top"
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/VISTAS/v2014-07/README NEI/VISTAS scale factors]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/VISTAS/v2014-07/VISTAS_NOX/README README1]<br>[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/VISTAS/v2014-07/VISTAS_WEWD/README README2]
+
|<tt>$ROOT/VISTAS/v2014-07<br>$ROOT/VISTAS/v2014-07/VISTAS_NOX<br>$ROOT/VISTAS/v2014-07/VISTAS_WEWD</tt>
+
|46 MB
+
|bgcolor="#00FF00"|CURRENTLY USED
+
*Used to scale NO in the NEI2005 inventory.
+
 
+
|-valign="top"
+
|[[EPA/NEI11_North_American_emissions|NEI2011 regional anthro/biofuel]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/NEI2011/v2015-03/README README]
+
|<tt>$ROOT/NEI2011/v2015-03</tt>
+
|248 GB
+
|bgcolor="#00FF00"|CURRENTLY USED
+
*Overwrites CO, NO, NO2, HNO2, NH3, CH2O, RCHO, MACR, ACET, ALK4, PRPE, EOH, MOH, XYLE, TOLU, BENZ, SO2, SO4,  C2H4, C2H6, C3H8, ALD2, BC, and OC over the USA.
+
*Use NEI2011 for simulations covering the period 2006-2013; otherwise use NEI2005.
+
 
+
|-valign="top"
+
|[[EPA/NEI11_North_American_emissions#Agricultural sector|NEI2011 agricultural emissions only]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/NEI2011_ag_only/v2015-02/README README]
+
|<tt>$ROOT/NEI2011_ag_only/v2015-03</tt>
+
|648 MB
+
|bgcolor="#00FF00"|CURRENTLY USED
+
 
+
|-valign="top"
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/XIAO/v2014-09/README Yaping Xiao et al C2H6 and C3H8 anthropogenic]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/XIAO/v2014-09/README README]
+
|<tt>$ROOT/XIAO/v2014-09</tt>
+
|308 KB
+
|bgcolor="#00FF00"|CURRENTLY USED
+
*[[Implementation_of_RETRO_Anthropogenic_Emissions#RETRO_anthropogenic_ethane_emissions_are_too_low|Overwrites RETRO C2H6]], which is problematic.
+
 
+
|-valign="top"
+
|[[MASAGE NH3 inventory|MASAGE agricultural NH3]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MASAGE_NH3/v2015-02/README README]
+
|<tt>$ROOT/MASAGE_NH3/v2015-02</tt>
+
|4.4 MB
+
|bgcolor="#FFFF00"|OPTIONAL
+
*Adds to the anthropogenic NH3 category.
+
 
+
|-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
+
*Can be used instead of EDGAR v4.2 emissions.
+
*NOTE: HTAP includes some regional emissions from other inventoriesIf 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"
+
|[[David_Streets_regional_emissions_for_China_and_SE_Asia|Streets regional anthro]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/STREETS/v2014-07/2000/README README1]<br>[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/STREETS/v2014-07/2006/README README2]
+
|<tt>$ROOT/STREETS/v2014-07</tt>
+
|1.7 MB
+
|bgcolor="#FFFF00"|OPTIONAL
+
*Streets is being retired in favor of MIX.
+
*We will keep Streets as a research option.  You may use it if you wish.
+
 
+
|-valign="top"
+
|[[EPA/NEI08_North_American_emissions|NEI2008 regional anthro/biofuel]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/NEI2008/v2015-02/README README]
+
|<tt>$ROOT/NEI2008/v2015-02</tt>
+
|3.0 GB
+
|bgcolor="#FFFF00"|TO BE ADDED SOON
+
 
+
|-valign="top"
+
|[[Anthropogenic_emissions#GEIA.2FPiccot|GEIA global anthropogenic]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/GEIA/v2014-07/README README]
+
|<tt>$ROOT/GEIA/v2014-07</tt>
+
|4.8 MB
+
|bgcolor="#FF0000"|OBSOLETE
+
*Slated for replacement by newer inventories
+
 
+
|-valign="top"
+
|[[EDGAR v3 anthropogenic emissions|EDGAR v3 global anthropogenic]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/EDGAR/v2014-07/README README]
+
|<tt>$ROOT/EDGAR/v2014-07</tt>
+
|40 MB
+
|bgcolor="#FF0000"|OBSOLETE
+
*EDGAR v3 has been replaced by [[EDGAR v4.2 anthropogenic emissions|EDGAR v4.2]].
+
  
 
|}
 
|}
  
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:27, 1 November 2016 (UTC)
+
== Emissions reference ==
 
+
=== Anthropogenic aircraft and 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="110px"|Data file info
+
!width="300px"|Path
+
!width="110px"|Directory size
+
!width="350px"|Status
+
 
+
|-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"|CURRENTLY USED
+
*Default global aircraft emissions inventory.
+
*Contains fuel burned, NO, CO, and hydrocarbons.
+
 
+
|-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="#00FF00"|CURRENTLY USED
+
*Default inventory for ship SO2.
+
*Overwritten by EMEP over Europe.
+
 
+
|-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="#00FF00"|CURRENTLY USED
+
*Default inventory for ship CO.
+
*Overwritten by EMEP over Europe.
+
 
+
|-valign="top"
+
|[[EMEP_European_anthropogenic_emissions|EMEP ship (CO, NO, SO2)]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/EMEP/v2015-03/README README]
+
|<tt>$ROOT/EMEP/v2015-03</tt>
+
|24 MB
+
|bgcolor="#00FF00"|CURRENTLY USED
+
*Overwrites ship CO, NO, SO2 over Europe.
+
*Stored together w/ other EMEP data files.
+
 
+
|-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
+
*Can be used to overwrite ARCTAS ship SO2.
+
 
+
|-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
+
*Stored together with other HTAP data files.
+
*[http://edgar.jrc.ec.europa.eu/htap/EDGAR-HTAP_v1_final_jan2012.pdf See this document] for more information.
+
 
+
|-valign="top"
+
|[[EPA/NEI11_North_American_emissions|NEI2011 ship (several species)]]
+
|[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
+
*Can be used to overwrite the following ship emissions over North America: NO, NO2, HONO, CO, NH3, CH2O, RCHO, MACR, ACET, C3H8, MEK, ALK4, PRPE, EOH, MOH, XYLE, TOLU, BENZ, SO2, SO4, C2H4, C2H6, ALD2, BCPI, BCPO, OCPI, OCPO.
+
 
+
|-valign="top"
+
|[[EDGAR v3 anthropogenic emissions|EDGAR v3 ship (CO)]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/EDGAR/v2014-07/README README]
+
|<tt>$ROOT/EDGAR/v2014-07</tt>
+
|40 MB
+
|bgcolor="#FF0000"|OBSOLETE
+
 
+
|-valign="top"
+
|[[EDGAR v4.2 anthropogenic emissions|EDGAR v4.2 ship]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/EDGARv42/v2015-02/README README]
+
|<tt>$ROOT/EDGARv42/v2015-02</tt>
+
|4.5 GB
+
|bgcolor="#FF0000"|NOT USED
+
*EDGAR v4.2 ship emissions are not used because they are lumped with other non-road transportation sectors (aircraft, rail, etc), and thus cannot be easily separated.
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Y.]] 10:07, 18 March 2015 (EDT)
+
 
+
=== Biomass burning emissions ===
+
 
+
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"
+
|rowspan=2|[[GFED4 biomass burning emissions|GFED4 biomass burning]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/GFED4/v2015-10/README README]
+
|<tt>$ROOT/GFED4/v2015-10</tt>
+
|692 MB
+
|bgcolor="#FFFF00"|TO BE ADDED SOON
+
*This is GFED v4.1, which will be the default starting with [[GEOS-Chem v11-01#v11-01d|v11-01d]]
+
 
+
|-valign="top"
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/GFED4/v2015-03/README README]
+
|<tt>$ROOT/GFED4/v2015-06</tt>
+
|115 MB
+
|bgcolor="#00FF00"|CURRENTLY USED
+
*'''NOTE: The officially-released GFED4 product is now available as of 05 Jun 2015.  You should use this for your simulations.'''
+
**'''The official GFED4 data are now stored in the <tt>v2015-06/</tt> subdirectory. 
+
**'''The preliminary GFED4 data (in <tt>v2015-03/</tt>) should no longer be used.'''
+
*Default global biomass burning inventory.
+
*Monthly-mean data is available from 1998-2014
+
*Uses daily scale factors from GFED3.
+
*Uses 3-hourly scale factors from GFED3.
+
 
+
|-valign="top"
+
|[[GFED3 biomass burning emissions|GFED3 biomass burning]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/GFED3/v2014-10/README README]
+
|<tt>$ROOT/GFED3/v2014-10</tt>
+
|343 MB
+
|bgcolor="#00FF00"|CURRENTLY USED
+
*GEOS-Chem benchmarks now use GFED4 monthly data, but
+
**The <tt>GFED_daily</tt> option reads daily scale factors from the GFED3 data directory.
+
**The <tt>GFED_3hourly</tt> option reads 3-hourly scale factors from the GFED3 data directory.
+
 
+
|-valign="top"
+
|[[FINN biomass_burning_emissions|FINN biomass burning]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/FINN/v2015-02/README README]
+
|<tt>$ROOT/FINN/v2015-02</tt>
+
|689 MB
+
|bgcolor="#FFFF00"|OPTIONAL
+
*You may choose to replace GFED with FINN for research purposes. 
+
*If you do not need FINN, you may choose not to download it, in order to save disk space.
+
 
+
|-valign="top"
+
|[[QFED_biomass_burning_emissions|QFED biomass burning]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/QFED/v2014-09/README README]
+
|<tt>$ROOT/QFED/v2014-09</tt>
+
|57 GB
+
|bgcolor="#FFFF00"|OPTIONAL
+
*You may choose to replace GFED with QFED for research purposes.
+
*If you do not need QFED, you may choose not to download it, in order to save disk space.
+
 
+
|-valign="top"
+
|[[GFED2 biomass burning emissions|GFED2 biomass burning]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/GFED2/v2014-07/README README]
+
|<tt>$ROOT/GFED2/v2014-07</tt>
+
|196 KB
+
|bgcolor="#FF0000"|OBSOLETE
+
*Superseded by GFED4.
+
 
+
|-valign="top"
+
|[[Biomass_burning_emissions#Duncan_et_al_.22Interannual.22_Biomass_Emissions|Duncan et al biomass burning]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/BIOBURN/v2014-07/README README]
+
|<tt>$ROOT/BIOBURN/v2014-07</tt>
+
|925 MB
+
|bgcolor="#FF0000"|OBSOLETE
+
*Superseded by GFED4.
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:47, 1 November 2016 (UTC)
+
 
+
=== Bromine emissions ===
+
 
+
The following subdirectories of the HEMCO directory tree contain inventories of bromine 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
+
|-
+
|[[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"|CURRENTLY USED
+
|}
+
 
+
--[[User:Bmy|Bob Y.]] 15:03, 17 March 2015 (EDT)
+
 
+
=== 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 [[FINN biomass burning emissions|FINN]] 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"|CURRENTLY USED
+
 
+
|-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="#00FF00"|CURRENTLY USED
+
*Default dust mobilization scheme
+
 
+
|-valign="top"
+
|rowspan=2|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="#FFFF00"|TO BE ADDED SOON
+
*NEW: Uses Lana 2011 climatology
+
*NEW: Will be used by default starting with [[GEOS-Chem v11-01#v11-01b|v11-01b]]
+
 
+
|-valign="top"
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/DMS/v2014-07/README README]
+
|<tt>$ROOT/DMS/v2014-07</tt>
+
|2.2 MB
+
|bgcolor="#00FF00"|CURRENTLY USED
+
 
+
|-valign="top"
+
|[[MEGAN_v2.1_plus_Guenther_2012_biogenic_emissions|MEGAN biogenic emissions]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MEGAN/v2015-02/README README]
+
|<tt>$ROOT/MEGAN/v2015-02</tt>
+
|2.0 MB
+
|bgcolor="#00FF00"|CURRENTLY USED
+
*Default global biogenic emissions inventory.
+
 
+
|-valign="top"
+
|[[Lightning_NOx_emissions|NO from lightning]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/LIGHTNOX/v2014-07/README README]
+
|<tt>$ROOT/LIGHTNOX/v2014-07</tt>
+
|13 MB
+
|bgcolor="#00FF00"|CURRENTLY USED
+
 
+
|-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="#00FF00"|CURRENTLY USED
+
 
+
|-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"|CURRENTLY USED
+
*Computes the aging of emissions in ship exhaust plumes.
+
 
+
|-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.
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Y.]] 10:09, 18 March 2015 (EDT)
+
 
+
=== Future and historical 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="110px"|Data file info
+
!width="300px"|Path
+
!width="110px"|Directory size
+
!width="350px"|Status
+
|-valign="top"
+
|[[RCP_future_emissions_scenarios#RCP_scenarios_in_GEOS-Chem_v10-01_and_higher_versions|RCP future scenarios]]
+
|[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.
+
|}
+
 
+
--[[User:Bmy|Bob Y.]] 15:04, 17 March 2015 (EDT)
+
 
+
=== GEOS-Chem specialty simulation data ===
+
 
+
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.
+
 
+
{| 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"
+
|[[Aerosol-only simulation]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OFFLINE_AEROSOL/v2014-09/README README]
+
|<tt>$ROOT/OFFLINE_AEROSOL/v2014-09</tt>
+
|165 MB
+
|bgcolor="#00FF00"|CURRENTLY USED
+
 
+
|-valign="top"
+
|[[CH4 simulation]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CH4/v2014-09/README README]
+
|<tt>$ROOT/CH4/v2014-09</tt>
+
|274 MB
+
|bgcolor="#00FF00"|CURRENTLY USED
+
 
+
|-valign="top"
+
|[[CO2 simulation]]
+
|[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]
+
|<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
+
|bgcolor="#00FF00"|CURRENTLY USED
+
 
+
|-valign="top"
+
|[[Mercury|Mercury simulation]]
+
|[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]
+
|<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
+
|bgcolor="#00FF00"|CURRENTLY USED
+
 
+
|-valign="top"
+
|rowspan="2"|[[POPs simulation]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/POPs/v2015-08/README README]
+
|<tt>$$ROOT/POPs/v2015-08</tt>
+
|809 MB
+
|bgcolor="#FFFF00"|TO BE ADDED SOON
+
*Data corresponds to the [[POPs_simulation#Updates_to_PAH_code|POPs simulation update in v11-01c]]
+
 
+
|-valign="top"
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/POPs/v2014-09/README README]
+
|<tt>$ROOT/POPs/v2014-09</tt>
+
|622 MB
+
|bgcolor="#00FF00"|CURRENTLY USED
+
 
+
|-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>
+
|260 KB
+
|bgcolor="#00FF00"|CURRENTLY USED
+
 
+
|-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"|CURRENTLY USED
+
 
+
|-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"|CURRENTLY USED
+
 
+
|-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"|CURRENTLY USED
+
 
+
|-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"|CURRENTLY USED
+
 
+
|-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"|CURRENTLY USED
+
 
+
|-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)
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:53, 1 November 2016 (UTC)
+
 
+
=== 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"
+
|[[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"|CURRENTLY USED
+
*Used to compute P & L of species in the stratosphere.
+
 
+
|-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"|CURRENTLY USED
+
*Required for the for the full-chemistry simulations.
+
 
+
|-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"|CURRENTLY USED
+
*Used by HEMCO to compute emissions that depend on local time rather than on UTC time.
+
 
+
|-valign="top"
+
|rowspan="2"|TOMS/SBUV O3 columns
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/TOMS_SBUV/v2016-11/README README]
+
|<tt>$ROOT/TOMS_SBUV/v2016-11</tt>
+
|21 MB
+
|bgcolor="#FFFF00"|TO BE ADDED SOON
+
*These files are the same data as in <tt>$ROOT/TOMS_SBUV/v2015-03</tt>, but were reprocessed by Barron Henderson in order [[FAST-JX_v7.0_photolysis_mechanism#Fix_for_TOMS_to_address_strange_cycle_in_OH_output|in order to fix a strange cycle in OH output when running GEOS-Chem with GEOS-5 met]].
+
*This will be the default starting with [[GEOS-Chem v11-01#v11-01j|v11-01j]].
+
 
+
|-valign="top"
+
|[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="#00FF00"|CURRENTLY USED
+
*Used as an input to the [[FAST-JX_v7.0_photolysis_mechanism|FAST-JX photolysis mechanism]].
+
*Ignored if you are using [[GEOS-FP]] meteorology. 
+
 
+
|-valign="top"
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/UVALBEDO/v2015-03/README UV surface albedoes]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/UVALBEDO/v2015-03/README README]
+
|<tt>$ROOT/UVALBEDO/v2015-03</tt>
+
|468 KB
+
|bgcolor="#00FF00"|CURRENTLY USED
+
* Used as an input to the [[FAST-JX_v7.0_photolysis_mechanism|FAST-JX photolysis mechanism]].
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 21:45, 3 November 2016 (UTC)
+
 
+
=== 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"
+
|[[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"|CURRENTLY USED
+
*Used to scale NEI2005 and other emissions to years other than the inventory base year.
+
 
+
|-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"|CURRENTLY USED
+
*[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"|CURRENTLY USED
+
*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"|CURRENTLY USED
+
 
+
|-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 Y.]] 15:08, 17 March 2015 (EDT)
+
 
+
== Downloading the HEMCO data directories ==
+
 
+
The [[GEOS-Chem Support Team]] has created a package called [https://github.com/GCST/hemco_data_download '''hemco_data_download'''].  With this package, you can download the various emissions inventories and related data files for HEMCO to your own disk server.  Furthermore, you can specify which data directories that you would like to download (as well as those you would like to ignore) via a configuration file.
+
 
+
=== Obtaining the hemco_data_download package ===
+
 
+
To obtain the hemco_data_download package, use Git to clone this repository
+
 
+
<nowiki>git clone https://bitbucket.org/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:
+
 
+
;<tt>README</tt> : File with an overall description of the directory contents
+
;<tt>hemcoDataDownload.pl</tt> : Perl script to download HEMCO data directories
+
;<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.
+
;<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]]) 18:10, 1 December 2016 (UTC)
+
 
+
=== Setting up the configuration file ===
+
 
+
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
+
 
+
#'''Remote HEMCO data path''' is the 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''' specifies 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''' flag allows you to print out the data download commands without actually downloading the data. This is useful for debugging.
+
 
+
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 ===
+
 
+
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)
+
 
+
=== New features for the GEOS-Chem v10-01 public release ===
+
 
+
For the [[GEOS-Chem v10-01]] public release, we modified the default download options in the <tt>hemcoDataDownload.pl</tt> script.  We changed the default <tt>wget</tt> options from:
+
 
+
wget r -nH -q ...
+
 
+
to
+
 
+
wget -r -nH <span style="color:red">-c -N</span> -q ...
+
 
+
This will tell <tt>wget</tt> to only download new or modified files, instead of trying to download the entire data archive from scratch.  This should hopefully subsequent data download processes faster.
+
 
+
--[[User:Bmy|Bob Y.]] ([[User talk:Bmy|talk]]) 18:35, 16 June 2015 (UTC)
+
 
+
== 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 our [[Preparing data files for use with HEMCO|''Preparing data files for use with HEMCO'' wiki page]] for more information.
+
  
--[[User:Bmy|Bob Y.]] 11:49, 5 March 2015 (EST)
+
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.