Difference between revisions of "The HEMCO Config.rc file"
(→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 | + | 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]. | |
− | # ExtNr ExtName | + | For example, the default emissions settings for the fullchem simulation are: |
− | 0 Base | + | |
− | --> | + | ############################################################################### |
− | --> | + | ### BEGIN SECTION EXTENSION SWITCHES |
− | --> | + | ############################################################################### |
− | --> | + | # ExtNr ExtName on/off Species Years avail. |
− | --> | + | 0 Base : on * |
− | --> | + | # ----- MAIN SWITCHES ----------------------------------------- |
− | --> | + | --> EMISSIONS : true |
− | --> | + | --> METEOROLOGY : true # 1980-2020 |
− | --> HTAP | + | --> CHEMISTRY_INPUT : true |
− | --> | + | # ----- RESTART FIELDS ---------------------------------------- |
− | --> | + | --> GC_RESTART : true |
− | --> | + | --> STATE_PSC : true |
− | --> LIANG_BROMOCARB | + | --> HEMCO_RESTART : true |
− | --> | + | # ----- NESTED GRID FIELDS ------------------------------------ |
− | --> | + | --> GC_BCs : false # 1980-2020 |
− | --> | + | # ----- REGIONAL INVENTORIES ---------------------------------- |
− | --> SHIP : true | + | --> APEI : false # 1989-2014 |
− | --> | + | --> NEI2011_HOURLY : false # 2006-2013 |
− | --> | + | --> NEI2011_MONMEAN : false # 2006-2013 |
− | --> | + | --> MIX : false # 2008-2010 |
− | --> | + | --> DICE_Africa : false # 2013 |
− | --> RCP_3PD | + | # ----- GLOBAL INVENTORIES ------------------------------------ |
− | --> RCP_45 | + | --> CEDS : true # 1970-2017 |
− | --> RCP_60 | + | --> CEDS_byFuelType : false # 1970-2017 |
− | --> RCP_85 | + | --> EDGARv43 : false # 1970-2010 |
− | --> QFED2 : false | + | --> 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 | + | 100 Custom : off - |
− | 101 SeaFlux | + | 101 SeaFlux : on DMS/ACET/ALD2/MENO3/ETNO3/MOH |
− | 102 ParaNOx | + | 102 ParaNOx : on NO/NO2/O3/HNO3 |
− | --> LUT data format | + | --> LUT data format : nc |
− | --> LUT source dir | + | --> LUT source dir : $ROOT/PARANOX/v2015-02 |
− | 103 LightNOx | + | 103 LightNOx : on NO |
− | + | --> CDF table : $ROOT/LIGHTNOX/v2014-07/light_dist.ott2010.dat | |
− | --> CDF table | + | 104 SoilNOx : off NO |
− | 104 SoilNOx | + | --> Use fertilizer NOx : true |
− | --> Use fertilizer NOx: true | + | 105 DustDead : off DST1/DST2/DST3/DST4 |
− | 105 DustDead | + | 106 DustGinoux : off DST1/DST2/DST3/DST4 |
− | 106 DustGinoux | + | 107 SeaSalt : off SALA/SALC/SALACL/SALCCL/SALAAL/SALCAL/BrSALA/BrSALC/MOPO/MOPI |
− | + | --> SALA lower radius : 0.01 | |
− | + | --> SALA upper radius : 0.5 | |
− | --> SALA lower radius : 0.01 | + | --> SALC lower radius : 0.5 |
− | --> SALA upper radius : 0.5 | + | --> SALC upper radius : 8.0 |
− | --> SALC lower radius : 0.5 | + | --> Model sea salt Br- : true |
− | --> SALC upper radius : 8.0 | + | --> 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 | |
− | 108 MEGAN | + | --> CO2 conc (ppmv) : 390.0 |
− | --> Isoprene scaling | + | --> Isoprene to SOAP : 0.015 |
− | --> CO2 inhibition | + | --> Isoprene to SOAS : 0.015 |
− | --> CO2 conc (ppmv) | + | --> Monoterp to SOAP : 0.050 |
− | + | --> Monoterp to SOAS : 0.050 | |
− | + | --> Othrterp to SOAP : 0.050 | |
− | 111 GFED | + | --> 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 | + | --> GFED4 : true |
− | --> GFED_daily | + | --> GFED_daily : false |
− | --> GFED_3hourly | + | --> GFED_3hourly : false |
− | --> Scaling_CO | + | --> Scaling_CO : 1.05 |
− | + | --> Scaling_NAP : 2.75e-4 | |
− | + | --> hydrophilic BC : 0.2 | |
− | --> Scaling_NAP | + | --> hydrophilic OC : 0.5 |
− | --> hydrophilic BC | + | --> fraction POG1 : 0.49 |
− | --> hydrophilic OC | + | --> CO to SOAP : 0.013 |
− | --> fraction POG1 | + | --> GFED_subgrid_coag : false |
− | 114 FINN | + | #see the note near scale factor 281 for the source of this emis factor |
− | --> FINN_daily | + | 114 FINN : off NO/CO/ALK4/ACET/MEK/ALD2/PRPE/C3H8/CH2O/C2H6/SO2/NH3/BCPI/BCPO/OCPI/OCPO/GLYC/HAC/SOAP |
− | --> Scaling_CO | + | --> FINN_daily : false |
− | --> hydrophilic BC | + | --> Scaling_CO : 1.0 |
− | --> hydrophilic OC | + | --> 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: | If you would like to turn off NEI2011, simply change the <span style="color:red">true</span> in this line: | ||
Line 131: | Line 200: | ||
etc. | 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]]''''' |
Revision as of 16:24, 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
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.
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 true in this line:
--> NEI2011 : true
to false:
--> NEI2011 : false
And if you also wanted to turn off the MEGAN biogenic emissions, simply change the on in this line:
108 MEGAN : on ISOP/ACET/PRPE/C2H4/ALD2
to off:
108 MEGAN : off 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.