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

From Geos-chem
Jump to: navigation, search
(Enabling and disabling emissions)
 
(19 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>].
  
In [[GEOS-Chem v10-01]] and later versions, emissions are read, regridded, and calculated by the [[HEMCO|HEMCO emissions component]]. The emission settings are specified in the HEMCO Configuration file (<tt>HEMCO_Config.rc</tt>).
 
 
For more information about the <tt>HEMCO_Config.rc</tt> file, please see:
 
 
*[[The HEMCO User's Guide]]
 
*[[HEMCO examples]]
 
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 23:25, 16 November 2016 (UTC)
 
 
== 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].
 
 
For example, the default emissions settings for the fullchem simulation 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 ###
 
 
If you would like to turn off NEI2011, simply change the <span style="color:red">true</span> in this line:
 
 
      --> NEI2011          :      <span style="color:red">true</span>
 
 
to <span style="color:green">false</span>:
 
 
      --> NEI2011          :      <span style="color:green">false</span>
 
 
And if you also wanted to turn off the MEGAN biogenic emissions, simply change the <span style="color:red">on</span> in this line:
 
 
108    MEGAN            : <span style="color:red">on</span>    ISOP/ACET/PRPE/C2H4/ALD2
 
 
to <span style="color:green">off</span>:
 
 
108    MEGAN            : <span style="color:green">off</span>    ISOP/ACET/PRPE/C2H4/ALD2
 
 
etc.
 
 
For more information about the available inventories that you can use with HEMCO, please see our ''[[HEMCO data directories]]'' wiki page.
 
  
 
----
 
----
 
'''''[[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]]'''''

Latest 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