|
|
(8 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.
| + | |
− | | + | |
− | === 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>.
| + | |
− | | + | |
− | === Disabling chemistry inputs ===
| + | |
− | | + | |
− | --> CHEMISTRY_INPUT : true
| + | |
− | | + | |
− | === 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 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
| + | |
− | | + | |
| | | |
| | | |
| ---- | | ---- |
| '''''[[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]]''''' |