Difference between revisions of "HEMCO data directories"

From Geos-chem
Jump to: navigation, search
(GEOS-Chem specialty simulation data)
(Data directories by GEOS-Chem version)
 
(667 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.  Each data set is contained in a subdirectory of the HEMCO root directory, which is specified by the <tt>$ROOT</tt> token.  (For example, on the Harvard disk server, <tt>$ROOT</tt> points to the directory <tt>/mnt/gcgrid/data/ExtData/HEMCO/</tt>.)
+
 
+
--[[User:Bmy|Bob Y.]] 10:49, 13 February 2015 (EST)
+
 
+
=== Aerosols ===
+
 
+
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="300px"|Inventory
+
!width="150px"|Version
!width="110px"|Data file info
+
!width="200px"|Chemistry Inputs
!width="275px"|Path
+
!width="200px"|Emissions Inputs
!width="300px"|Status
+
!width="200px"|Initial Conditions
|-
+
|[[Volcanic_SO2_emissions_from_Aerocom|AEROCOM volcanic emissions]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/VOLCANO/v2014-10/README README]
+
|<tt>$ROOT/VOLCANO/v2014-10</tt>
+
|CURRENTLY USED
+
|-
+
|[[Carbonaceous_aerosols#EC_and_OC_emissions|Tami Bond et al (2007) EC and OC emissions]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/BCOC_BOND/v2014-07/README README]
+
|<tt>$ROOT/BCOC_BOND/v2014-07</tt>
+
|CURRENTLY USED
+
|-valign="top"
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/BCOC_COOKE/v2014-07/README Cooke et al BC and OC emissions]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/BCOC_COOKE/v2014-07/README README]
+
|<tt>$ROOT/BCOC_COOKE/v2014-07</tt>
+
|OPTIONAL
+
*Can be used to replace Bond et al (2007).
+
|-
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/SOA/v2014-07/README Secondary organic aerosols]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/SOA/v2014-07/README README]
+
|<tt>$ROOT/HEMCO/SOA/2014-07</tt>
+
|CURRENTLY USED
+
|}
+
  
--[[User:Bmy|Bob Y.]] 15:35, 12 February 2015 (EST)
+
|-valign="top" align="center"
 +
|[[GEOS-Chem 14.1.1]]
 +
|[https://github.com/geoschem/input-data-catalogs/blob/2f9992f7c5d9285a18c8ff326a7eff6e04758ee4/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
 +
|[https://github.com/geoschem/input-data-catalogs/blob/2f9992f7c5d9285a18c8ff326a7eff6e04758ee4/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
 +
|[https://github.com/geoschem/input-data-catalogs/blob/2f9992f7c5d9285a18c8ff326a7eff6e04758ee4/InitialConditions.csv <tt>InitialConditions.csv</tt>]
  
=== Anthropogenic and biofuel emissions ===
+
|-valign="top" align="center"
 +
|[[GEOS-Chem 14.1.0]]
 +
|[https://github.com/geoschem/input-data-catalogs/blob/fe46b1e55a07a26e5f7eefe9e79776bb83e20eed/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
 +
|[https://github.com/geoschem/input-data-catalogs/blob/fe46b1e55a07a26e5f7eefe9e79776bb83e20eed/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
 +
|[https://github.com/geoschem/input-data-catalogs/blob/fe46b1e55a07a26e5f7eefe9e79776bb83e20eed/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 14.0.0]]
 +
|[https://github.com/geoschem/input-data-catalogs/blob/e61ca36cdbd1c1bfeb58ff20a5633c97dcc48164/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
 +
|[https://github.com/geoschem/input-data-catalogs/blob/e61ca36cdbd1c1bfeb58ff20a5633c97dcc48164/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
 +
|[https://github.com/geoschem/input-data-catalogs/blob/e61ca36cdbd1c1bfeb58ff20a5633c97dcc48164/InitialConditions.csv <tt>InitialConditions.csv</tt>]
  
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" align="center"
|- bgcolor="#cccccc"
+
|[[GEOS-Chem 13.4.0]]
!width="300px"|Inventory
+
|[https://github.com/geoschem/input-data-catalogs/blob/447e33da692d76aa044a590a0422ab3dd193f1b4/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
!width="110px"|Data file info
+
|[https://github.com/geoschem/input-data-catalogs/blob/447e33da692d76aa044a590a0422ab3dd193f1b4/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
!width="275px"|Path
+
|[https://github.com/geoschem/input-data-catalogs/blob/447e33da692d76aa044a590a0422ab3dd193f1b4/InitialConditions.csv <tt>InitialConditions.csv</tt>]
!width="300px"|Status
+
|-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>
+
|OBSOLETE
+
*Slated for replacement by newer inventories
+
|-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>
+
|CURRENTLY USED
+
*Slated for replacement after [[GEOS-Chem v10-01]] ships.
+
|-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>
+
|CURRENTLY USED
+
*Soon to be replaced by [[EDGAR v4.2 anthropogenic emissions|EDGAR v4.2]]
+
|-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</tt>
+
|PENDING BENCHMARK APPROVAL
+
*Will replace [[EDGAR v3 anthropogenic emissions|EDGAR v3]]
+
|-
+
|[http://edgar.jrc.ec.europa.eu/htap_v2/index.php?SECURE=123 HTAP global anthro+biofuel]
+
|TBD
+
|TBD
+
|TO BE ADDED SOON
+
|-
+
|[[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>
+
|CURRENTLY USED
+
|-
+
|[[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>
+
|CURRENTLY USED
+
|-
+
|[[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>
+
|CURRENTLY USED
+
|-
+
|[[Anthropogenic_emissions#CAC|CAC regional anthropogenic]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CAC/v2014-07/README README]
+
|<tt>$ROOT/CAC/v2014-07</tt>
+
|CURRENTLY USED
+
|-
+
|[[EMEP_European_anthropogenic_emissions|EMEP regional anthropogenic]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/EMEP/v2015-01/README README]
+
|<tt>$ROOT/EMEP/v2015-01</tt>
+
|CURRENTLY USED
+
|-
+
|[[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>
+
|CURRENTLY USED
+
|-
+
|[[EPA/NEI11_North_American_emissions|NEI2011 regional anthro/biofuel]]
+
|TBD
+
|TBD
+
|TO BE ADDED SOON
+
|-
+
|[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/README README]
+
|<tt>$ROOT/VISTAS/v2014-07</tt>
+
|CURRENTLY USED
+
|-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]<br>
+
|<tt>$ROOT/STREETS/v2014-07</tt>
+
|CURRENTLY USED
+
|-valign="top"
+
|[http://mix.greenresource.cn/ MIX regional anthro]
+
|[ftp://166.111.42.46/MIX_2014_v1.1/readme README]
+
|TBD
+
|TO BE ADDED SOON
+
*Slated as a replacement for Streets et al emissions.
+
|-
+
|[[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>
+
|CURRENTLY USED
+
|-
+
|[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>
+
|CURRENTLY USED
+
|}
+
  
--[[User:Bmy|Bob Y.]] 16:23, 13 February 2015 (EST)
+
|-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>]
  
=== Anthropogenic aircraft and ship 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>]
  
The following subdirectories of the HEMCO directory tree contain inventories of anthropogenic aircraft and ship 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>]
  
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" align="center"
|- bgcolor="#cccccc"
+
|[[GEOS-Chem 13.0.0]]
!width="300px"|Inventory
+
|[https://github.com/geoschem/input-data-catalogs/blob/7a53a0c19b5972611486a91a4c45433da97ba7c9/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
!width="110px"|Data file 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="300px"|Status
+
|-valign="top"
+
|[[Aircraft_emissions#MIT_aviation_emissions_inventory|AEIC aircraft]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/AEIC/v2014-10/README README]
+
|<tt>$ROOT/AEIC/v2014-10</tt>
+
|CURRENTLY USED
+
|-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>
+
|CURRENTLY USED
+
*Default inventory for ship SO2
+
*Overwritten by EMEP over Europe
+
|-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/VOLCANO/v2014-10</tt>
+
|OPTIONAL
+
*Can be used to overwrite ARCTAS SO2
+
|-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>
+
|CURRENTLY USED
+
*Default inventory for ship CO
+
*Overwritten by EMEP over Europe
+
|-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>
+
|OPTIONAL
+
*Can be used instead of ICOADS
+
*Stored together w/ other EDGAR data files
+
*Soon to be replaced by [[EDGAR v4.2 anthropogenic emissions|EDGAR v4.2]]
+
|-valign="top"
+
|[[EMEP_European_anthropogenic_emissions|EMEP ship (CO, SO2)]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/EMEP/v2015-01/README README]
+
|<tt>$ROOT/EMEP/v2015-01</tt>
+
|CURRENTLY USED
+
*Overwrites CO, SO2 over Europe
+
*Stored together w/ other EMEP data files
+
|}
+
  
--[[User:Bmy|Bob Y.]] 11:03, 13 February 2015 (EST)
 
 
=== 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="300px"|Inventory
 
!width="110px"|Data file info
 
!width="275px"|Path
 
!width="300px"|Status
 
|-valign="top"
 
|[[GFED3 biomass burning emissions|GFED3 biomass]]
 
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/GFED3/v2014-10/README README]
 
|<tt>$ROOT/GFED3/v2014-10</tt>
 
|CURRENTLY USED
 
*Default biomass burning inventory.
 
*Soon to be replaced by GFED4.
 
|-valign="top"
 
|[[FINN biomass_burning_emissions|FINN biomass]]
 
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/FINN/v2015-02/README README]
 
|<tt>$ROOT/FINN/v2015-02</tt>
 
|OPTIONAL
 
*You may choose to replace GFED3 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"
 
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/QFED/v2014-09/README QFED biomass]
 
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/QFED/v2014-09/README README]
 
|<tt>$ROOT/QFED/v2014-09</tt>
 
|OPTIONAL
 
*You may choose to replace GFED3 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]]
 
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/GFED2/v2014-07/README README]
 
|<tt>$ROOT/GFED2/v2014-07</tt>
 
|OBSOLETE
 
*Superseded by GFED3.
 
|-valign="top"
 
|[[Biomass_burning_emissions#Duncan_et_al_.22Interannual.22_Biomass_Emissions|Duncan et al biomass]]
 
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/BIOBURN/v2014-07/README README]
 
|<tt>$ROOT/BIOBURN/v2014-07</tt>
 
|OBSOLETE
 
*Superseded by GFED3.
 
 
|}
 
|}
  
--[[User:Bmy|Bob Y.]] 15:48, 13 February 2015 (EST)
+
== Emissions reference ==
 
+
=== 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]] 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="300px"|Inventory
+
!width="110px"|Data file info!
+
!width="275px"|Path
+
!width="300px"|Status
+
|-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>
+
|CURRENTLY USED
+
*Default dust mobilization scheme
+
|-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>
+
|OPTIONAL
+
*You can use this in place of the DEAD model.
+
|-
+
|[[MEGAN_biogenic_emissions#MEGAN_in_GEOS-Chem_v8-02-04_and_later_versions|MEGAN biogenic emissions]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MEGAN/v2014-07/README README]
+
|<tt>$ROOT/MEGAN/v2014-07</tt>
+
|CURRENTLY USED
+
|-
+
|[[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>
+
|CURRENTLY USED
+
|-
+
|[[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>
+
|CURRENTLY USED
+
|-
+
|[[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>
+
|CURRENTLY USED
+
|}
+
 
+
--[[User:Bmy|Bob Y.]] 13:09, 18 February 2015 (EST)
+
 
+
=== 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="300px"|Inventory
+
!width="110px"|Data file info
+
!width="275px"|Path
+
!width="300px"|Status
+
|-
+
|[[Historical_and_Future_Emissions#RCP_future_emission_scenarios|RCP future scenarios]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/RCP/RCP26/README README]
+
|<tt>$ROOT/RCP/RCP26</tt>
+
|STILL BEING IMPLEMENTED
+
|}
+
 
+
--[[User:Bmy|Bob Y.]] 11:07, 13 February 2015 (EST)
+
 
+
=== 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="300px"|Inventory
+
!width="110px"|Data file info
+
!width="275px"|Path
+
!width="300px"|Status
+
|-
+
|[[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>
+
|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>
+
|CURRENTLY USED
+
|-valign="top"
+
|[[CO2 simulation]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CO2/v2014-09/README README]
+
|<tt>$ROOT/CO2/v2014-09</tt>
+
|CURRENTLY USED
+
|-valign="top"
+
|[[Mercury|Mercury simulation]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MERCURY/v2014-09/README README]
+
|<tt>$ROOT/MERCURY/v2014-09/</tt>
+
|CURRENTLY USED
+
|-valign="top"
+
|[[POPs simulation]]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/POPs/v2014-09/README README]
+
|<tt>$ROOT/POPs/v2014-09</tt>
+
|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>
+
|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>
+
|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>
+
|CURRENTLY USED
+
|-valign="top"
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OH/v2014-09/README OH for offline simulations]
+
|[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</tt>
+
|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>
+
|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>
+
|OBSOLETE
+
*This simulation is no longer used in GEOS-Chem (awaiting revival)
+
|}
+
 
+
--[[User:Bmy|Bob Y.]] 13:13, 18 February 2015 (EST)
+
 
+
=== Seawater concentrations ===
+
 
+
The following subdirectories of the HEMCO directory tree input data contains seawater concentrations used by the acetone ocean loss and sulfate chemistry modules.
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|- bgcolor="#cccccc"
+
!width="300px"|Inventory
+
!width="110px"|Data file info
+
!width="275px"|Path
+
!width="300px"|Status
+
|-
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/ACET/v2014-07/README Acetone seawater]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/ACET/v2014-07/README README]
+
|<tt>$ROOT/ACET/v2014-07</tt>
+
|CURRENTLY USED
+
|-
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/DMS/v2014-07/README DMS seawater]
+
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/DMS/v2014-07/README README]
+
|<tt>$ROOT/DMS/v2014-07</tt>
+
|CURRENTLY USED
+
|}
+
 
+
--[[User:Bmy|Bob Y.]] 11:22, 13 February 2015 (EST)
+
 
+
=== Stratospheric data and bromine data ===
+
 
+
The following subdirectories of the HEMCO directory tree input data contains data for use with the GEOS-Chem's stratospheric chemistry mechanism.
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|- bgcolor="#cccccc"
+
!width="300px"|Inventory
+
!width="110px"|Data file info
+
!width="275px"|Path
+
!width="300px"|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/STRAT/v2015-01/Bry</tt>
+
|CURRENTLY USED
+
|-
+
|[[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>
+
|CURRENTLY USED
+
|-
+
|[[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>
+
|CURRENTLY USED
+
|}
+
 
+
--[[User:Bmy|Bob Y.]] 15:53, 17 February 2015 (EST)
+
 
+
=== Other inputs for HEMCO ===
+
 
+
The following subdirectories of the HEMCO directory tree input data for various HEMCO functions.  These include regional masks, timezones, and emission scale factors.
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|- bgcolor="#cccccc"
+
!width="300px"|Inventory
+
!width="110px"|Data file info
+
!width="275px"|Path
+
!width="300px"|Status
+
|-
+
|[[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>
+
|CURRENTLY USED
+
|-
+
|Mask files
+
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MASKS/v2014-07/README README]
+
|<tt>$ROOT/MASKS/v2014-07</tt>
+
|CURRENTLY USED
+
|-
+
|[[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>
+
|CURRENTLY USED
+
|-
+
|Timezone offsets from UTC
+
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/TIMEZONES/v2015-02/README README]
+
|<tt>$ROOT/TIMEZONES/v2015-02</tt>
+
|CURRENTLY USED
+
|-
+
|[[Scale factors for anthropogenic emissions|Weekly scale factors]]
+
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/WEEKSCALE/v2015-01/README README]
+
|<tt>$ROOT/WEEKSCALE/v2014-07</tt>
+
|CURRENTLY USED
+
|}
+
 
+
--[[User:Bmy|Bob Y.]] 11:23, 13 February 2015 (EST)
+
 
+
== 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://github.com/GCST/hemco_data_download.git</nowiki>
+
 
+
This will create a directory named <tt>hemco_data_download</tt>, in which you should see the following files:
+
 
+
;<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 Y.]] 13:58, 12 February 2015 (EST)
+
 
+
=== 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.            #
+
#                                                                            #
+
###############################################################################
+
+
#=============================+================================================
+
# 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)
+
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.