Difference between revisions of "The HEMCO Diagn.rc file"

From Geos-chem
Jump to: navigation, search
Line 20: Line 20:
  
  
== Overview ==
+
This content has been migrated to the [https://geos-chem.readthedocs.io/en/latest/gcc-guide/03-config/hemco-diagn.html '''HEMCO_Diagn.rc''' chapter of <tt>geos-chem.readthedocs.io</tt>].
 
+
You can archive any type of emissions (or other quantity) computed by the [[HEMCO|HEMCO emissions component]] to netCDF-format diagnostic output.  The <tt>HEMCO_Diagn.rc</tt> file [[The_HEMCO_User's_Guide#Diagnostics_input_file|controls diagnostic output options]] for HEMCO.
+
 
+
You can see the <tt>HEMCO_Diagn.rc</tt> file that ships with GEOS-Chem 13.0.0 by [https://github.com/geoschem/geos-chem/blob/dev/13.0.0/run/GCClassic/HEMCO_Diagn.rc.templates/HEMCO_Diagn.rc.fullchem following this link].
+
 
+
== Sample HEMCO_Diagn.rc file ==
+
 
+
Here is a snapshot of the <tt>HEMCO_Config.rc</tt> for the GEOS-Chem fullchem simulation run directory.
+
 
+
#------------------------------------------------------------------------------
+
#                  GEOS-Chem Global Chemical Transport Model                  !
+
#------------------------------------------------------------------------------
+
#BOP
+
#
+
# !MODULE: HEMCO_Diagn.rc
+
#
+
# !DESCRIPTION: Configuration file for netCDF diagnostic output from HEMCO.
+
#\\
+
#\\
+
# !REMARKS:
+
#  Customized for the benchmark simulation.
+
#  TO DO: Add long names, which are used for netCDF variable attributes.
+
#
+
# !REVISION HISTORY:
+
#  13 Feb 2018 - E. Lundgren - Initial version
+
#EOP
+
#------------------------------------------------------------------------------
+
#BOC
+
# Name            Spec  ExtNr  Cat Hier Dim OutUnit      LongName
+
+
###############################################################################
+
#####  ACET emissions (in bpch ND11, ND28, ND34, ND36, ND46)            #####
+
###############################################################################
+
EmisACET_Total    ACET  -1    -1  -1  3  molec/cm2/s 
+
EmisACET_Anthro    ACET  0      1  -1  3  atomsC/cm2/s
+
EmisACET_BioBurn  ACET  111    -1  -1  2  atomsC/cm2/s
+
EmisACET_Biofuel  ACET  0      2  -1  2  atomsC/cm2/s
+
EmisACET_Biogenic  ACET  108    -1  -1  2  atomsC/cm2/s
+
EmisACET_DirectBio ACET  108    -1  -1  2  atomsC/cm2/s ACET_from_direct_emissions
+
EmisACET_MethylBut ACET  108    -1  -1  2  atomsC/cm2/s ACET_from_methyl_butenol
+
EmisACET_Monoterp  ACET  108    -1  -1  2  atomsC/cm2/s ACET_from_monoterpenes
+
EmisACET_Ocean    ACET  101    -1  -1  2  atomsC/cm2/s ACET_from_ocean_source
+
+
###############################################################################
+
#####  ALD2 emissions (in bpch ND28, ND34, ND36, ND46. ALD2_Ocean        #####
+
#####  and is new)                                                        #####
+
###############################################################################
+
EmisALD2_Total    ALD2  -1    -1  -1  3  molec/cm2/s
+
EmisALD2_Anthro    ALD2  0      1  -1  3  atomsC/cm2/s
+
EmisALD2_BioBurn  ALD2  111    -1  -1  2  atomsC/cm2/s
+
EmisALD2_Biofuel  ALD2  0      2  -1  2  atomsC/cm2/s
+
EmisALD2_Biogenic  ALD2  108    -1  -1  2  atomsC/cm2/s
+
EmisALD2_Ocean    ALD2  101    -1  -1  2  atomsC/cm2/s
+
EmisALD2_Senesc    ALD2  0      4  -1  2  atomsC/cm2/s
+
 
+
As you can see, you can archive not only the total emissions for a given species, but also the individual emission sectors.  This gives you much more flexibility over the GEOS-Chem bpch diagnostic output.
+
 
+
Once you have your <tt>HEMCO_Diagn.rc</tt> file customized for your given simulation, make sure that you have these settings in your <tt>HEMCO_Config.rc</tt> file:
+
 
+
DiagnFile:                  HEMCO_Diagn.rc
+
DiagnPrefix:                HEMCO_diagnostics
+
DiagnFreq:                  End
+
 
+
where:
+
*<tt>DiagnFile</tt> specifies the location of the <tt>HEMCO_Diagn.rc</tt> file.
+
*<tt>DiagnPrefix</tt> specifies the the prefix for all HEMCO-generated diagnostic files.
+
*<tt>DiagnFreq</tt> specifies [[The HEMCO User's Guide#Diagnostics output frequency|the diagnostic archival frequency]].
+
 
+
You should not really have to edit <tt>HEMCO_Diagn.rc</tt> unless you are planning to add new species or emissions inventories.  The default <tt>HEMCO_Config.rc</tt> file that ships with your run directory is set up to archive diagnostics for all defined emission species.
+
 
+
== For more information ==
+
 
+
For more information about how to archive diagnostics from HEMCO, please see:
+
#[[The HEMCO User's Guide#Diagnostics|The ''Diagnostics'' section of ''The HEMCO User's Guide'']]
+
#''[[Guide to HEMCO emissions diagnostics]]''
+
  
  
 
----
 
----
 
'''''[[The HEMCO_Config.rc file|Previous]] | [[HISTORY.rc and other configuration files|Next]] | [[Getting Started with GEOS-Chem]]'''''
 
'''''[[The HEMCO_Config.rc file|Previous]] | [[HISTORY.rc and other configuration files|Next]] | [[Getting Started with GEOS-Chem]]'''''

Revision as of 15:17, 4 August 2022

Previous | Next | Getting Started with GEOS-Chem

  1. Minimum system requirements
  2. Installing required software
  3. Configuring your computational environment
  4. Downloading source code
  5. Downloading data directories
  6. Creating run directories
  7. Configuring runs
  8. Compiling
  9. Running
  10. Output files
  11. Python tools for use with GEOS-Chem
  12. Coding and debugging
  13. Further reading


This content has been migrated to the HEMCO_Diagn.rc chapter of geos-chem.readthedocs.io.



Previous | Next | Getting Started with GEOS-Chem