HEMCO_Config.rc

Like geoschem_config.yml, information about the HEMCO_Config.rc file is the same as for GEOS-Chem Classic with a few exceptions. Refer to the GEOS-Chem ReadTheDocs page for this file for more detailed information.

Some content of the HEMCO_Config.rc file is ignored by GCHP. This is because MAPL ExtData handles file input rather than HEMCO in GCHP.

Items at the top of the file that are ignored include:

  • ROOT data directory path

  • METDIR path

  • DiagnPrefix

  • DiagnFreq

  • Wildcard

The ROOT data directory and METDIR paths are instead specified by the symbolic links in the run directory. Unlike in GEOS-Chem Classic, diagnostic filename and frequency information are specified in HISTORY.rc. Also unlike GEOS-Chem Classic, emissions diagnostics in GCHP are output in the same way and with the same file format as other diagnostic collections in GCHP.

In the BASE EMISSIONS section and beyond, columns that are ignored include:

  • sourceFile

  • sourceVar

  • sourceTime

  • C/R/E

  • SrcDim

  • SrcUnit

GCHP uses NASA MAPL code to read and regrid input files. File path, variable name, and data frequency are specified in GCHP config file ExtData.rc. Input data dimensions and units are not needed since they are taken directly from the file during read.

Note that some GEOS-Chem simulations require that all species be present in the restart file. For GEOS-Chem Classic you can get around this by updating the C/R/E flags in HEMCO_Config.rc. In GCHP that part of HEMCO_Config.rc is not used. To configure your run to allow missing species in the restart file you instead need to flip a switch in config file setCommonRunSettings.sh. Search for string Require_Species_in_Restart in the file. If set to 1 it will require species, and if set to 0 it will not.

Also beware that one entry in HEMCO_Config.rc is changed when script setCommonRunSettings.sh is executed in the run script prior to running GCHP. The online dust mass tuning factor gets replaced by a value specific to your configured grid resolution.

One entry also gets propagated to another configuration file by setCommonRunSettings.sh. Lightning entries in ExtData.rc get commented or uncommented depending on whether lightning climatology is turned on in HEMCO_Config.rc.