Difference between revisions of "HEMCO data directories"
(→Anthropogenic and biofuel emissions) |
(→Non-emissions data) |
||
Line 799: | Line 799: | ||
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 21:16, 5 March 2018 (UTC) | --[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 21:16, 5 March 2018 (UTC) | ||
+ | |||
+ | === Natural emissions data === | ||
+ | |||
+ | {| border=1 cellspacing=0 cellpadding=5 | ||
+ | |- bgcolor="#cccccc" | ||
+ | !width="250px"|Inventory | ||
+ | !width="110px"|Data file info | ||
+ | !width="300px"|Path | ||
+ | !width="110px"|Directory size | ||
+ | !width="350px"|Status | ||
+ | |||
+ | |-valign="top" | ||
+ | |[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/NH3/v2018-04/README NH3 emissions from arctic sea birds] | ||
+ | |[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/NH3/v2018-04/README README] | ||
+ | |<tt>HEMCO/NH3/v2018-04/</tt> | ||
+ | |104 MB | ||
+ | |bgcolor="#FFFF00"|TO BE ADDED SOON | ||
+ | *Will become available in [[GEOS-Chem v11-02|v11-02]] | ||
+ | |||
+ | |} | ||
+ | |||
+ | --[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 19:56, 17 April 2018 (UTC) | ||
=== Non-emissions data === | === Non-emissions data === | ||
Line 872: | Line 894: | ||
|} | |} | ||
− | --[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) | + | --[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 19:56, 17 April 2018 (UTC) |
=== Oceanic emissions === | === Oceanic emissions === |
Revision as of 19:56, 17 April 2018
On this page we describe the directory tree from which the HEMCO emissions component can read emissions inventories and other atmospheric data sets.
Contents
- 1 Overview
- 2 HEMCO data directory structure
- 2.1 Aerosol emissions
- 2.2 Anthropogenic and biofuel emissions
- 2.3 Anthropogenic aircraft and ship emissions
- 2.4 Biomass burning emissions
- 2.5 Emissions implemented as HEMCO extensions
- 2.6 Future and historical emissions
- 2.7 GEOS-Chem specialty simulation data
- 2.8 Halogen emissions
- 2.9 Natural emissions data
- 2.10 Non-emissions data
- 2.11 Oceanic emissions
- 2.12 Other inputs for HEMCO
- 3 Downloading the HEMCO data directories
- 4 Submitting new data for use with HEMCO
Overview
The 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.
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 section below.
Please see our list of recommended default emission inventories, which has been compiled by the Emissions and Deposition Working Group.
--Bob Yantosca (talk) 22:27, 7 September 2017 (UTC)
HEMCO data directory structure
The sections below describe each of the data sets contained in the HEMCO directory tree, grouped by type.
In each of the tables below:
- The Inventory column contains a link that describes each data set in more detail. Most of these links point to existing pages on the GEOS-Chem wiki.
- The Data file info column points to the README files that are stored with each data set. Each README provides a list of the files contained within a given folder, information about the data contained in each file, and (often) a description of how the files were created.
- The Path column shows the location of each data set, with respect to $ROOT, the top-level HEMCO directory. For example, on the Harvard disk server, $ROOT points to the directory /mnt/gcgrid/data/ExtData/HEMCO/.
- The Status column describes the current status of each data set:
CURRENTLY USED 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 benchmark simulations, or
- It is used in one or more of the GEOS-Chem specialty simulations.
OPTIONAL Denotes that the data set is not part of the the standard GEOS-Chem emissions configuration. - But you can still use the data set in your research applications if you wish.
TO BE ADDED SOON Denotes that the data set is not yet ready for use with HEMCO, but will be added soon. OBSOLETE Denotes that the data set has been removed from the standard GEOS-Chem emissions configuration. - In most cases, OBSOLETE means that a newer version of the data is available and should be used instead.
NOT USED Denotes that the data set is not used in the standard GEOS-Chem emissions configuration, even if it is current. - For example, another data source is being used in place of this data set for a particular reason.
- If use GEOS-Chem, then we recommend that you download the data sets that are listed as CURRENTLY USED, as these form the standard GEOS-Chem emissions configuration. You are free, however, to use any of the data sets listed below. Your choice of data sets will depend on your particular research needs.
--Bob Y. 10:53, 18 March 2015 (EDT)
Aerosol emissions
The following subdirectories of the HEMCO directory tree contain aerosol emission inventories.
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
AEROCOM volcanic emissions | README | $ROOT/VOLCANO/v2015-02 | 1.6 GB | CURRENTLY USED
|
Tami Bond et al (2007) BC and OC emissions | README | $ROOT/BCOC_BOND/v2014-07 | 3.0 MB | CURRENTLY USED
|
Secondary organic aerosols | README | $ROOT/SOA/2014-07 | 3.0 MB | CURRENTLY USED
|
Cooke et al BC and OC emissions | README | $ROOT/BCOC_COOKE/v2014-07 | 744 KB | OPTIONAL
|
--Bob Y. 10:15, 18 March 2015 (EDT)
Anthropogenic and biofuel emissions
The following subdirectories of the HEMCO directory tree contain inventories of anthropogenic and biofuel emissions.
Please also see list of species included in each of these global inventories and regional inventories.
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
Inventories that are activated by default in the HEMCO configuration file for the current GEOS-Chem public release (v11-01) | ||||
EDGAR v4.2 global anthropogenic | README | $ROOT/EDGARv42/v2015-02 $ROOT/EDGARv42/v2015-02/CO $ROOT/EDGARv42/v2015-02/NH3 $ROOT/EDGARv42/v2015-02/NO $ROOT/EDGARv42/v2015-02/SO2 $ROOT/EDGARv42/v2015-02/VOCv2 |
4.5 GB | CURRENTLY USED
|
GEIA NH3 (anthro, biofuel, natural source) | README | $ROOT/NH3/v2014-07 | 8.1 MB | CURRENTLY USED
|
RETRO VOC emissions | README | $ROOT/RETRO/v2014-07/orig_kgC | 38 MB | CURRENTLY USED
|
Yevich & Logan biofuels | README | $ROOT/BIOFUEL/v2014-07 | 1.1 MB | CURRENTLY USED
|
BRAVO regional anthropogenic | README | $ROOT/BRAVO/v2014-07 | 68 KB | CURRENTLY USED
|
CAC regional anthropogenic | README | $ROOT/CAC/v2016-09 | 29 MB | CURRENTLY USED
|
EMEP regional anthropogenic | README | $ROOT/EMEP/v2015-03 | 24 MB | CURRENTLY USED
|
MIX Asian anthropogenic emissions | README | $ROOT/MIX/v2015-03 | 623 MB | CURRENTLY USED
|
NEI2005 regional anthro/biofuel | README | $ROOT/NEI2005/v2014-09 | 8.1 MB | CURRENTLY USED
|
NEI/VISTAS scale factors | README1 README2 |
$ROOT/VISTAS/v2014-07 $ROOT/VISTAS/v2014-07/VISTAS_NOX $ROOT/VISTAS/v2014-07/VISTAS_WEWD |
46 MB | CURRENTLY USED
|
NEI2011 regional anthro/biofuel (hourly data) | README | $ROOT/NEI2011/v2015-03 | 248 GB | CURRENTLY USED
|
NEI2011 agricultural emissions only | README | $ROOT/NEI2011_ag_only/v2015-03 | 648 MB | CURRENTLY USED |
Yaping Xiao et al C2H6 and C3H8 anthropogenic | README | $ROOT/XIAO/v2014-09 | 308 KB | CURRENTLY USED
|
Inventories that are deactivated by default in the HEMCO configuration file for the current GEOS-Chem public release (v11-01). You can use any of these inventories for your own research needs. | ||||
MASAGE agricultural NH3 | README | $ROOT/MASAGE_NH3/v2015-02 | 4.4 MB | OPTIONAL
|
HTAP global anthro+biofuel | README | $ROOT/HTAP/v2015-03 | 4.5 GB | OPTIONAL
|
Streets regional anthro | README1 README2 |
$ROOT/STREETS/v2014-07 | 1.7 MB | OPTIONAL
|
NEI2008 regional anthro/biofuel | README | $ROOT/NEI2008/v2015-02 | 3.0 GB | OPTIONAL
|
Inventories that will be introduced in the next GEOS-Chem public release (v11-02) | ||||
C2H6 global emissions | README | $ROOT/C2H6_2010/v2017-05 | 140 GB | TO BE ADDED SOON
|
CEDS anthropogenic emissions | README | $ROOT/CEDS/v2018-04 | 140 GB | TO BE ADDED SOON
|
EDGAR v4.3 anthropogenic emissions | README | $ROOT/EDGARv43/v2016-11 | 6.2 GB | TO BE ADDED SOON
|
DICE-Africa anthropogenic emissions | README | $ROOT/DICE_Africa/v2016-10 | 202 MB | TO BE ADDED SOON
|
NEI2011 regional anthro/biofuel (monthly mean data) | README | $ROOT/NEI2011/v2017-02-MM | TBD | TO BE ADDED SOON
|
POET anthropogenic emissions | README | HEMCO/POET/v2017-03/ | 44 KB | TO BE ADDED SOON
|
Trash burning emissions | README | HEMCO/TrashEmis/v2015-03/ | 86 MB | TO BE ADDED SOON
|
Inventories that have been superseded by newer developments. You can still use these for your own research needs, if necessary. | ||||
CAC regional anthropogenic (1° x 1° resolution) |
README | $ROOT/CAC/v2014-07 | 384 KB | OBSOLETE
|
GEIA global anthropogenic | README | $ROOT/GEIA/v2014-07 | 4.8 MB | OBSOLETE
|
EDGAR v3 global anthropogenic | README | $ROOT/EDGAR/v2014-07 | 40 MB | OBSOLETE
|
--Bob Yantosca (talk) 17:39, 25 April 2017 (UTC)
Anthropogenic aircraft and ship emissions
The following subdirectories of the HEMCO directory tree contain inventories of anthropogenic aircraft and ship emissions.
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
AEIC aircraft | README | $ROOT/AEIC/v2015-01 | 2.0 GB | CURRENTLY USED
|
ARCTAS ship emissions (SO2) | README | $ROOT/ARCTAS_SHIP/v2014-07 | 508 KB | CURRENTLY USED
|
ICOADS ship (CO) | README | $ROOT/ICOADS_SHIP/v2014-07 | 4.2 MB | CURRENTLY USED
|
EMEP ship (CO, NO, SO2) | README | $ROOT/EMEP/v2015-03 | 24 MB | CURRENTLY USED
|
Corbett et al ship emissions (SO2) | README | $ROOT/CORBETT_SHIP/v2014-07 | 1.8 MB | OPTIONAL
|
HTAP ship (CO, NO, SO2) | README | $ROOT/HTAP/v2015-03 | 4.5 GB | OPTIONAL
|
NEI2011 ship (several species) | README | $ROOT/NEI2011/v2015-03 | 248 GB | OPTIONAL
|
EDGAR v3 ship (CO) | README | $ROOT/EDGAR/v2014-07 | 40 MB | OBSOLETE |
EDGAR v4.2 ship | README | $ROOT/EDGARv42/v2015-02 | 4.5 GB | NOT USED
|
--Bob Y. 10:07, 18 March 2015 (EDT)
Biomass burning emissions
The following subdirectories of the HEMCO directory tree contain inventories of biomass burning emissions.
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
GFED4 biomass burning | README | $ROOT/GFED4/v2015-10 | 692 MB | CURRENTLY USED
|
README | $ROOT/GFED4/v2015-06 | 115 MB | OBSOLETE
| |
GFED3 biomass burning | README | $ROOT/GFED3/v2014-10 | 343 MB | CURRENTLY USED
|
FINN v1.6 biomass burning | README | $ROOT/FINN/v2018-04 | 1.1 GB | OPTIONAL
|
FINN v1.5 biomass burning | README | $ROOT/FINN/v2015-02 | 689 MB | OPTIONAL
|
QFED biomass burning | README | $ROOT/QFED/v2014-09 | 57 GB | OPTIONAL
|
GFED2 biomass burning | README | $ROOT/GFED2/v2014-07 | 196 KB | OBSOLETE
|
Duncan et al biomass burning | README | $ROOT/BIOBURN/v2014-07 | 925 MB | OBSOLETE
|
--Bob Yantosca (talk) 15:57, 19 December 2016 (UTC)
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, GFED4 and FINNv1 are implemented as HEMCO extensions, but we have listed them with the other biomass burning inventories, for clarity.
Inventory | Data file info! | Path | Directory size | Status |
---|---|---|---|---|
Acetone ocean exchange | README | $ROOT/ACET/v2014-07 | 52 KB | CURRENTLY USED |
DEAD dust model | README | $ROOT/DUST_DEAD/2014-07 | 712 KB | CURRENTLY USED
|
DMS ocean exchange | README | $ROOT/DMS/v2015-07 | 3.0 MB | CURRENTLY USED
|
README | $ROOT/DMS/v2014-07 | 2.2 MB | OBSOLETE
| |
MEGAN biogenic emissions | README | $ROOT/MEGAN/v2015-02 | 2.0 MB | CURRENTLY USED
|
NO from lightning | README | $ROOT/LIGHTNOX/v2014-07 | 13 MB | CURRENTLY USED |
NO from soils/fertilizers | README | $ROOT/SOILNOX/v2014-07 | 79 MB | CURRENTLY USED |
PARANOX ship plume model | README | $ROOT/PARANOX/v2015-02 | 162 MB | CURRENTLY USED
|
GINOUX dust model | README | $ROOT/DUST_GINOUX/2014-07 | 36 KB | OPTIONAL
|
--Bob Yantosca (talk) 15:59, 19 December 2016 (UTC)
Future and historical emissions
The following subdirectories of the HEMCO directory tree contain historical and future emissions inventories.
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
RCP future scenarios | README | $ROOT/RCP/v2015-02 | 368 MB | OPTIONAL
|
--Bob Y. 15:04, 17 March 2015 (EDT)
GEOS-Chem specialty simulation data
The following subdirectories of the HEMCO directory tree input data (emissions, oxidants, etc.) for use with the GEOS-Chem specialty simulations. If you do not regularly use these simulations, you may choose not to download these data directories.
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
Aerosol-only simulation | README | $ROOT/OFFLINE_AEROSOL/v2014-09 | 165 MB | CURRENTLY USED |
CH4 simulation | README | $ROOT/CH4/v2014-09 | 274 MB | CURRENTLY USED |
CO2 simulation | README1 README2 README3 README4 README5 README6 |
$ROOT/CO2/v2015-04 $ROOT/CO2/v2015-04/BIO/ $ROOT/CO2/v2015-04/BIOFUEL/ $ROOT/CO2/v2015-04/CHEM/ $ROOT/CO2/v2015-04/FOSSIL/ $ROOT/CO2/v2015-04/OCEAN/ |
1033 MB | CURRENTLY USED |
Mercury simulation | README1 README2 README3 README4 README5 README6 README7 README8 README9 README10 |
$ROOT/MERCURY/v2014-09 $ROOT/MERCURY/v2014-09/ARTISANAL $ROOT/MERCURY/v2014-09/BrOx $ROOT/MERCURY/v2014-09/Hg2_PARTITION $ROOT/MERCURY/v2014-09/JVALUES $ROOT/MERCURY/v2014-09/NATURAL $ROOT/MERCURY/v2014-09/NEI2005 $ROOT/MERCURY/v2014-09/OCEAN $ROOT/MERCURY/v2014-09/SOIL $ROOT/MERCURY/v2014-09/STREETS |
342 MB | CURRENTLY USED |
POPs simulation | README | $$ROOT/POPs/v2015-08 | 809 MB | CURRENTLY USED
|
README | $ROOT/POPs/v2014-09 | 622 MB | OBSOLETE
| |
Tagged CO simulation | README | $ROOT/TAGGED_CO/v2014-08 | 260 KB | CURRENTLY USED |
Tagged O3 simulation | README | $ROOT/TAGGED_O3/v2014-09 | 372 MB | CURRENTLY USED |
O3 for offline simulations | README | $ROOT/O3/v2014-09 | 130 MB | CURRENTLY USED |
OH for offline simulations | README1 README2 |
$ROOT/OH/v2014-09 $ROOT/OH/v2014-09/v5-07-08 $ROOT/OH/v2014-09/v7-02-03.GMI |
148 MB | CURRENTLY USED |
H2O2 for offline simulations | README | $ROOT/OXIDANTS/v2014-07 | 32 MB | CURRENTLY USED |
Oceanic Chlorophyll-A for Hg simulations | README | $ROOT/CHLA/v2014-07 | 2.0 MB | CURRENTLY USED |
CH3I simulation | README | $ROOT/CH3I/v2014-07 | 280 KB | OBSOLETE
|
--Bob Yantosca (talk) 16:02, 19 December 2016 (UTC)
Halogen emissions
The following subdirectories of the HEMCO directory tree contain inventories of bromine and iodine emissions.
NOTE: See our Non-emissions data section for information about stratospheric bromine concentration data.
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
Liang et al VSL emissions | README | $ROOT/BROMINE/v2015-02 | 156 KB | CURRENTLY USED |
Ordonez et al Iodine emissions | README | $ROOT/IODINE/v2017-03 | 156 KB | TO BE ADDED SOON
|
--Bob Yantosca (talk) 21:16, 5 March 2018 (UTC)
Natural emissions data
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
NH3 emissions from arctic sea birds | README | HEMCO/NH3/v2018-04/ | 104 MB | TO BE ADDED SOON
|
--Bob Yantosca (talk) 19:56, 17 April 2018 (UTC)
Non-emissions data
The following subdirectories of the HEMCO directory tree input data contains non-emissions data sets. Most of these are used as inputs to GEOS-Chem's chemistry modules (i.e. photolysis, stratospheric chemistry, etc.).
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
GMI strat chem mechanism | README | $ROOT/GMI/v2015-02 | 16 GB | CURRENTLY USED
|
Stratospheric Bry from CCM | README | $ROOT/STRAT/v2015-01/Bry | 385 MB | CURRENTLY USED
|
Timezone offsets from UTC | README | $ROOT/TIMEZONES/v2015-02 | 264 KB | CURRENTLY USED
|
TOMS/SBUV O3 columns | README | $ROOT/TOMS_SBUV/v2016-11 | 21 MB | CURRENTLY USED
|
README | $ROOT/TOMS_SBUV/v2015-03 | 17 MB | OBSOLETE
| |
UCX data for linearized strat chem | README | $ROOT/UVALBEDO/v2015-03 | 6.6 GB | CURRENTLY USED
|
UV surface albedoes | README | $ROOT/UCX/v2015-03 | 468 KB | TO BE ADDED SOON
|
--Bob Yantosca (talk) 19:56, 17 April 2018 (UTC)
Oceanic emissions
The following folders contain data used to compute oceanic emissions of GEOS-Chem species.
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
Fields to compute ALD2 emissions
|
README | $ROOT/ALD2/v2017-03 | 0.5 MB | TO BE ADDED SOON
|
--Bob Yantosca (talk) 16:59, 25 April 2017 (UTC)
Other inputs for HEMCO
The following subdirectories of the HEMCO directory tree input data for various HEMCO functions. These include regional masks, emission scale factors, and grid information.
Inventory | Data file info | Path | Directory size | Status |
---|---|---|---|---|
Annual scale factors | README | $ROOT/AnnualScalar/v2014-07 | 3.0 MB | CURRENTLY USED
|
ID codes for each country | README | $ROOT/COUNTRY_ID/v2015-04 | 15 MB | CURRENTLY USED
|
Mask files for regional emissions | README | $ROOT/MASKS/v2014-07 | 51 MB | CURRENTLY USED
|
MAP_A2A regridding data | README | $ROOT/MAP_A2A/v2014-07 | 152 KB | CURRENTLY USED |
Weekly scale factors | README | $ROOT/WEEKSCALE/v2014-07 | 4.0 KB | OBSOLETE
|
--Bob Y. 15:08, 17 March 2015 (EDT)
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
git clone https://bitbucket.org/gcst/hemco_data_download.git
This will create a directory named hemco_data_download, in which you should see theR following files:
File | Description |
---|---|
README | File with an overall description of the directory contents |
hemcoDataDownload.pl | Perl script to download HEMCO data directories |
hemcoDataDownload.rc | 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. |
forTesting.rc | A configuration file that you can use for testing or debugging. This will tell hemcoDataDownload.pl only to download a couple of emissions inventories with files that do not take up much disk space. |
--Bob Yantosca (talk) 17:02, 5 December 2016 (UTC)
Setting up the configuration file
The configuration files (i.e. hemcoDataDownload.rc and forTesting.rc) 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. # # # ############################################################################### Remote HEMCO data path | ftp://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO Your HEMCO data path | /as/scratch/bmy/HEMCO Verbose output | yes Dryrun only? | no
Path | Description |
---|---|
Remote HEMCO data path | 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 | 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 | Allows you to print out the data download commands without actually downloading the data. This is useful for debugging. This can be set to either "yes" or "no". |
In the next section you specify all of the HEMCO inventories that you want to download. You will see this header:
############################################################################### # # # THE FOLLOWING DATA DIRECTORIES WILL BE DOWNLOADED. # # # # These data directories comprise the recommended emissions configuration # # for typical GEOS-Chem full-chemistry and specialty simulations. # # # # NOTE: In most cases, you only have to specify the top-level folder. # # All subfolders will be downloaded automatically. # # # ############################################################################### #=============================+================================================ # AEROSOLS | Directory paths #=============================+================================================ AEROCOM volcano emissions | $ROOT/VOLCANO/v2014-10 Bond et al BC/OC | $ROOT/BCOC_BOND/v2014-07 Cooke et al BC/OC | $ROOT/BCOC_COOKE/v2014-07 Secondary organic aerosols | $ROOT/SOA/v2014-07 ... etc ...
Each line specifies the name of a HEMCO emissions inventory and the data path where it can be found on disk, relative to the root data path. NOTE: The script will replace the $ROOT 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 ...
--Bob Y. 13:55, 12 February 2015 (EST)
Downloading the data
Once you have set up your configuration file, you can run the hemcoDataDownload.pl 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 hemcoDataDownload.pl scriptwill read the default configuration file hemcoDataDownload.rc 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 forTesting.rc. 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.
--Bob Y. 13:57, 12 February 2015 (EST)
New features for the GEOS-Chem v10-01 public release
For the GEOS-Chem v10-01 public release, we modified the default download options in the hemcoDataDownload.pl script. We changed the default wget options from:
wget r -nH -q ...
to
wget -r -nH -c -N -q ...
This will tell wget to only download new or modified files, instead of trying to download the entire data archive from scratch. This should hopefully subsequent data download processes faster.
--Bob Y. (talk) 18:35, 16 June 2015 (UTC)
Submitting new data for use with HEMCO
If you have a new emissions inventory or other atmospheric data set that you would like to add to the HEMCO data directories, then please contact the GEOS-Chem Support Team. Data files must be in COARDS-compliant or CF-compliant netCDF format. Please see our Preparing data files for use with HEMCO wiki page for more information.
--Bob Y. 11:49, 5 March 2015 (EST)