Revert GFED to the default biomass burning option

run/shared/settings/gcap2_hemco.txt
run/shared/settings/gmao_hemco.txt
- Changed RUNDIR_GFED_EXT from "off" to "on "
- Changed RUNDIR_GFAS from "true " to "false"

run/CESM/HEMCO_Config.rc
run/WRF/fullchem/HEMCO_Config.rc
- Turn off GFAS and turn on GFED4

Added documentation with instructions on how to set ExtNr, Cat, Hier
when switching between offline & online emissions in:
- run/GCClassic/HEMCO_Diagn.rc.templates/HEMCO_Diagn.rc.aerosol
- run/GCClassic/HEMCO_Diagn.rc.templates/HEMCO_Diagn.rc.aerosol.onlineE
- run/GCClassic/HEMCO_Diagn.rc.templates/HEMCO_Diagn.rc.carbon
- run/GCClassic/HEMCO_Diagn.rc.templates/HEMCO_Diagn.rc.fullchem
- run/GCClassic/HEMCO_Diagn.rc.templates/HEMCO_Diagn.rc.fullchem.onlineE
- run/GCClassic/HEMCO_Diagn.rc.templates/HEMCO_Diagn.rc
- run/GCClassic/HEMCO_Diagn.rc.templates/HEMCO_Diagn.rc
- run/GCClassic/HEMCO_Diagn.rc.templates/HEMCO_Diagn.rc.carbon
- run/GCClassic/HEMCO_Diagn.rc.templates/HEMCO_Diagn.rc.fullchem
- run/WRF/fullchem/HEMCO_Diagn.rc

Also removed revision history from documentation headers in these files:
- run/GCClassic/HEMCO_Diagn.rc.templates/HEMCO_Diagn.rc.metals
- run/GCClassic/HEMCO_Diagn.rc.templates/HEMCO_Diagn.rc.POPs
- run/GCClassic/HEMCO_Diagn.rc.templates/HEMCO_Diagn.rc.tagO3
- run/GCClassic/HEMCO_Diagn.rc.templates/HEMCO_Diagn.rc.TransportTracers
- run/GCHP/HEMCO_Diagn.rc.templates/HEMCO_Diagn.rc.TransportTracers

CHANGELOG.md
- Updated accordingly

Signed-off-by: Bob Yantosca <yantosca@seas.harvard.edu>

Author: yantosca

CHANGELOG.md

@@ -17,6 +17,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 - Added GCHP utility script extractPerformance.sh to scrape allPEs.log for timing summary in GCHP run directories
 - Added GCHP build scripts to GCHP runScriptSamples for Harvard
 - Added 3D GFAS emission entries in `HEMCO_Config.rc` and `ExtData.rc` (including emission factors for species only in GFED4)
+- Added documentation about switching from online to offline emissions in `HEMCO_Diagn.rc` template files
 
 ### Changed
 - Renamed `State_Chm%Isorrop*` fields to `State_Chm%Ate*` (aerosol thermodynamical equilibrium), as ISORROPIA is no longer used
@@ -29,7 +30,6 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 - Changed C-preprocessor switch `MODEL_` to `MODEL_EXTERNAL`, and `ESMF_` to `USE_ESMF`
 - Changed default fire emission inventory to GFAS
 - Changed default fire emission inventory from GFED to GFAS
-- Updated ExtNr and Cat for biomass burning entries in template `HEMCO_Diagn.rc` files
 
 ### Fixed
 - Fixed incorrect variable names and removed unused variables in `NcdfUtil/ncdf_mod.F90`

run/CESM/HEMCO_Config.rc

@@ -127,7 +127,7 @@ VerboseOnCores:              root       # Accepted values: root all
     --> CMIP6_SHIP             :       false    # 1850-2100
 # ----- BIOMASS BURNING EMISSIONS ---------------------------------------------
     --> QFED2                  :       false    # 2000-2020
-    --> GFAS                   :       true     # 2003-2025
+    --> GFAS                   :       false    # 2003-2025
     --> BB4MIPS                :       false    # 1850-2100
     --> GFED4_CLIMATOLOGY      :       false    # If true, turn off GFED ext below
 # ----- OFFLINE EMISSIONS -----------------------------------------------------
@@ -200,7 +200,7 @@ VerboseOnCores:              root       # Accepted values: root all
     --> Othrterp to SOAS       :       0.050
 # For CESM: (1) use bc_a4 and pom_a4 instead of BCPO, BCPI, OCPO, and OCPI in GFED, and
 # (2) add scaling for bc_a4 and pom_a4
-111     GFED                   : off    NO/CO/ALK4/ACET/MEK/ALD2/PRPE/C2H2/C2H4/C3H8/CH2O/C2H6/SO2/NH3/bc_a4/pom_a4/POG1/POG2/MTPA/BENZ/TOLU/XYLE/NAP/EOH/MOH/SOAP/FURA/PHEN/MVK/ISOP/ACTA/MGLY/GLYX/RCHO/HCOOH/ACR/STYR/C4H6
+111     GFED                   : on    NO/CO/ALK4/ACET/MEK/ALD2/PRPE/C2H2/C2H4/C3H8/CH2O/C2H6/SO2/NH3/bc_a4/pom_a4/POG1/POG2/MTPA/BENZ/TOLU/XYLE/NAP/EOH/MOH/SOAP/FURA/PHEN/MVK/ISOP/ACTA/MGLY/GLYX/RCHO/HCOOH/ACR/STYR/C4H6
     --> GFED4                  :       true
     --> GFED_daily             :       false
     --> GFED_3hourly           :       false

run/GCClassic/HEMCO_Diagn.rc.templates/HEMCO_Diagn.rc.POPs

@@ -11,9 +11,6 @@
 #\\
 # !REMARKS:
 #  For more information about HEMCO diagnostics, see hemco.readthedocs.io.
-#
-# !REVISION HISTORY:
-#  13 Mar 2019 - M. Sulprizio- Initial version
 #EOP
 #------------------------------------------------------------------------------
 #BOC

run/GCClassic/HEMCO_Diagn.rc.templates/HEMCO_Diagn.rc.TransportTracers

@@ -11,9 +11,6 @@
 #\\
 # !REMARKS:
 #  For more information about HEMCO diagnostics, see hemco.readthedocs.io.
-#
-# !REVISION HISTORY:
-#  13 Feb 2018 - E. Lundgren - Initial version
 #EOP
 #------------------------------------------------------------------------------
 #BOC

run/GCClassic/HEMCO_Diagn.rc.templates/HEMCO_Diagn.rc.aerosol

@@ -12,14 +12,28 @@
 # !REMARKS:
 #  For more information about HEMCO diagnostics, see hemco.readthedocs.io.
 #
-#  NOTES FOR BIOMASS BURNING:
-#  1. For GFED extension,    set ExtNr = 111, Cat = -1, Hier = -1.
-#  2. For offline emissions, set ExtNr = 0,   Cat =  5, Hier = -1
+#  ATTENTION!  If you switch between online and offline emissions, you
+#  will need to adjust the following diagnostic entries as described here:
 #
-# !REVISION HISTORY:
-#  13 Feb 2018 - E. Lundgren - Initial version
-#  30 Jan 2019 - R. Yantosca - Changed units to kg/m2/s
-#  08 Feb 2019 - R. Yantosca - Validated that all sectors sum to the total
+#  Biogenic emissions (Emis*_Biogenic)
+#  ------------------------------------------------------------------------
+#  1. If using MEGAN extension        : set ExtNr = 108, Cat = -1, Hier = -1
+#  2. If using OFFLINE_BIOGENICVOC    : set ExtNr = 0,   Cat = 4,  Hier = -1
+#
+#  Biomass emissions (Emis*_BioBurn)
+#  -------------------------------------------------------------------------
+#  1. If using GFED extension         : set ExtNr = 111, Cat = -1, Hier = -1
+#  2. If using GFAS, FINNv25, FINNv25 : set ExtNr = 0,   Cat =  5, Hier = -1
+#
+#  Dust emissions(EmisDSTbin*_Natural)
+#  -------------------------------------------------------------------------
+#  1. If using DustL23M extension     : set ExtNr = 125, Cat = -1, Hier = -1
+#  2. If using OFFLINE_DUST           : set ExtNr = 0,   Cat = 3,  Hier = -1
+#
+#  Sea salt emissions (Emis*SAL*_Natural)
+#  -------------------------------------------------------------------------
+#  1. If using SeaSalt extension      : set ExtNr = 107, Cat = -1, Hier = -1
+#  2. If using OFFLINE_SEASALT        : set ExtNr = 0,   Cat = 3,  Hier = -1 
 #EOP
 #------------------------------------------------------------------------------
 #BOC
@@ -31,7 +45,7 @@
 EmisBCPI_Total     BCPI   -1     -1  -1   3   kg/m2/s  BCPI_emission_flux_from_all_sectors
 EmisBCPI_Aircraft  BCPI   0      20  -1   3   kg/m2/s  BCPI_emission_flux_from_aircraft
 EmisBCPI_Anthro    BCPI   0      1   -1   3   kg/m2/s  BCPI_emission_flux_from_anthropogenic
-EmisBCPI_BioBurn   BCPI   0      5   -1   2   kg/m2/s  BCPI_emission_flux_from_biomass_burning
+EmisBCPI_BioBurn   BCPI   111    -1  -1   2   kg/m2/s  BCPI_emission_flux_from_biomass_burning
 EmisBCPI_Ship      BCPI   0      10  -1   2   kg/m2/s  BCPI_emission_flux_from_ships
 EmisBCPO_Total     BCPO   -1     -1  -1   3   kg/m2/s  BCPO_emission_flux_from_all_sectors
 EmisBCPO_Anthro    BCPO   0      1   -1   3   kg/m2/s  BCPO_emission_flux_from_anthropogenic
@@ -74,7 +88,7 @@ EmisLIMO_Biogenic  LIMO   0      3    -1   2   kg/m2/s  LIMO_emission_flux_from_
 #####  MTPA emissions                                                     #####
 ###############################################################################
 EmisMTPA_Total     MTPA   -1     -1  -1   3   kg/m2/s  MTPA_emission_flux_from_all_sectors
-EmisMTPA_BioBurn   MTPA   0      5   -1   2   kg/m2/s  MTPA_emission_flux_from_biomass_burning
+EmisMTPA_BioBurn   MTPA   111    -1  -1   2   kg/m2/s  MTPA_emission_flux_from_biomass_burning
 EmisMTPA_Biogenic  MTPA   0      3   -1   2   kg/m2/s  MTPA_emission_flux_from_biogenic_sources
 
 ###############################################################################
@@ -87,7 +101,7 @@ EmisMTPO_Biogenic  MTPO   0      3   -1   2   kg/m2/s  MTPO_emission_flux_from_b
 ###############################################################################
 EmisNH3_Total      NH3    -1     -1  -1   3   kg/m2/s  NH3_emission_flux_from_all_sectors
 EmisNH3_Anthro     NH3    0      1   -1   3   kg/m2/s  NH3_emission_flux_from_anthropogenic
-EmisNH3_BioBurn    NH3    0      5   -1   2   kg/m2/s  NH3_emission_flux_from_biomass_burning
+EmisNH3_BioBurn    NH3    111    -1  -1   2   kg/m2/s  NH3_emission_flux_from_biomass_burning
 EmisNH3_Natural    NH3    0      3   -1   2   kg/m2/s  NH3_emission_flux_from_natural_sources
 EmisNH3_Seabirds   NH3    0      30  -1   2   kg/m2/s  NH3_emission_flux_from_seabirds
 EmisNH3_Ship       NH3    0      10  -1   2   kg/m2/s  NH3_emission_flux_from_ships
@@ -98,19 +112,19 @@ EmisNH3_Ship       NH3    0      10  -1   2   kg/m2/s  NH3_emission_flux_from_sh
 EmisOCPI_Total     OCPI   -1     -1  -1   3   kg/m2/s  OCPI_emission_flux_from_all_sectors
 EmisOCPI_Aircraft  OCPI   0      20  -1   3   kg/m2/s  OCPI_emission_flux_from_aircraft
 EmisOCPI_Anthro    OCPI   0      1   -1   3   kg/m2/s  OCPI_emission_flux_from_anthropogenic
-EmisOCPI_BioBurn   OCPI   0      5  -1   2   kg/m2/s  OCPI_emission_flux_from_biomass_burning
+EmisOCPI_BioBurn   OCPI   111    -1 -1   2   kg/m2/s  OCPI_emission_flux_from_biomass_burning
 EmisOCPI_Ship      OCPI   0      10  -1   2   kg/m2/s  OCPI_emission_flux_from_ships
 EmisOCPO_Total     OCPO   -1     -1  -1   3   kg/m2/s  OCPO_emission_flux_from_all_sectors
 EmisOCPO_Anthro    OCPO   0      1   -1   3   kg/m2/s  OCPO_emission_flux_from_anthropogenic
-EmisOCPO_BioBurn   OCPO   0      5   -1   2   kg/m2/s  OCPO_emission_flux_from_biomass_burning
+EmisOCPO_BioBurn   OCPO   111    -1  -1   2   kg/m2/s  OCPO_emission_flux_from_biomass_burning
 EmisOCPO_Ship      OCPO   0      10  -1   2   kg/m2/s  OCPO_emission_flux_from_ships
 
 ###############################################################################
 #####  pFe emissions                                                      ##### 
 ###############################################################################
 EmispFe_Total      pFe    -1     -1  -1   3   kg/m2/s  pFe_emission_flux_from_all_sectors
 EmispFe_Anthro     pFe    0      1   -1   3   kg/m2/s  pFe_emission_flux_from_anthropogenic
-EmispFe_BioBurn    pFe    0      5   -1   2   kg/m2/s  pFe_emission_flux_from_GFED_inventory
+EmispFe_BioBurn    pFe    111    -1  -1   2   kg/m2/s  pFe_emission_flux_from_GFED_inventory
 EmispFe_Ship       pFe    0      10  -1   2   kg/m2/s  pFe_emission_flux_from_ships
 
 ###############################################################################
@@ -135,7 +149,7 @@ EmisSALCCL_Natural  SALCCL 0      3   -1   2   kg/m2/s  SALCCL_emission_flux_fro
 EmisSO2_Total      SO2    -1     -1  -1   3   kg/m2/s  SO2_emission_flux_from_all_sectors
 EmisSO2_Aircraft   SO2    0      20  -1   3   kg/m2/s  SO2_emission_flux_from_aircraft
 EmisSO2_Anthro     SO2    0      1   -1   3   kg/m2/s  SO2_emission_flux_from_anthropogenic
-EmisSO2_BioBurn    SO2    0      5   -1   2   kg/m2/s  SO2_emission_flux_from_biomass_burning
+EmisSO2_BioBurn    SO2    111    -1  -1   2   kg/m2/s  SO2_emission_flux_from_biomass_burning
 EmisSO2_VolcErupt  SO2    117    51  -1   3   kg/m2/s  SO2_emission_flux_from_eruptive_volcano
 EmisSO2_VolcDegas  SO2    117    52  -1   3   kg/m2/s  SO2_emission_flux_from_noneruptive_volcano
 EmisSO2_Ship       SO2    0      10  -1   2   kg/m2/s  SO2_emission_flux_from_ships
@@ -155,7 +169,7 @@ EmisSOAP_Total     SOAP   -1     -1  -1   3   kg/m2/s  SOAP_emission_flux_from_a
 EmisSOAP_Aircraft  SOAP   0      20  -1   3   kg/m2/s  SOAP_emission_flux_from_aircraft
 EmisSOAP_Anthro    SOAP   0      1   -1   3   kg/m2/s  SOAP_emission_flux_from_anthropogenic
 EmisSOAP_Biogenic  SOAP   0      3   -1   2   kg/m2/s  SOAP_emission_flux_from_monoterpenes
-EmisSOAP_BioBurn   SOAP   0      5   -1   2   kg/m2/s  SOAP_emission_flux_from_biomass_burning
+EmisSOAP_BioBurn   SOAP   111    -1  -1   2   kg/m2/s  SOAP_emission_flux_from_biomass_burning
 EmisSOAP_Ship      SOAP   0      10  -1   2   kg/m2/s  SOAP_emission_flux_from_ships
 
 ###############################################################################

run/GCClassic/HEMCO_Diagn.rc.templates/HEMCO_Diagn.rc.aerosol.onlineE

@@ -12,14 +12,28 @@
 # !REMARKS:
 #  For more information about HEMCO diagnostics, see hemco.readthedocs.io.
 #
-#  NOTES FOR BIOMASS BURNING:
-#  1. For GFED extension,    set ExtNr = 111, Cat = -1, Hier = -1.
-#  2. For offline emissions, set ExtNr = 0,   Cat =  5, Hier = -1
+#  ATTENTION!  If you switch between online and offline emissions, you
+#  will need to adjust the following diagnostic entries as described here:
 #
-# !REVISION HISTORY:
-#  13 Feb 2018 - E. Lundgren - Initial version
-#  30 Jan 2019 - R. Yantosca - Changed units to kg/m2/s
-#  08 Feb 2019 - R. Yantosca - Validated that all sectors sum to the total
+#  Biogenic emissions (Emis*_Biogenic)
+#  ------------------------------------------------------------------------
+#  1. If using MEGAN extension        : set ExtNr = 108, Cat = -1, Hier = -1
+#  2. If using OFFLINE_BIOGENICVOC    : set ExtNr = 0,   Cat = 4,  Hier = -1
+#
+#  Biomass emissions (Emis*_BioBurn)
+#  -------------------------------------------------------------------------
+#  1. If using GFED extension         : set ExtNr = 111, Cat = -1, Hier = -1
+#  2. If using GFAS, FINNv25, FINNv25 : set ExtNr = 0,   Cat =  5, Hier = -1
+#
+#  Dust emissions(EmisDSTbin*_Natural)
+#  -------------------------------------------------------------------------
+#  1. If using DustL23M extension     : set ExtNr = 125, Cat = -1, Hier = -1
+#  2. If using OFFLINE_DUST           : set ExtNr = 0,   Cat = 3,  Hier = -1
+#
+#  Sea salt emissions (Emis*SAL*_Natural)
+#  -------------------------------------------------------------------------
+#  1. If using SeaSalt extension      : set ExtNr = 107, Cat = -1, Hier = -1
+#  2. If using OFFLINE_SEASALT        : set ExtNr = 0,   Cat = 3,  Hier = -1 
 #EOP
 #------------------------------------------------------------------------------
 #BOC

run/GCClassic/HEMCO_Diagn.rc.templates/HEMCO_Diagn.rc.carbon

@@ -12,9 +12,13 @@
 # !REMARKS:
 #  For more information about HEMCO diagnostics, see hemco.readthedocs.io.
 #
-#  NOTES FOR BIOMASS BURNING:
-#  1. For GFED extension,    set ExtNr = 111, Cat = -1, Hier = -1.
-#  2. For offline emissions, set ExtNr = 0,   Cat =  5, Hier = -1
+#  ATTENTION!  If you switch between online and offline emissions, you
+#  will need to adjust the following diagnostic entries as described here:
+#
+#  Biomass emissions (Emis*_BiomassBurn)
+#  -------------------------------------------------------------------------
+#  1. If using GFED extension         : set ExtNr = 111, Cat = -1, Hier = -1
+#  2. If using GFAS, FINNv25, FINNv25 : set ExtNr = 0,   Cat =  5, Hier = -1
 #EOP
 #------------------------------------------------------------------------------
 #BOC