Difference between revisions of "HEMCO data directories"
(→Global inventories) |
m (Last name corrected) |
||
(26 intermediate revisions by one other user not shown) | |||
Line 5: | Line 5: | ||
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. | 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. | ||
− | At present, the HEMCO data directory tree resides on the | + | At present, the HEMCO data directory tree resides on the Compute Canada and AWS s3://gcgrid bucket. 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]]. | 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]]. | ||
− | |||
− | |||
== Downloading the HEMCO data directories == | == Downloading the HEMCO data directories == | ||
Line 39: | Line 37: | ||
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 17:07, 3 December 2020 (UTC) | --[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 17:07, 3 December 2020 (UTC) | ||
− | == HEMCO data | + | == HEMCO data directories corresponding to an emissions option == |
− | The sections below describe each of the data | + | The sections below describe each of the data directories corresponding to a HEMCO inventory or extension. These are grouped in the order in which they appear in the <tt>HEMCO_Config.rc</tt> version that ships with [[GEOS-Chem 13.0.0]].'' |
In each of the tables below: | In each of the tables below: | ||
Line 51: | Line 49: | ||
:The '''Path''' column shows the location of each data set, with respect to <tt>$ROOT</tt>, the top-level HEMCO directory. For example, on the Harvard disk server, <tt>$ROOT</tt> points to the directory <tt>/mnt/gcgrid/data/ExtData/HEMCO/</tt>. | :The '''Path''' column shows the location of each data set, with respect to <tt>$ROOT</tt>, the top-level HEMCO directory. For example, on the Harvard disk server, <tt>$ROOT</tt> points to the directory <tt>/mnt/gcgrid/data/ExtData/HEMCO/</tt>. | ||
− | :The '''Default or optional | + | :The '''Default or optional?''' column contains this description |
:{| border=1 cellspacing=0 cellpadding=5 | :{| border=1 cellspacing=0 cellpadding=5 | ||
Line 68: | Line 66: | ||
: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. | :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. | ||
− | |||
− | |||
=== Regional inventories === | === Regional inventories === | ||
Line 212: | Line 208: | ||
|-valign="top" | |-valign="top" | ||
|[https://onlinelibrary.wiley.com/doi/full/10.1002/2016JD025767 '''TZOMPASOSA_C2H6'''] | |[https://onlinelibrary.wiley.com/doi/full/10.1002/2016JD025767 '''TZOMPASOSA_C2H6'''] | ||
− | *Tzompa- | + | *Tzompa-Sosa et al [2017] C2H6 emissions (overwrites CEDS to address underestimates) |
*Data Years: 2010 | *Data Years: 2010 | ||
||[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/C2H6_2010/v2019-06/README README] | ||[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/C2H6_2010/v2019-06/README README] | ||
Line 280: | Line 276: | ||
{| border=1 cellspacing=0 cellpadding=5 | {| border=1 cellspacing=0 cellpadding=5 | ||
− | |- bgcolor="#cccccc" | + | |-bgcolor="#cccccc" |
− | !width=" | + | !width="450px"|Inventory |
!width="90px"|More info | !width="90px"|More info | ||
!width="275px"|Path | !width="275px"|Path | ||
!width="75px"|Data size | !width="75px"|Data size | ||
− | !width=" | + | !width="150px"|Default or Optional? |
|-valign="top" | |-valign="top" | ||
Line 374: | Line 370: | ||
{| border=1 cellspacing=0 cellpadding=5 | {| border=1 cellspacing=0 cellpadding=5 | ||
− | |- bgcolor="#cccccc" | + | |-bgcolor="#cccccc" |
− | !width=" | + | !width="450px"|Inventory |
!width="90px"|More info | !width="90px"|More info | ||
!width="275px"|Path | !width="275px"|Path | ||
!width="75px"|Data size | !width="75px"|Data size | ||
− | !width=" | + | !width="150px"|Default or Optional? |
|-valign="top" | |-valign="top" | ||
Line 421: | Line 417: | ||
=== Biomass burning emissions (not implemented as extensions) === | === Biomass burning emissions (not implemented as extensions) === | ||
− | ''NOTE: Some biomass burning inventories are implemented as HEMCO extensions. See | + | ''NOTE: Some biomass burning inventories are implemented as HEMCO extensions. See the [[#Emissions implemented as HEMCO extensions|Emissions implemented as HEMCO extensions]]'' below for more information.'' |
The following subdirectories of the HEMCO directory tree contain inventories of biomass burning emissions. | The following subdirectories of the HEMCO directory tree contain inventories of biomass burning emissions. | ||
{| border=1 cellspacing=0 cellpadding=5 | {| border=1 cellspacing=0 cellpadding=5 | ||
− | |- bgcolor="#cccccc" | + | |-bgcolor="#cccccc" |
− | !width=" | + | !width="450px"|Inventory |
!width="90px"|More info | !width="90px"|More info | ||
!width="275px"|Path | !width="275px"|Path | ||
!width="75px"|Data size | !width="75px"|Data size | ||
− | !width=" | + | !width="150px"|Default or Optional? |
|-valign="top" | |-valign="top" | ||
Line 444: | Line 440: | ||
|49 GB | |49 GB | ||
|bgcolor="#FFFF00"|'''OPTIONAL SETTING''' | |bgcolor="#FFFF00"|'''OPTIONAL SETTING''' | ||
− | + | ||
|-valign="top" | |-valign="top" | ||
Line 454: | Line 450: | ||
|247 GB | |247 GB | ||
|bgcolor="#FFFF00"|'''OPTIONAL SETTING''' | |bgcolor="#FFFF00"|'''OPTIONAL SETTING''' | ||
− | |||
|} | |} | ||
Line 463: | Line 458: | ||
{| border=1 cellspacing=0 cellpadding=5 | {| border=1 cellspacing=0 cellpadding=5 | ||
− | |- bgcolor="#cccccc" | + | |-bgcolor="#cccccc" |
− | !width=" | + | !width="450px"|Inventory |
!width="90px"|More info | !width="90px"|More info | ||
!width="275px"|Path | !width="275px"|Path | ||
!width="75px"|Data size | !width="75px"|Data size | ||
− | !width=" | + | !width="150px"|Default or Optional? |
|-valign="top" | |-valign="top" | ||
Line 474: | Line 469: | ||
*Dust emissions archived from HEMCO standalone simulations | *Dust emissions archived from HEMCO standalone simulations | ||
*Data Years: 1980-2020 | *Data Years: 1980-2020 | ||
+ | **NOTE: If you use OFFLINE_DUST, you must turn off both DustDead and DustGinoux extensions. | ||
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OFFLINE_DUST/v2019-01/README README] | |[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OFFLINE_DUST/v2019-01/README README] | ||
|<tt>$ROOT/OFFLINE_DUST/v2019-01</tt> | |<tt>$ROOT/OFFLINE_DUST/v2019-01</tt> | ||
|18 GB | |18 GB | ||
|bgcolor="#00FF00"|'''DEFAULT SETTING''' | |bgcolor="#00FF00"|'''DEFAULT SETTING''' | ||
− | |||
− | |||
|-valign="top" | |-valign="top" | ||
Line 485: | Line 479: | ||
*Biogenic VOC emissions generated from HEMCO standalone simulations | *Biogenic VOC emissions generated from HEMCO standalone simulations | ||
*Data Years: 1980-2020 | *Data Years: 1980-2020 | ||
+ | **NOTE: The MEGAN extension should remain on so that it can calculate biogenic emissions for some species not in this inventory. | ||
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OFFLINE_BIOVOC/v2019-01/README README] | |[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OFFLINE_BIOVOC/v2019-01/README README] | ||
|<tt>$ROOT/OFFLINE_BIOVOC/v2019-01</tt> | |<tt>$ROOT/OFFLINE_BIOVOC/v2019-01</tt> | ||
|1400 GB | |1400 GB | ||
|bgcolor="#00FF00"|'''DEFAULT SETTING''' | |bgcolor="#00FF00"|'''DEFAULT SETTING''' | ||
− | |||
− | |||
|-valign="top" | |-valign="top" | ||
Line 496: | Line 489: | ||
*Sea salt emissions generated from HEMCO standalone simulations | *Sea salt emissions generated from HEMCO standalone simulations | ||
*Data Years: 1980-2020 | *Data Years: 1980-2020 | ||
+ | **NOTE: If you use OFFLINE_SEASALT, turn off the SeaSalt extension. | ||
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OFFLINE_SEASALT/v2019-01/README README] | |[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OFFLINE_SEASALT/v2019-01/README README] | ||
|<tt>$ROOT/OFFLINE_SEASALT/v2019-01</tt> | |<tt>$ROOT/OFFLINE_SEASALT/v2019-01</tt> | ||
|876 GB | |876 GB | ||
|bgcolor="#00FF00"|'''DEFAULT SETTING''' | |bgcolor="#00FF00"|'''DEFAULT SETTING''' | ||
− | + | ||
− | + | ||
|-valign="top" | |-valign="top" | ||
Line 507: | Line 500: | ||
*Soil NOx emissions generated from HEMCO standalone simulations | *Soil NOx emissions generated from HEMCO standalone simulations | ||
*Data Years: 1980-2020 | *Data Years: 1980-2020 | ||
+ | **NOTE: If you use OFFLINE_SOILNOX, you must turn off the SoilNOx extension. | ||
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OFFLINE_SOILNOX/v2019-01/README README] | |[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OFFLINE_SOILNOX/v2019-01/README README] | ||
|<tt>$ROOT/OFFLINE_SOILNOX/v2019-01</tt> | |<tt>$ROOT/OFFLINE_SOILNOX/v2019-01</tt> | ||
|48 GB | |48 GB | ||
|bgcolor="#00FF00"|'''DEFAULT SETTING''' | |bgcolor="#00FF00"|'''DEFAULT SETTING''' | ||
− | + | ||
− | + | ||
|} | |} | ||
Line 520: | Line 513: | ||
{| border=1 cellspacing=0 cellpadding=5 | {| border=1 cellspacing=0 cellpadding=5 | ||
− | |- bgcolor="#cccccc" | + | |-bgcolor="#cccccc" |
− | !width=" | + | !width="450px"|Inventory |
!width="90px"|More info | !width="90px"|More info | ||
!width="275px"|Path | !width="275px"|Path | ||
!width="75px"|Data size | !width="75px"|Data size | ||
− | !width=" | + | !width="150px"|Default or Optional? |
|-valign="top" | |-valign="top" | ||
Line 569: | Line 562: | ||
|12 GB | |12 GB | ||
|bgcolor="#FFFF00"|'''OPTIONAL SETTING''' | |bgcolor="#FFFF00"|'''OPTIONAL SETTING''' | ||
− | |||
|-valign="top" | |-valign="top" | ||
Line 575: | Line 567: | ||
*Spatially varying OM/OC ratios for SOA species | *Spatially varying OM/OC ratios for SOA species | ||
*Data years: 2010 | *Data years: 2010 | ||
+ | **NOTE: OMOC_RATIO is controlled by a switch in <tt>input.geos</tt><br>(default is OFF) | ||
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OMOC/v2018-01/README README] | |[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/OMOC/v2018-01/README README] | ||
|<tt>$ROOT/OMOC/v2018-01</tt> | |<tt>$ROOT/OMOC/v2018-01</tt> | ||
|8.6 MB | |8.6 MB | ||
− | |bgcolor="#FFFF00"|OPTIONAL | + | |bgcolor="#FFFF00"|'''OPTIONAL SETTING''' |
− | + | ||
|-valign="top" | |-valign="top" | ||
Line 607: | Line 599: | ||
|1.9 MB | |1.9 MB | ||
|bgcolor="#00FF00"|'''DEFAULT SETTING''' | |bgcolor="#00FF00"|'''DEFAULT SETTING''' | ||
− | |||
− | |||
|-valign="top" | |-valign="top" | ||
Line 626: | Line 616: | ||
|19 MB | |19 MB | ||
|bgcolor="#FFFF00"|'''OPTIONAL SETTING''' | |bgcolor="#FFFF00"|'''OPTIONAL SETTING''' | ||
− | |||
|-valign="top" | |-valign="top" | ||
Line 638: | Line 627: | ||
|bgcolor="#00FF00"|'''DEFAULT SETTING''' | |bgcolor="#00FF00"|'''DEFAULT SETTING''' | ||
− | |-valign | + | |-valign="top" |
|[https://www.atmos-chem-phys-discuss.net/acp-2019-1043/ '''OCEAN_O3_DRYDEP'''] | |[https://www.atmos-chem-phys-discuss.net/acp-2019-1043/ '''OCEAN_O3_DRYDEP'''] | ||
*Ozone deposition to the ocean | *Ozone deposition to the ocean | ||
Line 645: | Line 634: | ||
|<tt>HEMCO/OCEAN_O3_DRYDEP/v2020-02</tt> | |<tt>HEMCO/OCEAN_O3_DRYDEP/v2020-02</tt> | ||
|388 MB | |388 MB | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|bgcolor="#00FF00"|'''DEFAULT SETTING''' | |bgcolor="#00FF00"|'''DEFAULT SETTING''' | ||
Line 663: | Line 643: | ||
{| border=1 cellspacing=0 cellpadding=5 | {| border=1 cellspacing=0 cellpadding=5 | ||
− | |- bgcolor="#cccccc" | + | |-bgcolor="#cccccc" |
− | !width=" | + | !width="450px"|HEMCO Extension |
!width="90px"|More info | !width="90px"|More info | ||
!width="275px"|Path | !width="275px"|Path | ||
!width="75px"|Data size | !width="75px"|Data size | ||
− | !width=" | + | !width="150px"|Default or Optional? |
|-valign="top" | |-valign="top" | ||
Line 685: | Line 665: | ||
|162 MB | |162 MB | ||
|bgcolor="#00FF00"|'''DEFAULT SETTING''' | |bgcolor="#00FF00"|'''DEFAULT SETTING''' | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|-valign="top" | |-valign="top" | ||
Line 707: | Line 678: | ||
|[[Hudman_et_al_2012_soil_NOx_emissions_algorithm|'''SoilNOx''']] | |[[Hudman_et_al_2012_soil_NOx_emissions_algorithm|'''SoilNOx''']] | ||
*Hudman et al [2012] soil NOx emissions algorithm | *Hudman et al [2012] soil NOx emissions algorithm | ||
− | * | + | **NOTE: If you use SoilNOx, turn off OFFLINE_SOILNOX. |
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/SOILNOX/v2014-07/README README] | |[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/SOILNOX/v2014-07/README README] | ||
|<tt>$ROOT/SOILNOX/v2014-07</tt> | |<tt>$ROOT/SOILNOX/v2014-07</tt> | ||
|730 MB | |730 MB | ||
|bgcolor="#FFFF00"|'''OPTIONAL SETTING''' | |bgcolor="#FFFF00"|'''OPTIONAL SETTING''' | ||
− | |||
|-valign="top" | |-valign="top" | ||
|[[Mineral dust aerosols|'''DustDead''']] | |[[Mineral dust aerosols|'''DustDead''']] | ||
*DEAD dust model (cf. Zender) | *DEAD dust model (cf. Zender) | ||
+ | **NOTE: If you use DustDead, turn off OFFLINE_DUST. | ||
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/DUST_DEAD/v2014-07/README README] | |[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/DUST_DEAD/v2014-07/README README] | ||
|<tt>$ROOT/DUST_DEAD/2014-07</tt> | |<tt>$ROOT/DUST_DEAD/2014-07</tt> | ||
|712 KB | |712 KB | ||
|bgcolor="#FFFF00"|'''OPTIONAL SETTING''' | |bgcolor="#FFFF00"|'''OPTIONAL SETTING''' | ||
− | |||
|-valign="top" | |-valign="top" | ||
|[[Mineral dust aerosols|'''DustGinoux''']] | |[[Mineral dust aerosols|'''DustGinoux''']] | ||
*Ginoux et al dust model | *Ginoux et al dust model | ||
+ | **NOTE: If you use DustDead, turn off OFFLINE_DUST. | ||
|[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/DUST_GINOUX/v2014-07/README README] | |[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/DUST_GINOUX/v2014-07/README README] | ||
|<tt>$ROOT/DUST_GINOUX/2014-07</tt> | |<tt>$ROOT/DUST_GINOUX/2014-07</tt> | ||
|36 KB | |36 KB | ||
|bgcolor="#FFFF00"|'''OPTIONAL SETTING''' | |bgcolor="#FFFF00"|'''OPTIONAL SETTING''' | ||
− | |||
|-valign="top" | |-valign="top" | ||
|[[Mineral dust aerosols|'''SeaSalt''']] | |[[Mineral dust aerosols|'''SeaSalt''']] | ||
*Sea salt emissions | *Sea salt emissions | ||
+ | **NOTE: If you use SeaSalt, turn off OFFLINE_SEASALT. | ||
|colspan="3"|Does not have an associated data directory | |colspan="3"|Does not have an associated data directory | ||
|bgcolor="#FFFF00"|'''OPTIONAL SETTING''' | |bgcolor="#FFFF00"|'''OPTIONAL SETTING''' | ||
− | |||
|-valign="top" | |-valign="top" | ||
Line 746: | Line 716: | ||
|12 MB | |12 MB | ||
|bgcolor="#00FF00"|'''DEFAULT SETTING''' | |bgcolor="#00FF00"|'''DEFAULT SETTING''' | ||
− | |||
|-valign="top" | |-valign="top" | ||
Line 766: | Line 735: | ||
|1.2 GB | |1.2 GB | ||
|bgcolor="#FFFF00"|'''OPTIONAL SETTING''' | |bgcolor="#FFFF00"|'''OPTIONAL SETTING''' | ||
− | |||
|-valign="top" | |-valign="top" | ||
Line 773: | Line 741: | ||
|colspan="3"|Does not have an associated data directory. | |colspan="3"|Does not have an associated data directory. | ||
|bgcolor="#FFFF00"|'''OPTIONAL SETTING''' | |bgcolor="#FFFF00"|'''OPTIONAL SETTING''' | ||
− | |||
|-valign="top" | |-valign="top" | ||
− | |[[Volcanic_SO2_emissions|'''Volcano'''] | + | |[[Volcanic_SO2_emissions|'''Volcano''']] |
*Volcanic SO2 emissions from Aerocom | *Volcanic SO2 emissions from Aerocom | ||
*Data Years: 1978-2020 | *Data Years: 1978-2020 | ||
Line 791: | Line 758: | ||
|} | |} | ||
+ | |||
+ | == Other HEMCO data directories == | ||
+ | |||
+ | In each of the tables below: | ||
+ | |||
+ | :The '''Directory''' column contains a description of the directory and its contents. | ||
+ | |||
+ | :The '''More info''' column points to the README files that are stored with each data set. | ||
+ | |||
+ | :The '''Path''' column shows the location of each data set, with respect to <tt>$ROOT</tt>, the top-level HEMCO directory. For example, on the Harvard disk server, <tt>$ROOT</tt> points to the directory <tt>/mnt/gcgrid/data/ExtData/HEMCO/</tt>. | ||
+ | |||
+ | :The '''Used by?''' column lists in which context the data in each directory is used. | ||
=== HEMCO scale factors, masks, and other data === | === HEMCO scale factors, masks, and other data === | ||
Line 799: | Line 778: | ||
|- bgcolor="#cccccc" | |- bgcolor="#cccccc" | ||
!width="325px"|Directory | !width="325px"|Directory | ||
− | !width=" | + | !width="90px"|More info |
− | !width=" | + | !width="275px"|Path |
− | !width=" | + | !width="75px"|Data size |
− | !width="325px"|Used | + | !width="325px"|Used by? |
− | + | ||
− | + | ||
− | + | ||
|-valign="top" | |-valign="top" | ||
Line 815: | Line 791: | ||
|Only needed for the following inventories: | |Only needed for the following inventories: | ||
*HTAP | *HTAP | ||
− | *MIX | + | *MIX |
*XIAO_C3H8 | *XIAO_C3H8 | ||
Line 844: | Line 820: | ||
|15 MB | |15 MB | ||
|Not currently used, but is available for research needs | |Not currently used, but is available for research needs | ||
+ | |||
+ | |-valign="top" | ||
+ | |'''TIMEZONES''' | ||
+ | *Timezone offsets from UTC, needed to compute emissions that depend on local solar time | ||
+ | |[http://ftp.as.harvard.edu/gcgrid/data/ExtData/HEMCO/TIMEZONES/v2015-02/README README] | ||
+ | |<tt>$ROOT/TIMEZONES/v2015-02</tt> | ||
+ | |264 KB | ||
+ | |This data will always be read by HEMCO, regardless of simulation type | ||
|} | |} | ||
Line 857: | Line 841: | ||
!width="275px"|Path | !width="275px"|Path | ||
!width="75px"|Data size | !width="75px"|Data size | ||
− | !width="325px"|Used by | + | !width="325px"|Used by? |
|-valign="top" | |-valign="top" | ||
Line 942: | Line 926: | ||
|<tt>$$ROOT/POPs/v2015-08</tt> | |<tt>$$ROOT/POPs/v2015-08</tt> | ||
|809 MB | |809 MB | ||
− | |[[POPs simulation]] | + | | |
+ | *[[POPs simulation]] | ||
|-valign="top" | |-valign="top" |
Revision as of 22:57, 25 June 2021
On this page we describe the directory tree from which the HEMCO emissions component can read emissions inventories and other atmospheric data sets.
Contents
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 Compute Canada and AWS s3://gcgrid bucket. 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.
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:
GEOS-Chem versions | Recommended download method | Alternate download method |
---|---|---|
12.7.0 and later | The GEOS-Chem dry-run option | Manual download from either |
12.6.3 and prior | The hemco_data_download package | Manual download from either |
--Bob Yantosca (talk) 17:07, 3 December 2020 (UTC)
HEMCO data directories corresponding to an emissions option
The sections below describe each of the data directories corresponding to a HEMCO inventory or extension. These are grouped in the order in which they appear in the HEMCO_Config.rc version that ships with GEOS-Chem 13.0.0.
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 Default or optional? column contains this description
DEFAULT SETTING 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 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.
Regional inventories
Inventory | More info | Path | Data size | Default or Optional? |
---|---|---|---|---|
APEI
|
README | $ROOT/APEI/v2016-11/ | 68 MB | OPTIONAL SETTING |
NEI2011_HOURLY
|
README | $ROOT/NEI2011/v2015-03 | 248 GB | OPTIONAL SETTING |
NEI2011_MONTHLY_MEAN
|
README | $ROOT/NEI2011/v2017-02-MM | 248 GB | OPTIONAL SETTING |
MIX
|
README | $ROOT/MIX/v2015-03 | 623 MB | OPTIONAL SETTING |
DICE_Africa
|
README | $ROOT/DICE_Africa/v2016-10 | 202 MB | OPTIONAL SETTING |
Global inventories
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 | More info | Path | Data size | Default or Optional? |
---|---|---|---|---|
CEDS
|
README | $ROOT/CEDS/v2020-08 | 73 GB | DEFAULT SETTING |
CEDS_byFuelType
|
README | $ROOT/CEDS/v2020-08 | 73 GB | OPTIONAL SETTING |
EDGARv43
|
README | $ROOT/EDGARv43/v2016-11 | 6.2 GB | OPTIONAL SETTING |
HTAP
|
README | $ROOT/HTAP/v2015-03 | 4.5 GB | OPTIONAL SETTING |
GEIA_NH3
|
README | $ROOT/NH3/v2014-07 | 8.1 MB | DEFAULT SETTING |
SEABIRD_NH3
|
README | HEMCO/NH3/v2018-04/ | 104 MB | DEFAULT SETTING |
POET
|
README | $ROOT/POET/v2017-03/ | 38 MB | OPTIONAL SETTING |
TZOMPASOSA_C2H6
|
README | $ROOT/C2H6_2010/v2019-06 | 536 KB | DEFAULT SETTING |
XIAO_C3H8
|
README | $ROOT/XIAO/v2014-09 | 308 KB | DEFAULT SETTING |
LIANG_BROMOCARB
|
README | $ROOT/BROMINE/v2015-02 | 156 KB | DEFAULT SETTING |
ORDONEZ_IONOCARB
|
README | $ROOT/IODINE/v2017-09 | 4.4 MB | DEFAULT SETTING |
AEIC
|
README | $ROOT/AEIC/v2015-01 | 2.0 GB | DEFAULT SETTING |
DECAYING_PLANTS
|
README | $ROOT/ALD2/v2017-03 | 8.1 MB | DEFAULT SETTING |
AFCID
|
README | $ROOT/AFCID/2018-04 | 4.4 MB | DEFAULT SETTING |
Ship emissions
The following subdirectories of the HEMCO directory tree contain inventories of anthropogenic aircraft and ship emissions.
Inventory | More info | Path | Data size | Default or Optional? |
---|---|---|---|---|
CEDS_SHIP
|
README | $ROOT/CEDS/v2020-08 | 73 GB | DEFAULT SETTING |
CEDS_SHIP_byFuelType
|
README | $ROOT/CEDS/v2020-08 | 73 GB | OPTIONAL SETTING |
HTAP_SHIP
|
README | $ROOT/HTAP/v2015-03 | 4.5 GB | OPTIONAL SETTING |
ICOADS_SHIP
|
README | $ROOT/ICOADS_SHIP/v2014-07 | 4.2 MB | OPTIONAL SETTING |
ARCTAS_SHIP
|
README | $ROOT/ARCTAS_SHIP/v2014-07 | 508 KB | OPTIONAL SETTING |
CORBETT_SHIP
|
README | $ROOT/CORBETT_SHIP/v2014-07 | 1.8 MB | OPTIONAL SETTING |
NEI2011_SHIP
|
README | $ROOT/NEI2011/v2015-03 | 248 GB | OPTIONAL SETTING |
NEI2011_SHIP_MONMEAN
|
README | $ROOT/NEI2011/v2017-02-MM | 248 GB | OPTIONAL SETTING |
NOTES about ship emissions:
- CEDS ship emissions are the default ship inventory in 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: $ROOT/CEDS/v2018-04/.
- 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 land. They are therefore coastal emissions inventories and not global emissions inventories.
Future emissions
Inventory | More info | Path | Data size | Default or Optional? |
---|---|---|---|---|
RCP_3PD
|
README | $ROOT/RCP/v2020-07/RCP_3PD | 91 MB | OPTIONAL SETTING |
RCP_45
|
README | $ROOT/RCP/v2020-07/RCP_45 | 93 MB | OPTIONAL SETTING |
RCP_60
|
README | $ROOT/RCP/v2020-07/RCP_60 | 92 MB | OPTIONAL SETTING |
RCP_85
|
README | $ROOT/RCP/v2020-07/RCP_85 | 93 MB | OPTIONAL SETTING |
Biomass burning emissions (not implemented as extensions)
NOTE: Some biomass burning inventories are implemented as HEMCO extensions. See the Emissions implemented as HEMCO extensions below for more information.
The following subdirectories of the HEMCO directory tree contain inventories of biomass burning emissions.
Inventory | More info | Path | Data size | Default or Optional? |
---|---|---|---|---|
GFAS
|
README | $ROOT/GFAS/v2018-09 | 49 GB | OPTIONAL SETTING
|
QFED
|
README | $ROOT/QFED/v2018-07 | 247 GB | OPTIONAL SETTING |
Offline grid-independent emissions
Offline grid-independent emissions were generated by running high-resolution (0.25°x0.3125° for GEOS-FP, 0.5°x0.625° for MERRA-2) simulations using the HEMCO standalone and online emissions from the HEMCO extensions.
Inventory | More info | Path | Data size | Default or Optional? |
---|---|---|---|---|
OFFLINE_DUST
|
README | $ROOT/OFFLINE_DUST/v2019-01 | 18 GB | DEFAULT SETTING |
OFFLINE_BIOGENICVOC
|
README | $ROOT/OFFLINE_BIOVOC/v2019-01 | 1400 GB | DEFAULT SETTING |
OFFLINE_SEASALT
|
README | $ROOT/OFFLINE_SEASALT/v2019-01 | 876 GB | DEFAULT SETTING
|
OFFLINE_SOILNOX
|
README | $ROOT/OFFLINE_SOILNOX/v2019-01 | 48 GB | DEFAULT SETTING |
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 | More info | Path | Data size | Default or Optional? |
---|---|---|---|---|
UVALBEDO
|
README | $ROOT/UVALBEDO/v2019-06 | 476 KB | DEFAULT SETTING |
CCM_STRAT_Bry
|
README | $ROOT/STRAT/v2015-01/Bry | 385 MB | DEFAULT SETTING |
GMI_STRAT_OH
|
README | $ROOT/GMI/v2015-02 | 16 GB | DEFAULT SETTING |
GMI_PROD_LOSS
|
DEFAULT SETTING | |||
UCX_PROD_LOSS
|
README | $ROOT/UCX/v2018-02 | 12 GB | OPTIONAL SETTING |
OMOC_RATIO
|
README | $ROOT/OMOC/v2018-01 | 8.6 MB | OPTIONAL SETTING |
GMD_SFC_CH4
|
[1] | $ROOT/NOAA_GMD/v2018-01 | 85 MB | DEFAULT SETTING |
CMIP6_SFC_CH4
|
[2] | $ROOT/CMIP6/v2019-12 | 85 MB | OPTIONAL SETTING |
OLSON_LANDMAP
|
README | $ROOT/OLSON_MAP/v2019-02 | 1.9 MB | DEFAULT SETTING |
YUAN_MODIS_LAI
|
README | $ROOT/Yuan_XLAI/v2019-03 | 203 MB | DEFAULT SETTING |
RRTMG
|
README | $ROOT/RRTMG/v2018-11 | 19 MB | OPTIONAL SETTING |
SfcVMR
|
HEMCO/SfcFix/v2019-12 | 851 MB | DEFAULT SETTING | |
OCEAN_O3_DRYDEP
|
README | HEMCO/OCEAN_O3_DRYDEP/v2020-02 | 388 MB | 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.).
HEMCO Extension | More info | Path | Data size | Default or Optional? |
---|---|---|---|---|
SeaFlux
|
README1 README2 README3 |
$ROOT/ACET/v2014-07 $ROOT/ALD2/v2017-03 $ROOT/DMS/v2015-07 |
5.8 MB | DEFAULT SETTING |
ParaNOx
|
README | $ROOT/PARANOX/v2015-02 | 162 MB | DEFAULT SETTING |
LightNOx
|
README | $ROOT/LIGHTNOX/v2017-09 | 32 MB | DEFAULT SETTING |
SoilNOx
|
README | $ROOT/SOILNOX/v2014-07 | 730 MB | OPTIONAL SETTING |
DustDead
|
README | $ROOT/DUST_DEAD/2014-07 | 712 KB | OPTIONAL SETTING |
DustGinoux
|
README | $ROOT/DUST_GINOUX/2014-07 | 36 KB | OPTIONAL SETTING |
SeaSalt
|
Does not have an associated data directory | OPTIONAL SETTING | ||
MEGAN
|
README | $ROOT/MEGAN/v2018-05 | 12 MB | DEFAULT SETTING |
GFED4
|
README | $ROOT/GFED4/v2020-02 | 296 MB | DEFAULT SETTING |
FINN
|
README | $ROOT/FINN/v2015-02 | 1.2 GB | OPTIONAL SETTING |
DustAlk
|
Does not have an associated data directory. | OPTIONAL SETTING | ||
Volcano
|
README | $ROOT/VOLCANO/v2019-08 | 63 MB | DEFAULT SETTING |
Inorg_Iodine
|
Does not have an associated data directory. | DEFAULT SETTING |
Other HEMCO data directories
In each of the tables below:
- The Directory column contains a description of the directory and its contents.
- The More info column points to the README files that are stored with each data set.
- 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 Used by? column lists in which context the data in each directory is used.
HEMCO scale factors, masks, and other data
The following subdirectories of the HEMCO directory tree contain scale factors for various emissions inventories
Directory | More info | Path | Data size | Used by? |
---|---|---|---|---|
AnnualScalar
|
README | $ROOT/AnnualScalar/v2014-07 | 3.0 MB | Only needed for the following inventories:
|
NEI2005
|
README | $ROOT/NEI2005/v2014-09 | 8.1 MB | Only needed for the following inventories:
|
MASKS
|
README | $ROOT/MASKS/v2014-07 | 148 MB | Needed for regional emissions inventories |
COUNTRY_ID
|
README | $ROOT/COUNTRY_ID/v2015-04 | 15 MB | Not currently used, but is available for research needs |
TIMEZONES
|
README | $ROOT/TIMEZONES/v2015-02 | 264 KB | This data will always be read by HEMCO, regardless of simulation type |
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 (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.
Directory | More info | Path | Data size | Used by? |
---|---|---|---|---|
CH4
|
README1 README2 |
$ROOT/CH4/v2017-10 $ROOT/CH4/v2014-09 |
6.6 GB | |
CO2
|
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/ |
1.5 GB | |
CHLA
|
README | $ROOT/CHLA/v2014-07 | 2.0 MB | |
MERCURY
|
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 |
3.0 GB | |
O3
|
README | $ROOT/O3/v2014-09 | 130 MB | |
OFFLINE_AEROSOL
|
README | $ROOT/OFFLINE_AEROSOL/v2014-09 | 165 MB | |
OH
|
README1 README2 |
$ROOT/OH/v2014-09 $ROOT/OH/v2014-09/v5-07-08 $ROOT/OH/v2014-09/v7-02-03.GMI |
95 MB | |
OXIDANTS
|
README | $ROOT/OXIDANTS/v2014-07 | 32 MB | |
POPs
|
README | $$ROOT/POPs/v2015-08 | 809 MB | |
TAGGED_CO
|
README | $ROOT/TAGGED_CO/v2017-04 | 79 MB | |
TAGGED O3
|
README | $ROOT/TAGGED_O3/v2014-09 | 374 MB |
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:
--Bob Yantosca (talk) 22:24, 14 January 2020 (UTC)