Difference between revisions of "The HEMCO Config.rc file"

From Geos-chem
Jump to: navigation, search
(Enabling/disabling individual emissions inventories)
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
__FORCETOC__
 
__FORCETOC__
 
'''''[[The input.geos file|Previous]] | [[The HEMCO_Diagn.rc file|Next]] | [[Getting Started with GEOS-Chem]]'''''
 
'''''[[The input.geos file|Previous]] | [[The HEMCO_Diagn.rc file|Next]] | [[Getting Started with GEOS-Chem]]'''''
#[[Minimum system requirements for GEOS-Chem|Minimum system requirements]]
+
#[[Minimum system requirements for GEOS-Chem|Minimum system requirements (and software installation)]]
#[[Installing required software]]
+
 
#[[Configuring your computational environment]]
 
#[[Configuring your computational environment]]
 
#[[Downloading GEOS-Chem source code|Downloading source code]]
 
#[[Downloading GEOS-Chem source code|Downloading source code]]
Line 15: Line 14:
 
#[[Running GEOS-Chem|Running]]
 
#[[Running GEOS-Chem|Running]]
 
#[[GEOS-Chem output files|Output files]]
 
#[[GEOS-Chem output files|Output files]]
#[[Guide_to_visualization_and_analysis_tools_for_GEOS-Chem|Visualizing and processing output]]
+
#[[Python tools for use with GEOS-Chem]]
 
#[[GEOS-Chem_coding_and_debugging|Coding and debugging]]
 
#[[GEOS-Chem_coding_and_debugging|Coding and debugging]]
 
#[[GEOS-Chem_overview#Further_reading|Further reading]]
 
#[[GEOS-Chem_overview#Further_reading|Further reading]]
  
  
== Overview ==
+
This content has been migrated to the [https://geos-chem.readthedocs.io/en/latest/gcc-guide/03-config/hemco-config.html '''HEMCO_Config.rc''' chapter of <tt>geos-chem.readthedocs.io</tt>].
 
+
The [[HEMCO|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 (<tt>HEMCO_Config.rc</tt>) in your GEOS-Chem run directory.
+
 
+
For more information about the <tt>HEMCO_Config.rc</tt> file, please see:
+
 
+
#[[The HEMCO User's Guide]]
+
#[[HEMCO data directories]]
+
#[[HEMCO examples]]
+
 
+
== Enabling and disabling emissions ==
+
 
+
The <tt>HEMCO_Config.rc</tt> 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 [[Creating GEOS-Chem run directories|create a GEOS-Chem run directory]], a new <tt>HEMCO_Config.rc</tt> file with default emissions settings will be created in the run directory.  These default settings are located near the top of the <tt>HEMCO_Config.rc</tt> file.  To see the HEMCO_Config.rc file that ships with the current version of GEOS-Chem, [https://github.com/geoschem/geos-chem/blob/dev/13.0.0/run/GCClassic/HEMCO_Config.rc.templates/HEMCO_Config.rc.fullchem 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 ###
+
 
+
=== Enabling/disabling all emissions ===
+
 
+
All emissions can be turned off by changing
+
 
+
--> EMISSIONS              :      true
+
 
+
to
+
 
+
--> EMISSIONS              :      false
+
 
+
which can be convienient if you are debugging a problem.
+
 
+
=== Enabling/disabling other inputs ===
+
 
+
Because HEMCO is used to read in the meteorology fields as well as non-emissions chemistry input data (such as prod/loss rates, etc.), you should leave:
+
 
+
    --> METEOROLOGY            :      true
+
    --> CHEMISTRY_INPUT        :      true
+
 
+
For testing or debugging purposes you can toggle these off by changing <tt>true</tt> to </false</tt>.
+
 
+
=== Enabling/disabling individual emissions inventories ===
+
 
+
Base emissions can be toggled on/off by placing <tt>true</tt> or <tt>false</tt> 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 <tt>on</tt> or <tt>off</tt> after the semicolon that follows the extension's name.  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
+
 
+
etc.
+
  
  
 
----
 
----
 
'''''[[The input.geos file|Previous]] | [[The HEMCO_Diagn.rc file|Next]] | [[Getting Started with GEOS-Chem]]'''''
 
'''''[[The input.geos file|Previous]] | [[The HEMCO_Diagn.rc file|Next]] | [[Getting Started with GEOS-Chem]]'''''

Revision as of 16:43, 4 August 2022

Previous | Next | Getting Started with GEOS-Chem

  1. Minimum system requirements (and software installation)
  2. Configuring your computational environment
  3. Downloading source code
  4. Downloading data directories
  5. Creating run directories
  6. Configuring runs
  7. Compiling
  8. Running
  9. Output files
  10. Python tools for use with GEOS-Chem
  11. Coding and debugging
  12. Further reading


This content has been migrated to the HEMCO_Config.rc chapter of geos-chem.readthedocs.io.



Previous | Next | Getting Started with GEOS-Chem