HEMCO data directories: Difference between revisions

From Geos-chem
Jump to navigation Jump to search
 
(64 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.
== Data directories by GEOS-Chem version ==


: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>.  
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 '''Default or optional setting?''' column contains this description
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
|-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 grouped and listed 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
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
|-bgcolor="#CCCCCC"
!width="325x"|Inventory
!width="150px"|Version
!width="90px"|More info
!width="200px"|Chemistry Inputs
!width="275px"|Path
!width="200px"|Emissions Inputs
!width="75px"|Data size
!width="200px"|Initial Conditions
!width="325px"|Default or '''OPTIONAL SETTING'''?
 
|-valign="top"
|[[CAC_anthropogenic_emissions#Historical_Canadian_emissions|'''APEI''']]
*Canadian emissions
*Data Years: 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 SETTING'''
*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''']]
*Hourly CONUS emissions from NEI2011 inventory
*Data Years: 2006-2013
|[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'''
*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"
|-valign="top" align="center"
|[[EPA/NEI11_North_American_emissions|'''NEI2011_MONTHLY_MEAN''']]
|[[GEOS-Chem 14.1.1]]
*Monthly mean CONUS emissions from NEI2011 inventory
|[https://github.com/geoschem/input-data-catalogs/blob/2f9992f7c5d9285a18c8ff326a7eff6e04758ee4/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
*Data Years: 1989-2014
|[https://github.com/geoschem/input-data-catalogs/blob/2f9992f7c5d9285a18c8ff326a7eff6e04758ee4/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/NEI2011/v2017-02-MM/README README]
|[https://github.com/geoschem/input-data-catalogs/blob/2f9992f7c5d9285a18c8ff326a7eff6e04758ee4/InitialConditions.csv <tt>InitialConditions.csv</tt>]
|<tt>$ROOT/NEI2011/v2017-02-MM</tt>
|248 GB
|bgcolor="#FFFF00"|'''OPTIONAL SETTING'''
*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"
|-valign="top" align="center"
|[[MIX Asian anthropogenic emissions|'''MIX''']]
|[[GEOS-Chem 14.1.0]]
*Asian anthropogenic emissions
|[https://github.com/geoschem/input-data-catalogs/blob/fe46b1e55a07a26e5f7eefe9e79776bb83e20eed/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
*Data Years: 2008-2010
|[https://github.com/geoschem/input-data-catalogs/blob/fe46b1e55a07a26e5f7eefe9e79776bb83e20eed/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MIX/v2015-03/README README]
|[https://github.com/geoschem/input-data-catalogs/blob/fe46b1e55a07a26e5f7eefe9e79776bb83e20eed/InitialConditions.csv <tt>InitialConditions.csv</tt>]
|<tt>$ROOT/MIX/v2015-03</tt>
|623 MB
|bgcolor="#FFFF00"|'''OPTIONAL SETTING'''
*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"
|-valign="top" align="center"
|[[DICE-Africa_anthropogenic_emissions_inventory|'''DICE_Africa''']]
|[[GEOS-Chem 14.0.0]]
*African emissions inventory
|[https://github.com/geoschem/input-data-catalogs/blob/e61ca36cdbd1c1bfeb58ff20a5633c97dcc48164/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
*Data Years: 2013
|[https://github.com/geoschem/input-data-catalogs/blob/e61ca36cdbd1c1bfeb58ff20a5633c97dcc48164/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
||[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/DICE_Africa/v2016-10/README README]
|[https://github.com/geoschem/input-data-catalogs/blob/e61ca36cdbd1c1bfeb58ff20a5633c97dcc48164/InitialConditions.csv <tt>InitialConditions.csv</tt>]
|<tt>$ROOT/DICE_Africa/v2016-10</tt>  
|202 MB
|bgcolor="#FFFF00"|'''OPTIONAL SETTING'''
*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" align="center"
|[[GEOS-Chem 13.4.0]]
|[https://github.com/geoschem/input-data-catalogs/blob/447e33da692d76aa044a590a0422ab3dd193f1b4/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
|[https://github.com/geoschem/input-data-catalogs/blob/447e33da692d76aa044a590a0422ab3dd193f1b4/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
|[https://github.com/geoschem/input-data-catalogs/blob/447e33da692d76aa044a590a0422ab3dd193f1b4/InitialConditions.csv <tt>InitialConditions.csv</tt>]


=== Global inventories ===
|-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>]


The following subdirectories of the HEMCO directory tree contain inventories of anthropogenic and biofuel emissions.
|-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>]


Please also see list of species included in each of these [[Anthropogenic_emissions#Global_inventories|global inventories]] and [[Anthropogenic_emissions#Regional_inventories|regional inventories]].
|-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>]


{| border=1 cellspacing=0 cellpadding=5
|-valign="top" align="center"
|- bgcolor="#cccccc"
|[[GEOS-Chem 13.0.0]]
!width="325px"|Inventory
|[https://github.com/geoschem/input-data-catalogs/blob/7a53a0c19b5972611486a91a4c45433da97ba7c9/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
!width="90px"|More info
|[https://github.com/geoschem/input-data-catalogs/blob/7a53a0c19b5972611486a91a4c45433da97ba7c9/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
!width="275px"|Path
|[https://github.com/geoschem/input-data-catalogs/blob/7a53a0c19b5972611486a91a4c45433da97ba7c9/InitialConditions.csv <tt>InitialConditions.csv</tt>]
!width="75px"|Data size
!width="325px"|Default or '''OPTIONAL SETTING'''?
 
|-valign="top"
|[[CEDS anthropogenic emissions|'''CEDS''']]
*Community Emissions Data System
*Data Years: 1970-2017
||[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_byFuelType''']]
*Sectorial CEDS emissions
*Data Years: 1970-2017
||[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'''
*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|'''EDGARv43''']]
*EDGAR global emissions v4.3
*Data Years: 1970-2010
|[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 SETTING'''
*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''']
*HTAP global anthro+biofuel emissions
*Data Years: 2008-2010
**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.
|[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'''
 
|-valign="top"
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/NH3/v2014-07/README '''GEIA_NH3''']
*GEIA natural source NH3 emissions
*Data Years: 1990
|[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 '''SEABIRD_NH3''']
*Croft et al NH3 emissions from arctic sea birds
*Data Years: 1990
|[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
*Data Years: 1985
|[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'''
 
|-valign="top"
|[https://onlinelibrary.wiley.com/doi/full/10.1002/2016JD025767 '''TZOMPASOSA_C2H6''']
*Tzompa-Soza et al [2017] C2H6 emissions (overwrites CEDS to address underestimates)
*Data Years: 2010
||[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'''
 
|-valign="top"
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/XIAO/v2014-09/README '''XIAO_C3H8''']
*Y. Xiao et al [2008] C3H8 emissions (overwrites CEDS to address underestimates)
*Data Years: 1985
|[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'''
 
|-valign="top"
|[[Bromine_chemistry_mechanism#Source code and data files|'''LIANG_BROMOCARB''']]
*Liang et al VSL emissions
*Data Years: 2000
|[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_IONOCARB''']]
*Ordonez et al Iodine emissions
*Data Years: 1985
|[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''']]
*MIT aircraft emissions inventory
*Data Years: 2005
|[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 '''DECAYING_PLANTS''']
*ALD2 and EOH emissions from decaying plants
*Data Years: 1985
|[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|'''AFCID''']]
*Anthropogenic PM2.5 dust source
*Data Years: 2015
|[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'''
 
|}
 
=== 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="325px"|Inventory
!width="90px"|More info
!width="275px"|Path
!width="75px"|Data size
!width="325px"|Default or '''OPTIONAL SETTING'''?
 
|-valign="top"
|[[CEDS anthropogenic emissions|'''CEDS_SHIP''']]
*CEDS ship emissions (summed over all sectors)
*Data Years: 1970-2017
||[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'''
 
|-valign="top"
|[[CEDS anthropogenic emissions|'''CEDS_SHIP_byFuelType''']]
*Sectorial CEDS ship emissions
*Data Years: 1970-2017
**NOTE: Incurs additional data I/O overhead
||[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'''
 
|-valign="top"
|[http://edgar.jrc.ec.europa.eu/htap_v2/index.php?SECURE=123 '''HTAP_SHIP''']
*CO, NO, SO2 ship emissions from the HTAP inventory
*Data Years: 2008-2010
*[http://edgar.jrc.ec.europa.eu/htap/EDGAR-HTAP_v1_final_jan2012.pdf See this document] for more information.
|[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'''
 
|-valign="top"
|[[Ship_emissions#ICOADS|'''ICOADS_SHIP''']]
*CO ship emissions from the ICOADS inventory
*Data Years: 2002
|[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 until [[GEOS-Chem 12#12.1.0|GEOS-Chem 12.1.0]].
 
|-valign="top"
|[[Ship_emissions#ARCTAS|'''ARCTAS_SHIP''']]
*SO2 ship emissions from the ARCTAS inventory
*Data Years: 2008
|[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'''
 
|-valign="top"
|[[Ship_emissions#Corbett|'''CORBETT_SHIP''']]
*SO2 ship emissions from Corbett et al inventory
*Data Years: 1985
|[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'''
 
|-valign="top"
|[[EPA/NEI11_North_American_emissions|'''NEI2011_SHIP''']]
*Hourly coastal ship emissions from the NEI_2011 inventory
*Data Years: 2006-2013
|[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'''
 
|-valign="top"
|[[EPA/NEI11_North_American_emissions|'''NEI2011_SHIP_MONMEAN''']]
*Monthly mean coastal ship emissions from the NEI2011 inventory
*Data Years: 2006-2013
|[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'''
 
|}
 
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.
#The NEI2011 ship emissions data only extends a few km from landThey are therefore coastal emissions inventories and not global emissions inventories.
 
=== Future emissions ===
 
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
!width="325px"|Inventory
!width="90px"|More info
!width="275px"|Path
!width="75px"|Data size
!width="325px"|Default or '''OPTIONAL SETTING'''?
 
|-valign="top"
|[[RCP_future_emissions_scenarios#RCP_scenarios_in_GEOS-Chem_v10-01_and_higher_versions|'''RCP_3PD''']]
*Emissions for scenario RCP_3PD
*Data Years: 2005-2100
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/RCP/v2020-07/README README]
|<tt>$ROOT/RCP/v2020-07/RCP_3PD</tt>
|91 MB
|bgcolor="#FFFF00"|'''OPTIONAL SETTING'''
 
|-valign="top"
|[[RCP_future_emissions_scenarios#RCP_scenarios_in_GEOS-Chem_v10-01_and_higher_versions|'''RCP_45''']]
*Emissions for scenario RCP_45
*Data Years: 2005-2100
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/RCP/v2020-07/README README]
|<tt>$ROOT/RCP/v2020-07/RCP_45</tt>
|93 MB
|bgcolor="#FFFF00"|'''OPTIONAL SETTING'''
 
|-valign="top"
|[[RCP_future_emissions_scenarios#RCP_scenarios_in_GEOS-Chem_v10-01_and_higher_versions|'''RCP_60''']]
*Emissions for scenario RCP_60
*Data Years: 2005-2100
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/RCP/v2020-07/README README]
|<tt>$ROOT/RCP/v2020-07/RCP_60</tt>
|92 MB
|bgcolor="#FFFF00"|'''OPTIONAL SETTING'''
 
|-valign="top"
|[[RCP_future_emissions_scenarios#RCP_scenarios_in_GEOS-Chem_v10-01_and_higher_versions|'''RCP_85''']]
*Emissions for scenario RCP_85
*Data Years: 2005-2100
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/RCP/v2020-07/README README]
|<tt>$ROOT/RCP/v2020-07/RCP_85</tt>
|93 MB
|bgcolor="#FFFF00"|'''OPTIONAL SETTING'''


|}
|}


=== Biomass burning emissions (not implemented as extensions) ===
== Emissions reference ==
 
''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="325px"|Inventory
!width="90px"|More info
!width="275px"|Path
!width="75px"|Data size
!width="325px"|Default or '''OPTIONAL SETTING'''?
 
|-valign="top"
|[[GFAS_biomass_burning_emissions|'''GFAS''']]
*CAMS Global Fire Assimilation System estimated emissions
*Injection height info is taken from
** ECMWF fire observations
** ECMWF operational weather forecasts.
*Data Years: 2003-2020
|[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''']]
*Quick Fire Emissions Database (v2.5r1)
*Data Years: 2003-2020
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/QFED/v2018-07/README README]
|<tt>$ROOT/QFED/v2018-07</tt>
|247 GB
|bgcolor="#FFFF00"|'''OPTIONAL SETTING'''
*QFED v2.5r1 data extends from 2000-2020
 
|}
 
=== 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="325px"|Inventory
!width="90px"|More info
!width="275px"|Path
!width="75px"|Data size
!width="325px"|Default or '''OPTIONAL SETTING'''?
 
|-valign="top"
|[[Mineral_dust_aerosols#Offline_Dust_Emissions|'''OFFLINE_DUST''']]
*Dust emissions archived from HEMCO standalone simulations
*Data Years: 1980-2020
|[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_BIOGENICVOC''']]
*Biogenic VOC emissions generated from HEMCO standalone simulations
*Data Years: 1980-2020
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OFFLINE_BIOVOC/v2019-01/README README]
|<tt>$ROOT/OFFLINE_BIOVOC/v2019-01</tt>
|1400 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_SEASALT''']]
*Sea salt emissions generated from HEMCO standalone simulations
*Data Years: 1980-2020
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OFFLINE_SEASALT/v2019-01/README README]
|<tt>$ROOT/OFFLINE_SEASALT/v2019-01</tt>
|876 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_SOILNOX''']]
*Soil NOx emissions generated from HEMCO standalone simulations
*Data Years: 1980-2020
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OFFLINE_SOILNOX/v2019-01/README README]
|<tt>$ROOT/OFFLINE_SOILNOX/v2019-01</tt>
|48 GB
|bgcolor="#00FF00"|'''DEFAULT SETTING'''
*Introduced in [[GEOS-Chem 12#12.5.0|12.5.0]]
*You must also turn off the SoilNOx extension
|}
 
=== 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="325px"|Inventory
!width="90px"|More info
!width="275px"|Path
!width="75px"|Data size
!width="325px"|Default or '''OPTIONAL SETTING'''?
 
|-valign="top"
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/UVALBEDO/v2016-06/README '''UVALBEDO''']
*Hermann & Celarier [1997] UV surface albedo data
*Data years: 1997 (1985 timestamps)
*Needed for FAST-JX photolysis
|[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'''
 
|-valign="top"
|[[Bromine_chemistry_mechanism#Source code and data files|'''CCM_STRAT_Bry''']]
*Stratospheric Bry from the CCM model
*Data years: 2007
|[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'''
 
|-valign="top"
|[[Stratospheric chemistry|'''GMI_STRAT_OH''']]<br>
*OH concentration (v/v) from the GMI model
*Data years: 2005
|rowspan="2"|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/GMI/v2015-02/README README]
|rowspan="2"|<tt>$ROOT/GMI/v2015-02</tt>
|rowspan="2"|16 GB
|bgcolor="#00FF00"|'''DEFAULT SETTING'''
 
|-valign="top"
|[[Stratospheric chemistry|'''GMI_PROD_LOSS''']]<br>
*P & L rates from the GMI model
*Data years: 2005
|bgcolor="#00FF00"|'''DEFAULT SETTING'''
 
|-valign="top"
|[[UCX chemistry mechanism|'''UCX_PROD_LOSS''']]
*P & L rates from GEOS-Chem simulations with UCX
*Data years: 2013
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/UCX/v2018-02/README README]
|<tt>$ROOT/UCX/v2018-02</tt>
|12 GB
|bgcolor="#FFFF00"|'''OPTIONAL SETTING'''
*Can be used instead of GMI_PROD_LOSS
 
|-valign="top"
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OMOC/v2018-01/README '''OMOC_RATIO''']
*Spatially varying OM/OC ratios for SOA species
*Data years: 2010
|[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)
 
|-valign="top"
|[[NOx-Ox-HC-aerosol#Monthly_mean_surface_distributions|'''GMD_SFC_CH4''']]
*NOAA GMD monthly mean surface methane distributions
*Data years: 1979-2020
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/NOAA_GMD/v2018-01/README]
|<tt>$ROOT/NOAA_GMD/v2018-01</tt>
|85 MB
|bgcolor="#00FF00"|'''DEFAULT SETTING'''
 
|-valign="top"
|[[NOx-Ox-HC-aerosol#Monthly_mean_surface_distributions|'''CMIP6_SFC_CH4''']]
*CMIP6 monthly mean surface methane distributions
*Data years: 1750-1978
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CMIP6/v2019-12/README]
|<tt>$ROOT/CMIP6/v2019-12</tt>
|85 MB
|bgcolor="#FFFF00"|'''OPTIONAL SETTING'''
 
|-valign="top"
|[[Olson land map|'''OLSON_LANDMAP''']]
*Masks for each Olson land type
*Data years: 1985
|[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"|'''DEFAULT 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_MODIS_LAI''']]
*Yuan-processed MODIS XLAI<br>(leaf area index per land type)
*Data years: 2005-2016
|[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"|'''DEFAULT SETTING'''
 
|-valign="top"
|[[Coupling GEOS-Chem with RRTMG|'''RRTMG''']]
*RRTMG radiative transfer model input data (e.g. surface reflectances etc.)
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/RRTMG/v2018-11/README README]
|<tt>$ROOT/RRTMG/v2018-11</tt>
|19 MB
|bgcolor="#FFFF00"|'''OPTIONAL SETTING'''
*Only needed for fullchem simulations with the RRTMG option
 
|-valign="top"
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/SfcFix/v2019-12/README '''SfcVMR''']
*Latitudinally and monthly resolved fixed surface concentrations for long-lived organohalogen species from GMI and UCX (1959-2099)
*Data years: 1750-2014
|
[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/SfcFix/v2019-12/README README]
|<tt>HEMCO/SfcFix/v2019-12</tt>
|851 MB
|bgcolor="#00FF00"|'''DEFAULT SETTING'''
 
|-valign-"top"
|[https://www.atmos-chem-phys-discuss.net/acp-2019-1043/ '''OCEAN_O3_DRYDEP''']
*Ozone deposition to the ocean
*Data years: 1985
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OCEAN_O3_DRYDEP/v2020-02/README README]
|<tt>HEMCO/OCEAN_O3_DRYDEP/v2020-02</tt>
|388 MB
|bgcolor="#00FF00"|'''DEFAULT SETTING'''
 
|-valign-"top"
|Timezone offsets from UTC
*Used by HEMCO to compute emissions that depend on local time rather than on UTC time.
*NOTE: Always read, there is no on/off switch
|[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'''
 
|}
 
=== 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.).
 
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
!width="325px"|HEMCO Extension
!width="90px"|More info
!width="275px"|Path
!width="75px"|Data size
!width="325px"|Default or '''OPTIONAL SETTING'''?
 
|-valign="top"
|'''SeaFlux'''
*Ocean exchange
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/ACET/v2014-07/README README1]<br>[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/ALD2/v2017-03/README README2]<br>[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/DMS/v2015-07/README README3]
|<tt>$ROOT/ACET/v2014-07</tt><br><tt>$ROOT/ALD2/v2017-03</tt><br><tt>$ROOT/DMS/v2015-07</tt>
|5.8 MB
|bgcolor="#00FF00"|'''DEFAULT SETTING'''
 
|-valign="top"
|[[Ship_emissions#PARANOX_ship_plume_model|'''ParaNOx''']]
*PARANOX ship plume model, computes the aging of emissions in ship exhaust plumes.
|[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'''
 
|-valign="top"
|[[Lightning_NOx_emissions|'''LightNOx''']]
*Computes NO from lightning
*May be used instead of OFFLINE_LIGHTNING
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/LIGHTNOX/v2017-09/README README]
|<tt>$ROOT/LIGHTNOX/v2017-09</tt>
|32 MB
|bgcolor="#00FF00"|'''DEFAULT SETTING'''
 
|-valign="top"
|[[Lightning_NOx_emissions|'''LightNOx''']]
*Computes NO from lightning
*May be used instead of OFFLINE_LIGHTNING
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/LIGHTNOX/v2017-09/README README]
|<tt>$ROOT/LIGHTNOX/v2017-09</tt>
|32 MB
|bgcolor="#00FF00"|'''DEFAULT SETTING'''
 
|-valign="top"
|[[Hudman_et_al_2012_soil_NOx_emissions_algorithm|'''SoilNOx''']]
*Hudman et al [2012] soil NOx emissions algorithm
*May be used instead of OFFLINE_SOILNOX
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/SOILNOX/v2014-07/README README]
|<tt>$ROOT/SOILNOX/v2014-07</tt>
|730 MB
|bgcolor="#FFFF00"|'''OPTIONAL SETTING'''
*Was default until [[GEOS-Chem 12#12.5.0|GEOS-Chem 12.5.0]]
 
|-valign="top"
|[[Mineral dust aerosols|'''DustDead''']]
*DEAD dust model (cf. Zender)
|[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 SETTING'''
*May be used instead of OFFLINE_DUST
 
|-valign="top"
|[[Mineral dust aerosols|'''DustGinoux''']]
*Ginoux et al 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 SETTING'''
*This is a research option.
 
|-valign="top"
|[[Mineral dust aerosols|'''SeaSalt''']]
*Sea salt emissions
|colspan="3"|Does not have an associated data directory
|bgcolor="#FFFF00"|'''OPTIONAL SETTING'''
*May be used instead of OFFLINE_SEASALT
 
|-valign="top"
|[[MEGAN_v2.1_plus_Guenther_2012_biogenic_emissions|'''MEGAN''']]
*MEGAN v2.1 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="#00FF00"|'''DEFAULT SETTING'''
*NOTE: Is used alongside OFFLINE_BIOVOC to compute emissions for certan species that are not included in the OFFLINE_BIOVOC inventory
 
|-valign="top"
|[[GFED4_biomass_burning_emissions|'''GFED4''']]
*GFED4 biomass burning v4.1, data directory contains dry matter and other inputs
*Data Years: 1988-2019 (monthly-mean)
*Daily & hourly emissions are possible with the use of scale factors.
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/GFED4/v2020-02/README README]
|<tt>$ROOT/GFED4/v2020-02</tt>
|296 MB
|bgcolor="#00FF00"|'''DEFAULT SETTING'''
 
|-valign="top"
|[[FINNv1_biomass_burning_emissions#FINN_v1.5_data|'''FINN''']]
*FINN biomass burning (v1.5)
*Data Years: 2002-2016
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/FINN/v2015-02/README README]
|<tt>$ROOT/FINN/v2015-02</tt>
|1.2 GB
|bgcolor="#FFFF00"|'''OPTIONAL SETTING'''
*This is a research option
 
|-valign="top"
|'''DustAlk'''
*Computes dust alkalinity (for aciduptake simulation only)
|colspan="3"|Does not have an associated data directory.
|bgcolor="#FFFF00"|'''OPTIONAL SETTING'''
*This is a research option
 
|-valign="top"
|[[Volcanic_SO2_emissions|'''Volcano''']
*Volcanic SO2 emissions from Aerocom
*Data Years: 1978-2020
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/VOLCANO/v2019-08/README README]
|<tt>$ROOT/VOLCANO/v2019-08</tt>
|63 MB
|bgcolor="#00FF00"|'''DEFAULT SETTING'''
 
|-valign="top"
|'''Inorg_Iodine'''
*Inorganic iodine emissions (HOI, I2)
|colspan="3"|Does not have an associated data directory.
|bgcolor="#00FF00"|'''DEFAULT SETTING'''
 
|}
 
=== HEMCO scale factors, masks, and other data ===
 
The following subdirectories of the HEMCO directory tree contain scale factors for various emissions inventories
 
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
!width="325px"|Directory
!width="110px"|More info
!width="300px"|Path
!width="110px"|Data size
!width="325px"|Used when?
 
|-valign="top"
!colspan="5" bgcolor="#CCFFFF"|Active inventories (turned ON by default in the standard emissions configuration)
 
|-valign="top"
|[[Scale_factors_for_anthropogenic_emissions|'''AnnualScalar''']]
*Directory containing 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
|Only needed for the following inventories:
*HTAP
*MIX,
*XIAO_C3H8
 
|-valign="top"
|[[EPA/NEI05_North_American_emissions|'''NEI2005''']]
*Directory containing 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
|Only needed for the following inventories:
*NEI2011_HOURLY
*NEI2011_MONMEAN
 
|-valign="top"
|'''MASKS'''
*Directory containing mask files for regional emission inventories
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MASKS/v2014-07/README README]
|<tt>$ROOT/MASKS/v2014-07</tt>
|148 MB
|Needed for regional emissions inventories
 
|-valign="top"
|'''COUNTRY_ID'''
*Directory containing [http://www.nationsonline.org/oneworld/country_code_list.htm ISO ALPHA-3 standard] country codes 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.
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/COUNTRY_ID/v2015-04/README README]
|<tt>$ROOT/COUNTRY_ID/v2015-04</tt>
|15 MB
|Not currently used, but is available for research needs
 
|}
 
=== 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 (i.e. those that do not use the fullchem mechanism)]].  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="325px"|Directory
!width="90px"|More info
!width="275px"|Path
!width="75px"|Data size
!width="325px"|Used by which simulations?
 
|-valign="top"
|'''CH4'''
*Various data
|[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]
|<tt>$ROOT/CH4/v2017-10</tt><br><tt>$ROOT/CH4/v2014-09</tt>
|6.6 GB
|
*[[CH4 simulation|CH4 and tagCH4 specialty simulations]]
 
|-valign="top"
|'''CO2'''
*Various data sources
|[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>
|1.5 GB
|
*[[CO2 simulation]]
 
|-valign="top"
|'''CHLA'''
*Oceanic Chlorophyll-A
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CHLA/v2014-07/README README]
|<tt>$ROOT/CHLA/v2014-07</tt>
|2.0 MB
|
*[[Mercury|Mercury simulation]]
 
|-valign="top"
|'''MERCURY'''
*Various emission inventories & data
|[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>
|3.0 GB
|
*[[Mercury|Mercury simulation]]
 
|-valign="top"
|'''O3'''
*Archived O3 fields
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/O3/v2014-09/README README]
|<tt>$ROOT/O3/v2014-09</tt>
|130 MB
|
*[[Mercury|Hg and tagHg simulations]]
*[[POPs simulation|POPs simulation]]
 
|-valign="top"
|'''OFFLINE_AEROSOL'''
*Archived concentrations and P/L rates
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OFFLINE_AEROSOL/v2014-09/README README]
|<tt>$ROOT/OFFLINE_AEROSOL/v2014-09</tt>
|165 MB
|
*[[Aerosol-only simulation]]
 
|-valign="top"
|'''OH'''
*Archived OH fields
|[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>
|95 MB
|
*[[Aerosol-only simulation]]
*[[CH4 simulation|CH4 and tagCH4 simulations]]
*[[Mercury|Hg and tagHg simulations]]
*[[POPs simulation|POPs simulation]]
*[[Tagged CO simulation]]
 
|-valign="top"
|'''OXIDANTS'''
*Archived P(H2O2)
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OXIDANTS/v2014-07/README README]
|<tt>$ROOT/OXIDANTS/v2014-07</tt>
|32 MB
|
*[[Aerosol-only simulation]]
 
|-valign="top"
|'''POPs'''
*Various data
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/POPs/v2015-08/README README]
|<tt>$$ROOT/POPs/v2015-08</tt>
|809 MB
|[[POPs simulation]]
 
|-valign="top"
|'''TAGGED_CO'''
*Archived P(CO)
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/TAGGED_CO/v2017-04/README README]
|<tt>$ROOT/TAGGED_CO/v2017-04</tt>
|79 MB
|
*[[Tagged CO simulation]]
 
|-valign="top"
|'''TAGGED O3'''
*Archived P(O3) and L(O3)
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/TAGGED_O3/v2014-09/README README]
|<tt>$ROOT/TAGGED_O3/v2014-09</tt>
|374 MB
|
*[[Tagged O3 simulation]]
 
|}
 
== 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.