HEMCO data directories: Difference between revisions

From Geos-chem
Jump to navigation Jump to search
 
(798 intermediate revisions by 3 users not shown)
Line 1: Line 1:
'''''NOTE: Page under construction'''''
== Overview ==
== Overview ==


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.


== Data directories by GEOS-Chem version ==


== HEMCO data directory structure ==
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>]. 


In the following sections we list the directory structure containing emissions inventories and related data files for use with HEMCO. Each data directory is referenced relative to the HEMCO root directory, which is specified by <tt>$ROOT</tt> token.
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.
 
For example, on the Harvard disk server, the value of <tt>$ROOT</tt> is <tt>/mnt/gcgrid/data/ExtData/HEMCO/</tt>. All of the data files read by HEMCO are stored in subfolders of this root directory.
 
--[[User:Bmy|Bob Y.]] 13:06, 12 February 2015 (EST)
 
=== Aerosols ===


{| border=1 cellspacing=0 cellpadding=5
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
|-bgcolor="#CCCCCC"
!width="300px"|Inventory
!width="150px"|Version
!width="300px"|Path
!width="200px"|Chemistry Inputs
!width="400px"|Status
!width="200px"|Emissions Inputs
|-
!width="200px"|Initial Conditions
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/VOLCANO/v2014-10/README AEROCOM volcanic emissions]
|<tt>$ROOT/VOLCANO/v2014-10</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/BCOC_BOND/v2014-07/README Tami Bond et al BC and OC emissions]
|<tt>$ROOT/BCOC_BOND/v2014-07</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/BCOC_COOKE/v2014-07/README Cooke et al BC and OC emissions]
|<tt>$ROOT/BCOC_COOKE/v2014-07</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/SOA/v2014-07/README Secondary organic aerosols]
|<tt>$ROOT/HEMCO/SOA/2014-07</tt>
|CURRENTLY USED
|}


--[[User:Bmy|Bob Y.]] 11:50, 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>]


{| border=1 cellspacing=0 cellpadding=5
|-valign="top" align="center"
|- bgcolor="#cccccc"
|[[GEOS-Chem 14.0.0]]
!width="300px"|Inventory
|[https://github.com/geoschem/input-data-catalogs/blob/e61ca36cdbd1c1bfeb58ff20a5633c97dcc48164/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
!width="300px"|Path
|[https://github.com/geoschem/input-data-catalogs/blob/e61ca36cdbd1c1bfeb58ff20a5633c97dcc48164/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
!width="400px"|Status
|[https://github.com/geoschem/input-data-catalogs/blob/e61ca36cdbd1c1bfeb58ff20a5633c97dcc48164/InitialConditions.csv <tt>InitialConditions.csv</tt>]
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/GEIA/v2014-07/README GEIA global anthropogenic]
|<tt>$ROOT/GEIA/v2014-07/</tt>
|Slated for replacement
|-valign="top"
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/NH3/v2014-07/README GEIA NH3 (anthro, biofuel, natural source)]
|<tt>$ROOT/NH3/v2014-07</tt>
|CURRENTLY USED
*Slated for replacement after [[GEOS-Chem v10-01]] ships.
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/EDGAR/v2014-07/README EDGAR global anthropogenic]
|<tt>$ROOT/EDGAR/v2014-07</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/RETRO/v2014-07/README RETRO VOC emissions]
|<tt>$ROOT/RETRO/v2014-07</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/BIOFUEL/v2014-07/README Yevich & Logan biofuels]
|<tt>$ROOT/BIOFUEL/v2014-07/</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/BRAVO/v2014-07/README BRAVO regional anthropogenic]
|<tt>$ROOT/BRAVO/v2014-07</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CAC/v2014-07/README CAC regional anthropogenic]
|<tt>$ROOT/CAC/v2014-07</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/EMEP/v2015-01/README EMEP regional anthropogenic]
|<tt>$ROOT/EMEP/v2015-01</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/NEI2005/v2014-09/README NEI2005 regional anthro/biofuel]
|<tt>$ROOT/NEI2005/v2014-09</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/VISTAS/v2014-07/README NEI/VISTAS scale factors]
|<tt>$ROOT/VISTAS/v2014-07</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/STREETS/v2014-07/README Streets regional anthro]
|<tt>$ROOT/STREETS/v2014-07</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MASAGE_NH3/v2015-02/README MASAGE agricultural NH3]
|<tt>$ROOT/MASAGE_NH3/v2015-02</tt>
|To debut in [[GEOS-Chem v10-01]]
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/XIAO/v2014-09/README Yaping Xiao et al C2H6 and C3H8 anthropogenic]
|<tt>$ROOT/XIAO/v2014-09/</tt>
|CURRENTLY USED
|}


--[[User:Bmy|Bob Y.]] 12:13, 12 February 2015 (EST)
|-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>]


=== Anthropogenic aircraft and ship emissions ===
|-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>]


{| border=1 cellspacing=0 cellpadding=5
|-valign="top" align="center"
|- bgcolor="#cccccc"
|[[GEOS-Chem 13.2.0]]
!width="300px"|Inventory
|[https://github.com/geoschem/input-data-catalogs/blob/a6decd86b2e974fbf2e934ad2391c28ee034d556/ChemistryInputs.csv <tt>ChemistryInputs.csv</tt>]
!width="300px"|Path
|[https://github.com/geoschem/input-data-catalogs/blob/a6decd86b2e974fbf2e934ad2391c28ee034d556/EmissionsInputs.csv <tt>EmissionInputs.csv</tt>]
!width="400px"|Status
|[https://github.com/geoschem/input-data-catalogs/blob/a6decd86b2e974fbf2e934ad2391c28ee034d556/InitialConditions.csv <tt>InitialConditions.csv</tt>]
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/AEIC/v2014-10/README AEIC aircraft]
|<tt>$ROOT/AEIC/v2014-10</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/ARCTAS_SHIP/v2014-07/README ARCTAS ship emissions]
|<tt>$ROOT/ARCTAS_SHIP/v2014-07</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CORBETT_SHIP/v2014-07/README Corbett et al ship emissions]
|<tt>$ROOT/VOLCANO/v2014-10</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/ICOADS_SHIP/v2014-07/README ICOADS ship]
|<tt>$ROOT/ICOADS_SHIP/v2014-07</tt>
|CURRENTLY USED
|}


--[[User:Bmy|Bob Y.]] 12:19, 12 February 2015 (EST)
|-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>]


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


{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
!width="300px"|Inventory
!width="300px"|Path
!width="400px"|Status
|-valign="top"
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/GFED3/v2014-10/README GFED3 biomass]
|<tt>$ROOT/GFED3/v2014-10</tt>
|CURRENTLY USED
*This is the default biomass burning inventory.
*Soon to be replaced by GFED4.
|-valign="top"
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/FINN/v2015-02/README FINN biomass]
|<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"
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/QFED/v2014-09/README QFED biomass]
|<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"
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/GFED2/v2014-07/README GFED2 biomass]
|<tt>$ROOT/GFED2/v2014-07</tt>
|OBSOLETE
*Superseded by GFED3.
|-valign="top"
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/BIOBURN/v2014-07/README Duncan et al biomass]
|<tt>$ROOT/BIOBURN/v2014-07</tt>
|OBSOLETE
*Superseded by GFED3.
|}
--[[User:Bmy|Bob Y.]] 12:27, 12 February 2015 (EST)
=== Emissions implemented as HEMCO extensions ===
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
!width="300px"|Inventory
!width="300px"|Path
!width="400px"|Status
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/DUST_DEAD/v2014-07/README DEAD dust model]
|<tt>$ROOT/DUST_DEAD/2014-07</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/DUST_GINOUX/v2014-07/README GINOUX dust model]
|<tt>$ROOT/DUST_GINOUX/2014-07</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MEGAN/v2014-07/README MEGAN biogenic emissions]
|<tt>$ROOT/MEGAN/v2014-07</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/LIGHTNOX/v2014-07/README NO from lightning]
|<tt>$ROOT/LIGHTNOX/v2014-07</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/SOILNOX/v2014-07/README NO from soils/fertilizers]
|<tt>$ROOT/SOILNOX/v2014-07</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/VOLCANO/v2014-10/README PARANOX ship plume model]
|<tt>$ROOT/PARANOX/v2014-07</tt>
|CURRENTLY USED
|}
|}


--[[User:Bmy|Bob Y.]] 12:43, 12 February 2015 (EST)
== Emissions reference ==
 
=== Future and historical emissions ===
 
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
!width="300px"|Inventory
!width="300px"|Path
!width="400px"|Status
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/RCP/RCP26/README RCP future scenarios]
|<tt>$ROOT/RCP/RCP26</tt>
|STILL BEING IMPLEMENTED
|}
 
--[[User:Bmy|Bob Y.]] 12:40, 12 February 2015 (EST)
 
=== GEOS-Chem specialty simulation data ===
 
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
!width="300px"|Inventory
!width="300px"|Path
!width="400px"|Status
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OFFLINE_AEROSOL/v2014-09/README Aerosol-only simulation]
|<tt>$ROOT/OFFLINE_AEROSOL/v2014-09</tt>
|CURRENTLY USED
|-valign="top"
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CH4/v2014-09/README CH4 simulation]
|<tt>$ROOT/CH4/v2014-09</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/CO2/v2014-09/README CO2 simulation]
|<tt>$ROOT/CO2/v2014-09</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MERCURY/v2014-09/README Mercury simulation]
|<tt>$ROOT/MERCURY/v2014-09/</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/POPs/v2014-09/README POPs simulation]
|<tt>$ROOT/POPs/v2014-09</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/TAGGED_CO/v2014-08/README Tagged CO simulation]
|<tt>$ROOT/TAGGED_CO/v2014-08</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/TAGGED_O3/v2014-09/README Tagged O3 simulation]
|<tt>$ROOT/TAGGED_O3/v2014-09</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/O3/v2014-09/README O3 for offline simulations]
|<tt>$ROOT/O3/v2014-09/</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OH/v2014-09/README OH for offline simulations]
|<tt>$ROOT/OH/v2014-09</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OXIDANTS/v2014-07/README H2O2 for offline simulations]
|<tt>$ROOT/OXIDANTS/v2014-07</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OXIDANTS/v2014-07/README CH3I simulation]
|<tt>$ROOT/CH3I/v2014-07</tt>
|OBSOLETE
|}
 
--[[User:Bmy|Bob Y.]] 12:53, 12 February 2015 (EST)
 
=== Seawater concentrations ===
 
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
!width="300px"|Inventory
!width="300px"|Path
!width="400px"|Status
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/ACET/v2014-07/README Acetone seawater]
|<tt>$ROOT/ACET/v2014-07</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/RCP/RCP26/README DMS seawater]
|<tt>$ROOT/DMS/v2014-07</tt>
|CURRENTLY USED
|}
 
--[[User:Bmy|Bob Y.]] 12:55, 12 February 2015 (EST)
 
=== Stratospheric data ===
 
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
!width="300px"|Inventory
!width="300px"|Path
!width="400px"|Status
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/STRAT/v2015-01/README Stratospheric Bry data]
|<tt>$ROOT/STRAT/v2015-01</tt>
|CURRENTLY USED
|}
 
--[[User:Bmy|Bob Y.]] 12:58, 12 February 2015 (EST)
 
=== Other inputs for HEMCO ===
 
{| border=1 cellspacing=0 cellpadding=5
|- bgcolor="#cccccc"
!width="300px"|Inventory
!width="300px"|Path
!width="400px"|Status
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/AnnualScalar/v2014-07/README Annual scale factors]
|<tt>$ROOT/AnnualScalar/v2014-07</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MASKS/v2014-07/README Mask files]
|<tt>$ROOT/MASKS/v2014-07</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/MAP_A2A/v2014-07/README MAP_A2A regridding data]
|<tt>$ROOT/MAP_A2A/v2014-07</tt>
|CURRENTLY USED
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/TIMEZONES/v2015-02/README Timezone offsets from UTC]
|<tt>$ROOT/TIMEZONES/v2015-02</tt>
|Will debut in [[GEOS-Chem v10-01]]
|-
|[ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/STRAT/v2015-01/README Weekly scale factors]
|<tt>$ROOT/WEEKSCALE/v2014-07</tt>
|CURRENTLY USED
|}
 
--[[User:Bmy|Bob Y.]] 12:59, 12 February 2015 (EST)
 
== Downloading the HEMCO data directories ==
 
The [[GEOS-Chem Support Team]] has created a package called '''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 hemcoDataDownload.pl script.  In this file you can specify which HEMCO data directories you would like to download and which you would like to omit.
;<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.
 
=== 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 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 ...
Lines starting with the comment character # will be ignored. 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.
 
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
 
which will read the default <tt>hemcoDataDownload.rc</tt> configuration file.
 
You may also specify a different configuration file name as an argument to the script.  For example, we have provided a configuration file named <tt>forTesting.rc</tt> that you can use to test if the data is being downloaded to the right directory path.  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.

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