The HEMCO Config.rc file

From Geos-chem
Revision as of 16:38, 8 December 2020 by Bmy (Talk | contribs) (Disabling chemistry inputs)

Jump to: navigation, search

Previous | Next | Getting Started with GEOS-Chem

  1. Minimum system requirements
  2. Installing required software
  3. Configuring your computational environment
  4. Downloading source code
  5. Downloading data directories
  6. Creating run directories
  7. Configuring runs
  8. Compiling
  9. Running
  10. Output files
  11. Visualizing and processing output
  12. Coding and debugging
  13. Further reading


Overview

The Harmonized Emissions Component (HEMCO) reads emissions, meteorology inputs, and various types of non-emissions data into GEOS-Chem. You can choose which of these types of data to include in your simulation by editing the HEMCO Configuration file (HEMCO_Config.rc) in your GEOS-Chem run directory.

For more information about the HEMCO_Config.rc file, please see:

  1. The HEMCO User's Guide
  2. HEMCO data directories
  3. HEMCO examples

Enabling and disabling emissions

The HEMCO_Config.rc file for each GEOS-Chem simulation contains a set of switches that allow you to quickly toggle individual emissions inventories on or off.

Each time you create a GEOS-Chem run directory, a new HEMCO_Config.rc file with default emissions settings will be created in the run directory. These default settings are located near the top of the HEMCO_Config.rc file. To see the HEMCO_Config.rc file that ships with the current version of GEOS-Chem, please follow this link.

Default emissions settings

For example, the default emissions settings for the fullchem simulation (in GEOS-Chem 13.0.0) are:

###############################################################################
### BEGIN SECTION EXTENSION SWITCHES
###############################################################################
# ExtNr ExtName                on/off  Species  Years avail.
0       Base                   : on    *           
# ----- MAIN SWITCHES -----------------------------------------
    --> EMISSIONS              :       true
    --> METEOROLOGY            :       true     # 1980-2020
    --> CHEMISTRY_INPUT        :       true
# ----- RESTART FIELDS ----------------------------------------
    --> GC_RESTART             :       true
    --> STATE_PSC              :       true
    --> HEMCO_RESTART          :       true
# ----- NESTED GRID FIELDS ------------------------------------
    --> GC_BCs                 :       false    # 1980-2020
# ----- REGIONAL INVENTORIES ----------------------------------
    --> APEI                   :       false    # 1989-2014
    --> NEI2011_HOURLY         :       false    # 2006-2013
    --> NEI2011_MONMEAN        :       false    # 2006-2013
    --> MIX                    :       false    # 2008-2010
    --> DICE_Africa            :       false    # 2013
# ----- GLOBAL INVENTORIES ------------------------------------
    --> CEDS                   :       true     # 1970-2017
    --> CEDS_byFuelType        :       false    # 1970-2017
    --> EDGARv43               :       false    # 1970-2010
    --> HTAP                   :       false    # 2008-2010
    --> GEIA_NH3               :       true     # 1990
    --> SEABIRD_NH3            :       true     # 1990
    --> POET_EOH               :       false    # 1985
    --> TZOMPASOSA_C2H6        :       true     # 2010
    --> XIAO_C3H8              :       true     # 1985
    --> LIANG_BROMOCARB        :       true     # 2000
    --> ORDONEZ_IODOCARB       :       true     # 2000
    --> AEIC                   :       true     # 2005
    --> DECAYING_PLANTS        :       true     # 1985
    --> AFCID                  :       true     # 2015
# ----- SHIP EMISSIONS ----------------------------------------
    --> SHIP                   :       true
    --> CEDS_SHIP              :       true     # 1970-2017
    --> CEDS_SHIP_byFuelType   :       false    # 1970-2017
    --> HTAP_SHIP              :       false    # 2008-2010
    --> ICOADS_SHIP            :       false    # 2002
    --> ARCTAS_SHIP            :       false    # 2008
    --> CORBETT_SHIP           :       false    # 1985
    --> NEI2011_SHIP_HOURLY    :       false    # 2006-2013
    --> NEI2011_SHIP_MONMEAN   :       false    # 2006-2013
# ----- FUTURE EMISSIONS --------------------------------------
    --> RCP_3PD                :       false    # 2005-2100
    --> RCP_45                 :       false    # 2005-2100
    --> RCP_60                 :       false    # 2005-2100
    --> RCP_85                 :       false    # 2005-2100
# ----- BIOMASS BURNING EMISSIONS -----------------------------
    --> QFED2                  :       false    # 2000-2020
    --> GFAS                   :       false    # 2003-2020
# ----- OFFLINE EMISSIONS -------------------------------------
# To use online emissions instead set the
# offline emissions to 'false' and the
# corresponding HEMCO extension to 'on':
#   OFFLINE_DUST        - DustDead or DustGinoux
#   OFFLINE_BIOGENICVOC - MEGAN
#    - Note: MEGAN must always be on for certain
#            species not in OFFLINE_BIOGENICVOC
#   OFFLINE_SEASALT     - SeaSalt
#   OFFLINE_SOILNOX     - SoilNOx
#--------------------------------------------------------------
    --> OFFLINE_DUST           :       true     # 1980-2020
    --> OFFLINE_BIOGENICVOC    :       true     # 1980-2020
    --> OFFLINE_SEASALT        :       true     # 1980-2020
    --> OFFLINE_SOILNOX        :       true     # 1980-2020
# ----- NON-EMISSIONS DATA ------------------------------------
    --> UVALBEDO               :       true     # 1985
    --> CCM_STRAT_Bry          :       true     # 2007
    --> GMI_STRAT_OH           :       true     # 2005
    --> GMI_PROD_LOSS          :       true     # 2005
    --> UCX_PROD_LOSS          :       false    # 2013   
    --> OMOC_RATIO             :       false    # 2010
    --> GMD_SFC_CH4            :       true     # 1979-2020
    --> CMIP6_SFC_CH4          :       false    # 1750-1978
    --> OLSON_LANDMAP          :       true     # 1985
    --> YUAN_MODIS_LAI         :       true     # 2005-2016
    --> RRTMG                  :       false    # 2002
    --> SfcVMR                 :       true     # 1750-2014
    --> OCEAN_O3_DRYDEP        :       true     # 1985
# -----------------------------------------------------------------------------
100     Custom                 : off   -
101     SeaFlux                : on    DMS/ACET/ALD2/MENO3/ETNO3/MOH
102     ParaNOx                : on    NO/NO2/O3/HNO3
    --> LUT data format        :       nc
    --> LUT source dir         :       $ROOT/PARANOX/v2015-02
103     LightNOx               : on    NO
    --> CDF table              :       $ROOT/LIGHTNOX/v2014-07/light_dist.ott2010.dat
104     SoilNOx                : off   NO
    --> Use fertilizer NOx     :       true
105     DustDead               : off   DST1/DST2/DST3/DST4
106     DustGinoux             : off   DST1/DST2/DST3/DST4
107     SeaSalt                : off   SALA/SALC/SALACL/SALCCL/SALAAL/SALCAL/BrSALA/BrSALC/MOPO/MOPI
    --> SALA lower radius      :       0.01
    --> SALA upper radius      :       0.5
    --> SALC lower radius      :       0.5
    --> SALC upper radius      :       8.0
    --> Model sea salt Br-     :       true
    --> Br- mass ratio         :       2.11e-3
108     MEGAN                  : on    ISOP/ACET/PRPE/C2H4/ALD2/MOH/EOH/MTPA/MTPO/LIMO/SESQ/SOAP/SOAS
    --> Isoprene scaling       :       1.0
    --> CO2 inhibition         :       true
    --> CO2 conc (ppmv)        :       390.0
    --> Isoprene to SOAP       :       0.015
    --> Isoprene to SOAS       :       0.015
    --> Monoterp to SOAP       :       0.050
    --> Monoterp to SOAS       :       0.050
    --> Othrterp to SOAP       :       0.050
    --> Othrterp to SOAS       :       0.050
111     GFED                   : on    NO/CO/ALK4/ACET/MEK/ALD2/PRPE/C3H8/CH2O/C2H6/SO2/NH3/BCPO/BCPI/OCPO/OCPI/POG1/POG2/MTPA/BENZ/TOLU/XYLE/NAP/EOH/MOH/SOAP
    --> GFED4                  :       true
    --> GFED_daily             :       false
    --> GFED_3hourly           :       false
    --> Scaling_CO             :       1.05
    --> Scaling_NAP            :       2.75e-4
    --> hydrophilic BC         :       0.2
    --> hydrophilic OC         :       0.5
    --> fraction POG1          :       0.49
    --> CO to SOAP             :       0.013
    --> GFED_subgrid_coag      :       false
#see the note near scale factor 281 for the source of this emis factor
114     FINN                   : off   NO/CO/ALK4/ACET/MEK/ALD2/PRPE/C3H8/CH2O/C2H6/SO2/NH3/BCPI/BCPO/OCPI/OCPO/GLYC/HAC/SOAP
    --> FINN_daily             :       false
    --> Scaling_CO             :       1.0
    --> Scaling_SOAP           :       0.013
    --> hydrophilic BC         :       0.2
    --> hydrophilic OC         :       0.5
    --> FINN_subgrid_coag      :       false
115     DustAlk                : off   DSTAL1/DSTAL2/DSTAL3/DSTAL4
117     Volcano                : on    SO2
    --> Volcano_Source         :       AeroCom
    --> Volcano_Table          :       $ROOT/VOLCANO/v2019-08/$YYYY/$MM/so2_volcanic_emissions_Carns.$YYYY$MM$DD.rc
120     Inorg_Iodine           : on    HOI/I2
    --> Emit HOI               :       true
    --> Emit I2                :       true
130     TOMAS_Jeagle           : off   SS1/SS2/SS3/SS4/SS5/SS6/SS7/SS8/SS9/SS10/SS11/SS12/SS13/SS14/SS15/SS16/SS17/SS18/SS19/SS20/SS21/SS22/SS23/SS24/SS25/SS26/SS27/SS28/SS29/SS30/SS31/SS32/SS33/SS34/SS35/SS36/SS37/SS38/SS39/SS40
### END SECTION EXTENSION SWITCHES ###

Disabling all emissions

All emissions can be turned off by changing

--> EMISSIONS              :       true

to

--> EMISSIONS              :       false.

Disabling meteorology inputs

Because HEMCO is used to read in the meteorology fields for GEOS-Chem "Classic", you should leave:

    --> METEOROLOGY            :       true 

although this can be turned off (for testing purposes, etc.) by changing true to </false</tt>.

Disabling chemistry inputs

    --> CHEMISTRY_INPUT        :       true

Disabling individual emissions inventories

Base emissions can be toggled on/off by placing true or false after the semicolon that follows the inventory name. For example, this will turn off CEDS emissions:

     --> CEDS                   :       false     # 1970-2017

Emissions implemented as HEMCO extensions can be toggled on/off by placing on/tt> or <tt>off after the semicolon that follows the name of the extension. For example, this will turn off the HEMCO SeaFlux extension (which handles sea-to-air exchange of certain species):

 101     SeaFlux                : off   DMS/ACET/ALD2/MENO3/ETNO3/MOH



Previous | Next | Getting Started with GEOS-Chem