Difference between revisions of "The HEMCO Config.rc file"
From Geos-chem
(→Enabling and disabling emissions) |
(→Enabling and disabling emissions) |
||
| Line 35: | Line 35: | ||
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. | 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. | + | 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 are: | For example, the default emissions settings for the fullchem simulation are: | ||
| Line 182: | Line 182: | ||
### END SECTION EXTENSION SWITCHES ### | ### END SECTION EXTENSION SWITCHES ### | ||
| − | + | === Disabling all emissions === | |
| − | + | All emissions can be turned off by changing | |
| − | + | --> EMISSIONS : true | |
| − | + | to | |
| − | + | --> EMISSIONS : false. | |
| − | + | === Disabling meteorology inputs === | |
| − | to | + | Because HEMCO is used to read in the meteorology fields for GEOS-Chem "Classic", you should leave: |
| − | + | --> METEOROLOGY : true | |
| − | + | although for testing (e.g. in the HEMCO standalone) this can be toggled off by changing <tt>true</tt> to </false</tt>. | |
| − | + | === Disabling chemistry inputs === | |
| + | |||
| + | --> CHEMISTRY_INPUT : true | ||
| + | |||
| + | === Disabling other emissions | ||
| + | |||
| + | 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 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 | ||
| + | |||
| + | == For more information === | ||
| + | |||
| + | For more information, please see the following wiki pages: | ||
| + | |||
| + | #[[The HEMCO User's Guide]] | ||
| + | #[[HEMCO data directories]] | ||
---- | ---- | ||
'''''[[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:34, 8 December 2020
Previous | Next | Getting Started with GEOS-Chem
- Minimum system requirements
- Installing required software
- Configuring your computational environment
- Downloading source code
- Downloading data directories
- Creating run directories
- Configuring runs
- Editing input.geos
- Editing HEMCO_Config.rc
- Editing HEMCO_Diagn.rc
- Editing HISTORY.rc and other configuration files
- Compiling
- Running
- Output files
- Visualizing and processing output
- Coding and debugging
- Further reading
Contents
Overview
In GEOS-Chem v10-01 and later versions, emissions are read, regridded, and calculated by the HEMCO emissions component. The emission settings are specified in the HEMCO Configuration file (HEMCO_Config.rc).
For more information about the HEMCO_Config.rc file, please see:
--Bob Yantosca (talk) 23:25, 16 November 2016 (UTC)
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 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 for testing (e.g. in the HEMCO standalone) this can be toggled off by changing true to </false</tt>.
Disabling chemistry inputs
--> CHEMISTRY_INPUT : true
=== Disabling other emissions
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
For more information =
For more information, please see the following wiki pages:
