Difference between revisions of "List of diagnostics archived to netCDF format"

From Geos-chem
Jump to: navigation, search
(Sample HISTORY.rc diagnostic input file)
 
(191 intermediate revisions by 4 users not shown)
Line 1: Line 1:
[[Image:Page is under construction.jpg]]
+
#REDIRECT [[Guide to GEOS-Chem History diagnostics]]
 
+
<span style="color:darkorange">'''''NOTE: we are reorganizing this page to be consistent with the latest GEOS-Chem netCDF diagnostics.  This page will be in flux for the time being.'''''</span>
+
 
+
--
+
 
+
On this page we list the information about the new netCDF diagnostics that will be introduced in [[GEOS-Chem v11-02]].
+
 
+
<span style="color:darkorange">'''''NOTE: We will NOT retire the legacy bpch diagnostics in [[GEOS-Chem v11-02]].  We will preserve the bpch diagnostic output until we can find alternatives for specialty diagnostics, especially those which involve averaging in a local solar time window.'''''</span>
+
 
+
== Overview ==
+
 
+
'''''More information forthcoming'''''
+
 
+
=== An introduction to netCDF diagnostics ===
+
 
+
Bob Yantosca has created [[Media:Netcdf_Diagnostics.pdf|an overview presentation about the new netCDF diagnostics for v11-02]]. 
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 22:12, 8 February 2018 (UTC)
+
 
+
=== Sample HISTORY.rc diagnostic input file ===
+
 
+
Here is a sample <tt>HISTORY.rc</tt> file that is used to request netCDF diagnostic output from a GEOS-Chem “Classic” simulation. 
+
 
+
#============================================================================
+
# EXPID allows you to specify the beginning of the file path corresponding
+
# to each diagnostic collection.  For example:
+
#
+
#  EXPID: ./GEOSChem
+
#      Will create netCDF files whose names begin "GEOSChem",
+
#      in this run directory.
+
#
+
#  EXPID: ./OutputDir/GEOSChem
+
#      Will create netCDF files whose names begin with "GEOSChem"
+
#      in the OutputDir sub-folder of this run directory.
+
#
+
# EXPDSC and CoresPerNode are only used by GCHP simulations.
+
#============================================================================
+
EXPID:  ./GEOSChem
+
EXPDSC: GEOS-Chem_devel
+
CoresPerNode: 6
+
+
#==============================================================================
+
# %%%%% COLLECTION NAME DECLARATIONS %%%%%
+
#
+
# To disable a collection, place a "#" character in front of its name
+
#
+
# NOTE: These are the "default" collections for GEOS-Chem. 
+
# But you can create your own custom diagnostic collections as well.
+
#==============================================================================
+
COLLECTIONS: <span style="color:red">'SpeciesConc'</span>,
+
              <span style="color:blue">'ConcAfterChem'</span>,
+
::
+
@==============================================================================
+
# %%%%% THE SpeciesConc COLLECTION %%%%%
+
#
+
# GEOS-Chem species concentrations (default = advected species)
+
#
+
# Available for all simulations
+
#==============================================================================
+
<span style="color:red">SpeciesConc</span>.<span style="color:gray">template:    '%y4%m2%d2_%h2%n2z.nc4'</span>,
+
<span style="color:red">SpeciesConc</span>.<span style="color:darkorange">frequency:    060000</span>,
+
<span style="color:red">SpeciesConc</span>.format:      'CFIO',
+
<span style="color:red">SpeciesConc</span>.<span style="color:purple">duration:    240000</span>,
+
<span style="color:red">SpeciesConc</span>.<span style="color:brown">mode:        'instantaneous'</span>,
+
<span style="color:red">SpeciesConc</span>.<span style="color:green">fields:      'SpeciesConc_?ADV?'</span>,  'GIGCchem',
+
::
+
#==============================================================================
+
# %%%%% THE ConcAfterChem COLLECTION %%%%%
+
#
+
# Concentrations of OH, HO2, O1D, O3P immediately after exiting the KPP solver
+
# or OH after the CH4 specialty-simulation chemistry routine.
+
#
+
# OH:      Available for all full-chemistry simulations and CH4 specialty sim
+
# HO2:      Available for all full-chemistry simulations
+
# O1D, O3P: Availalbe for full-chemistry simulations using UCX mechanism
+
#==============================================================================
+
<span style="color:blue">ConcAfterChem</span>.<span style="color:gray">template:  '%y4%m2%d2_%h2%n2z.nc4'</span>,
+
<span style="color:blue">ConcAfterChem</span>.<span style="color:magenta">frequency:  00000100 000000</span>,
+
<span style="color:blue">ConcAfterChem</span>.format:    'CFIO',
+
<span style="color:blue">ConcAfterChem</span>.<span style="color:purple">duration:  00000100 000000</span>,
+
<span style="color:blue">ConcAfterChem</span>.<span style="color:darkcyan">mode:      'time-averaged'</span>,
+
<span style="color:blue">ConcAfterChem</span>.<span style="color:green">fields:    'OHconcAfterChem'</span>,    'GIGCchem',
+
                          <span style="color:green">'HO2concAfterChem'</span>,    'GIGCchem',
+
                          <span style="color:green">'O1DconcAfterChem'</span>,    ‘GIGCchem’,
+
                          <span style="color:green">'O3PconcAfterChem'</span>,    ‘GIGCchem’,
+
::
+
 
+
 
+
In this <tt>HISTORY.rc</tt> file, we are requesting two collections, or types of netCDF file output.  The table below explains in more detail parameters shown in the <tt>HISTORY.rc</tt> file above.
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="200px"|Attribute
+
!width="900px"|Explanation
+
 
+
|-valign="top"
+
|<tt><span style="color:red">SpeciesConc</span></tt>
+
|Name of the first collection in this <tt>HISTORY.rc</tt> file.  A collection is a series of files containing the same GEOS-Chem diagnostic quantities.
+
 
+
|-valign="top"
+
|<tt><span style="color:red">SpeciesConc</span>.<span style="color:gray">template</span></tt>
+
|Determines the date and time format for each netCDF file name belonging to the <tt><span style="color:red">SpeciesConc</span></tt> collection.
+
*The string <tt>%y4%m2%d2_%h2%n2z.nc4</tt> will print <tt>YYYYMMDD_hhmmz.nc4</tt> to the end of each netCDF filename
+
**<tt>YYYYMMDD</tt> is the date in year/month/day format
+
**<tt>hhmm</tt> is the time in hour:minutes format.
+
**<tt>z</tt> denotes "Zulu", which is an abbreviation for UTC time.
+
**<tt>.nc4</tt> denotes that the data file is in the netCDF-4 format.
+
 
+
|-valign="top"
+
|<tt><span style="color:red">SpeciesConc</span>.<span style="color:darkorange">frequency</span></tt>
+
|Determines how often the diagnostic quantities belonging to <tt><span style="color:red">SpeciesConc</span></tt> collection will be saved to a netCDF file.
+
*This can be specified as either "<tt>hhmmss</tt>" or "<tt>YYYYMMDD hhmmss</tt>".
+
*In the above example, data belonging to the <tt><span style="color:red">SpeciesConc</span></tt> collection will be written to the file <span style="color:darkorange">every 6 hours</span>.  (Because <tt><span style="color:red">SpeciesConc</span></tt> is an <span style="color:brown">instantaneous</span> collection, no time-averaging will be performed.)
+
 
+
|-valign="top"
+
|<tt><span style="color:red">SpeciesConc</span>.format</tt>
+
|For GCHP simulations only: indicates the I/O library that will be used.  This can be omitted for GEOS-Chem "Classic" simualations.
+
 
+
|-valign="top"
+
|<tt><span style="color:red">SpeciesConc</span>.<span style="color:purple">duration</span></tt>
+
|Determines how often a new <tt><span style="color:red">SpeciesConc</span></tt> netCDF file will be created. 
+
*This can be specified as either <tt>hhmmss</tt> or <tt>YYYYMMDD hhmmss</tt>.
+
*In the above example, a new <tt><span style="color:red">SpeciesConc</span></tt> netCDF file will be created <span style="color:purple">every 24 hours</span>.
+
 
+
|-valign="top"
+
|<tt><span style="color:red">SpeciesConc</span>.<span style="color:brown">mode</span></tt>
+
|Determines the averaging method for the <tt><span style="color:red">SpeciesConc</span></tt> collection
+
*In this example, <tt><span style="color:red">SpeciesConc</span></tt> is defined as an <tt><span style="color:brown">instantaneous</span></tt> (aka "time-series") collection. 
+
*Diagnostic quantities belonging to <tt><span style="color:red">SpeciesConc</span></tt> will be written directly to disk without any temporal averaging, at the specified <tt><span style="color:darkorange">frequency</span></tt>.
+
 
+
|-valign="top"
+
|<tt><span style="color:red">SpeciesConc</span>.<span style="color:green">fields</span></tt>
+
|Lists the diagnostic quantities to be included in the <tt><span style="color:red">SpeciesConc</span></tt> collection.
+
*In the above example, we are requesting to archive the <span style="color:green">concentrations of all advected species</span> to the <tt><span style="color:red">SpeciesConc</span></tt> collection.
+
*The text <tt>'GIGCchem'</tt> is only needed for GCHP simulations.  It is ignored for GEOS-Chem "Classic" simulations.  We keep the <tt>'GIGCchem'</tt> in the file in order <tt>HISTORY.rc</tt> files to be interchanged between GEOS-Chem "Classic" and GCHP simulations.
+
 
+
See the sections below for in-depth descriptions of all possible diagnostic quantities that can be archived to netCDF format.
+
 
+
NOTE: You may use wildcards to request a subset of all possible chemical species.  See the next section for more information about wildcards.
+
 
+
|-valign="top"
+
|<tt>::</tt>
+
|Signifies the end of the <tt><span style="color:red">SpeciesConc</span></tt> definition section.
+
*"<tt>::</tt>" may be placed at any column in the file.
+
 
+
|-valign="top"
+
|<tt><span style="color:blue">ConcAfterChem</span></tt>
+
|Name of the second collection in this <tt>HISTORY.rc</tt> file.
+
 
+
|-valign="top"
+
|<tt><span style="color:blue">ConcAfterChem</span>.<span style="color:gray">template</span></tt>
+
|Determines the date and time format for each netCDF file name belonging to the <tt><span style="color:blue">ConcAfterChem</span></tt> collection.
+
 
+
|-valign="top"
+
|<tt><span style="color:blue">ConcAfterChem</span>.<span style="color:magenta">frequency</span></tt>
+
|Determines the length of the period in which the diagnostic quantities belonging to <tt><span style="color:blue">ConcAfterChem</span></tt> collection will be temporally-averaged, before being saved to a netCDF file.
+
*This can be can be specified as either "<tt>hhmmss</tt>" or "<tt>YYYYMMDD hhmmss</tt>".
+
*In the above example, data belonging to the <tt><span style="color:blue">ConcAfterChem</span></tt> collection will be <span style="color:magenta">averaged into monthly mean output</span>.
+
 
+
|-valign="top"
+
|<tt><span style="color:blue">ConcAfterChem</span>.format</tt>
+
|For GCHP simulations only: indicates the I/O library that will be used.  This can be omitted for GEOS-Chem "Classic" simualations.
+
 
+
|-valign="top"
+
|<tt><span style="color:blue">ConcAfterChem</span>.<span style="color:purple">duration</span></tt>
+
|Determines how often a new netCDF file belongng to the <tt><span style="color:blue">ConcAfterChem</span></tt> will be created.
+
*The <tt><span style="color:purple">duration</span></tt> attribute can be specified as either <tt>hhmmss</tt> or <tt>YYYYMMDD hhmmss</tt>.
+
*In the above example, a new <tt><span style="color:blue">ConcAfterChem</span></tt> netCDF file will be created <span style="color:purple">at the start of each new month</span>.
+
 
+
|-valign="top"
+
|<tt><span style="color:blue">ConcAfterChem</span>.<span style="color:darkcyan">mode</span></tt>
+
|Determines the averaging method for the <tt><span style="color:blue">ConcAfterChem</span></tt> collection
+
*In the above example, <tt><span style="color:blue">ConcAfterChem</span></tt> is defined as an <tt><span style="color:darkcyan">time-averaged</span></tt> collection. 
+
*Diagnostic quantities belonging to the <tt><span style="color:blue">ConcAfterChem</span></tt> collection will be temporally-averaged for a period whose length is specified by the <tt><span style="color:magenta">frequency</span></tt> attribute before being written to a netCDF file.
+
 
+
|-valign="top"
+
|<tt><span style="color:blue">ConcAfterChem</span>.<span style="color:green">fields</span></tt>
+
|Lists the diagnostic quantities to be included in the <tt><span style="color:blue">ConcAfterChem</span></tt> collection.
+
*In the above example, we are requesting to archive to the <tt><span style="color:blue">ConcAfterChem</span></tt> collection the <span style="color:green">concentrations of OH, HO2, O1D, and O3P upon exiting the FlexChem/KPP solver</span>
+
*The text <tt>'GIGCchem'</tt> is only needed for GCHP simulations.  It is ignored for GEOS-Chem "Classic" simulations.  We keep the <tt>'GIGCchem'</tt> in the file in order <tt>HISTORY.rc</tt> files to be interchanged between GEOS-Chem "Classic" and GCHP simulations.
+
 
+
See the sections below for in-depth descriptions of all possible diagnostic quantities that can be archived to netCDF format.
+
 
+
NOTE: You may use wildcards to request a subset of all possible species.  See the next section for more information about wildcards.
+
 
+
|-valign="top"
+
|<tt>::</tt>
+
|Signifies the end of the <tt><span style="color:blue">ConcAfterChem</span></tt> definition section.
+
*"<tt>::</tt>" may be placed at any column in the file.
+
 
+
|}
+
 
+
For more examples, please see [[Media:Netcdf_Diagnostics.pdf|Bob Yantosca’s netCDF diagnostics overview presentation]]. We will also add more documentation to the GEOS-Chem wiki in the coming weeks.
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 22:12, 8 February 2018 (UTC)
+
 
+
=== netCDF file names ===
+
 
+
The names of the netCDF files corresponding to each collection will adhere to this convention:
+
 
+
  EXPID.CollectionName.Template
+
 
+
 
+
[[#Sample HISTORY.rc diagnostic input file|As shown in the prior section]], the
+
 
+
== Legend ==
+
 
+
This section contains a description of how the information about each diagnostic quantity is arranged in the sections below.
+
 
+
=== General information about each diagnostic ===
+
 
+
The tables below list the following parameters for each diagnostic that is archived to bpch format:
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top"
+
!bgcolor="#CCCCCC" width="175px"|Diagnostic name
+
|width="835px"|The name of the given diagnostic quantity that will be archived to netCDF file format.
+
*NOTE: Wildcards can be used with certain diagnostics.  This will let you specify all possible species, wavelength bins, etc. for a given diagnostic instead of having to list them individually.  [[#Wildcards|See the next section for a list of all possible wildcards]].
+
*ALSO NOTE: At this time, wildcards are not allowed in GCHP simulations.  We are working to resolve this.
+
 
+
|-valign="top"
+
!bgcolor="#CCCCCC"|Description
+
|A short overview of the given diagnostic.
+
 
+
|-valign="top"
+
!bgcolor="#CCCCCC"|Units
+
|The physical units of the given diagnostic quantity.
+
 
+
|-valign="top"
+
!bgcolor="#CCCCCC"|Wildcards
+
|[[#Wildcards|A list of wildcards]] that can be used to specify all possible species, wavelength bins, etc. for the given diagnostic quantity.  For a complete list of wildcards, please see the table below.
+
 
+
|-valign="top"
+
!bgcolor="#CCCCCC"|Simulations
+
|A list of simulations for which this particular diagnostic is valid.
+
 
+
|-valign="top"
+
!bgcolor="#CCCCCC"|Bpch equivalent
+
|The NDxx diagnostic number (and slot) under which the same diagnostic is available as bpch output.  See the [[List of diagnostics archived to bpch format]] wiki page for more information.
+
 
+
|-valign="top"
+
!bgcolor="#CCCCCC"|Notes
+
|Lists supplemental information for the given diagnostic.
+
 
+
|}
+
 
+
=== Wildcards ===
+
 
+
The following terms are used in the tables below.
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="175px"|Term
+
!width="600px"|Explanation
+
!width="225px"|Example
+
 
+
|-valign="top"
+
|<tt><spcname></tt>
+
|Short name of a GEOS-Chem species, used in several diagnostics listed below. 
+
 
+
NOTES:
+
 
+
#The single-underscore (<tt>_</tt>) preceding the species name indicates that use of a species wildcard (e.g <tt>SpeciesConc_<span style="color:red">?ADV?</span></tt>, which only selects advected species) is possible.
+
#Allowable wild card values (case-insensitive) for species name are:
+
#*<tt>?ADV?</tt>: Only the advected species
+
#*<tt>?AER?</tt>: Only the aerosol species
+
#*<tt>?ALL?</tt>: All GEOS-Chem species
+
#*<tt>?DRY?</tt>: Only the dry-deposited species
+
#*<tt>?FIX?</tt>: Only the inactive (aka "fixed") species in the KPP chemical mechanism
+
#*<tt>?GAS?</tt>: Only the gas-phase species
+
#*<tt>?KPP?</tt>: Only the KPP species
+
#*<tt>?PHO</tt>: Only the photolyzed species
+
#*<tt>?VAR?</tt>: Only the active (aka "variable") species in the KPP chemical mechanism
+
#*<tt>?WET?</tt>: Only the wet-deposited species
+
#*<tt>?PRODLOSS?</tt>: Only prod/loss diagnostic species
+
#*<tt>?DUSTBIN</tt>: Only the dust bin number
+
#<tt><spcname></tt> should be case-insensitive.  In most places where species names are compared, species names are first converted to uppercase and then a string match test is done.  But because most species names represent a chemical formula (e.g. NO, CO),they will be mostly all uppercase. Some species names would have mixed-case, e.g. BrCl, Rn, Pb, Be7, etc.
+
|<tt>SpeciesConc_<span style="color:red">NO</span></tt><br><tt>SpeciesConc_<span style="color:red">CO</span></tt><br><tt>SpeciesConc_<span style="color:red">?ADV?</span></tt><br><tt>SpeciesConc_<span style="color:red">?AER?</span></tt><br><tt>SpeciesConc_<span style="color:red">?ALL?</span></tt><br><tt>SpeciesConc_<span style="color:red">?DRY?</span></tt><br><tt>SpeciesConc_<span style="color:red">?FIX?</span></tt><br><tt>SpeciesConc_<span style="color:red">?GAS?</span></tt><br><tt>SpeciesConc_<span style="color:red">?KPP?</span></tt><br><tt>SpeciesConc_<span style="color:red">?PHO?</span></tt><br><tt>SpeciesConc_<span style="color:red">?VAR?</span></tt><br><tt>SpeciesConc_<span style="color:red">?WET?</span></tt><br><tt>...etc...</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt><metname></tt>
+
|Denotes a met field (or derived quantity such as total optical depth).
+
 
+
NOTES:
+
#<tt>MET_</tt>, <tt>Met_</tt> or <tt>met_</tt> (case-insensitive) must precede <tt><metname></tt>.  This tells the diagnostic code to look for the corresponding field of the <tt>State_Met</tt> object.
+
|<tt>MET_<span style="color:red">U10M</span></tt><br><tt>MET_<span style="color:red">PS</span></tt><br><tt>MET_<span style="color:red">HFLUX</span></tt><br><tt>MET_<span style="color:red">T</span></tt><br><tt>...etc...</tt>
+
 
+
|-valign="top"
+
|<tt><photobin></tt>
+
|Number of a given wavelength bin for FAST-JX photolysis
+
|<tt>1-18</tt> (with UCX on);<br><tt>1-12</tt> (with UCX off)
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt><aername></tt>
+
|Aerosol quanatities included in the following array fields:
+
 
+
#<tt>State_Chm%AeroArea</tt>
+
#<tt>State_Chm%AeroRadi</tt>
+
#<tt>State_Chm%WetAeroArea</tt>
+
#<tt>State_Chm%WetAeroRadi</tt>
+
 
+
These do not always conform to GEOS-Chem species (for example, the mineral dust bins are the bins that are used as input for photolysis).
+
 
+
#<tt>MDUST1</tt>: Mineral dust (0.15&mu;m)
+
#<tt>MDUST2</tt>: Mineral dust (0.25&mu;m)
+
#<tt>MDUST3</tt>: Mineral dust (0.40&mu;m)
+
#<tt>MDUST4</tt>: Mineral dust (0.80&mu;m)
+
#<tt>MDUST5</tt>: Mineral dust (1.50&mu;m)
+
#<tt>MDUST6</tt>: Mineral dust (2.50&mu;m)
+
#<tt>MDUST7</tt>: Mineral dust (4.00&mu;m)
+
#<tt>SULF</tt>: Sulfate
+
#<tt>BC</tt>: Black Carbon
+
#<tt>OC</tt>: Organic Carbon
+
#<tt>SSA</tt>: Sea salt aerosol, accumulation mode
+
#<tt>SSC</tt>: Sea salt aerosol, coarse mode
+
#<tt>BGSULF</tt>: Background stratospheric sulfate '''''(fullchem simulations w/ UCX mechanism)'''''
+
#<tt>ICEI</tt>: Irregular ice cloud (Mischenko) '''''(fullchem simulations w/ UCX mechanism)'''''
+
|<tt>CHEM_AeroArea<span style="color:red">MDUST1</span></tt><br><tt>CHEM_WetAeroRadi<span style="color:red">SSA</span></tt><br><tt>...etc...</tt>
+
 
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 17:05, 9 February 2018 (UTC)
+
 
+
== Collections ==
+
 
+
NOTE: The following collections are used by default in GEOS-Chem simulations.  You can create your own customized collections by modifying the <tt>HISTORY.rc</tt> file.
+
 
+
The only restriction is that you cannot mix data that is placed on grid box layer edges in the same collection as data placed on grid box layer centers.  This violates the netCDF convention that all data variables have to be defined with the same vertical dimension.
+
 
+
=== List of collections ===
+
 
+
The top of each <tt>HISTORY.rc</tt> file will look similar to this:
+
 
+
###############################################################################
+
###  HISTORY.rc file for GEOS-Chem                                          ###
+
###  Contact: GEOS-Chem Support Team (geos-chem-support@as.harvard.edu)    ###
+
###############################################################################
+
+
#============================================================================
+
# EXPID allows you to specify the beginning of the file path corresponding
+
# to each diagnostic collection.  For example:
+
#
+
#  EXPID: ./GEOSChem
+
#      Will create netCDF files whose names begin "GEOSChem",
+
#      in this run directory.
+
#
+
#  EXPID: ./OutputDir/GEOSChem
+
#      Will create netCDF files whose names begin with "GEOSChem"
+
#      in the OutputDir sub-folder of this run directory.
+
#
+
# EXPDSC and CoresPerNode are only used by GCHP simulations.
+
#============================================================================
+
EXPID:  ./GEOSChem
+
EXPDSC: GEOS-Chem_devel
+
CoresPerNode: 6
+
+
#==============================================================================
+
# %%%%% COLLECTION NAME DECLARATIONS %%%%%
+
#
+
# To disable a collection, place a "#" character in front of its name
+
#
+
# NOTE: These are the "default" collections for GEOS-Chem. 
+
# But you can create your own custom diagnostic collections as well.
+
#==============================================================================
+
COLLECTIONS: 'SpeciesConc',
+
              'AerosolMass',
+
              'Aerosols',
+
              'CloudConvFlux',
+
              'ConcAfterChem',
+
              'DryDep',
+
              'JValues',
+
              'JValuesLocalNoon',
+
              'LevelEdgeDiags',     
+
              'ProdLoss',
+
              'StateChm',   
+
              'StateMet',     
+
              'WetLossConv',
+
              'WetLossLS',
+
::
+
 
+
The <tt>COLLECTIONS:</tt> tag specifies the types of diagnostics that you would like to be written to netCDF files.  Each collection represents a group of diagnostic quantities that will be written to disk together.  The collection name will be automatically added to the netCDF file name along with the date/or time.
+
 
+
Each c
+
 
+
=== The SpeciesConc collection ===
+
 
+
The '''SpeciesConc''' diagnostic collection contains advected species concentrations.  This type of diagnostic output is used in all GEOS-Chem simulations; therefore, we have listed SpeciesConc first in the <tt>HISTORY.rc</tt> files that ship with each [[Creating_GEOS-Chem_run_directories|GEOS-Chem run directory]].
+
 
+
Here is a sample definition section for the SpeciesConc collection.  If this collection is not already present in the <tt>HISTORY.rc</tt> file in [[Creating GEOS-Chem run directories|the GEOS-Chem run directory for your selected simulation]], you can copy and paste this into your <tt>HISTORY.rc</tt> file and edit accordingly.  To prevent an individual field from being included in the diagnostic output, place a comment character <tt>#</tt> in front of the field name.
+
 
+
 
+
  SpeciesConc.template:      '%y4%m2%d2_%h2%n2z.nc4',
+
  SpeciesConc.format:        'CFIO',
+
  SpeciesConc.frequency:      00000100 000000
+
  SpeciesConc.duration:      00000100 000000
+
  SpeciesConc.mode:          'time-averaged'
+
  SpeciesConc.fields:        'SpeciesConc_?ADV?            ', 'GIGCchem',
+
::
+
 
+
This table describes the diagnostic quantities belonging to the SpeciesConc collection:
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="225px"|Diagnostic name
+
!width="225px"|Description
+
!width="125px"|Units
+
!width="80px"|Wildcards
+
!width="150px"|Simulations
+
!width="100px"|[[List of diagnostics archived to bpch format|Bpch equiv.]]
+
!width="150px"|Notes
+
 
+
|-valign="top"
+
|SpeciesConc_<spcname>
+
|Chemical species concentrations
+
|mol/mol dry air
+
|
+
*?ADV?
+
*?AER?
+
*?ALL?
+
*?DRY?
+
*?FIX?
+
*?GAS?
+
*?KPP?
+
*?PHO?
+
*?VAR?
+
*?WET?
+
|
+
*all simulations
+
|
+
*[[List of diagnostics archived to bpch format|ND45]]
+
*[[List of diagnostics archived to bpch format|ND47]]
+
*[[List of diagnostics archived to bpch format|ND48]]
+
*[[List of diagnostics archived to bpch format|ND49]]
+
*[[List of diagnostics archived to bpch format|ND50]]
+
*[[List of diagnostics archived to bpch format|ND51]]
+
|
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 19:43, 16 May 2018 (UTC)
+
 
+
=== The AerosolMass collection ===
+
 
+
The '''AerosolMass''' collection contains diagnostics for aerosol mass and particulate matter from full-chemistry simulations.
+
 
+
Here is a sample definition section for the AerosolMass collection.  If this collection is not already present in the <tt>HISTORY.rc</tt> file in [[Creating GEOS-Chem run directories|the GEOS-Chem run directory for your selected simulation]], you can copy and paste this into your <tt>HISTORY.rc</tt> file and edit accordingly.  To prevent an individual field from being included in the diagnostic output, place a comment character <tt>#</tt> in front of the field name.
+
 
+
  AerosolMass.template:      '%y4%m2%d2_%h2%n2z.nc4',
+
  AerosolMass.format:        'CFIO',
+
  AerosolMass.frequency:      00000100 000000
+
  AerosolMass.duration:      00000100 000000
+
  AerosolMass.mode:          'time-averaged'
+
  AerosolMass.fields:        'AerMassASOA                  ', 'GIGCchem',
+
                              'AerMassBC                    ', 'GIGCchem',
+
                              'AerMassINDIOL                ', 'GIGCchem',
+
                              'AerMassISN1OA                ', 'GIGCchem',
+
                              'AerMassISOA                  ', 'GIGCchem',
+
                              'AerMassLVOCOA                ', 'GIGCchem',
+
                              'AerMassNH4                  ', 'GIGCchem',
+
                              'AerMassNIT                  ', 'GIGCchem',
+
                              'AerMassOPOA                  ', 'GIGCchem',
+
                              'AerMassPOA                  ', 'GIGCchem',
+
                              'AerMassSAL                  ', 'GIGCchem',
+
                              'AerMassSO4                  ', 'GIGCchem',
+
                              'AerMassSOAGX                ', 'GIGCchem',
+
                              'AerMassSOAIE                ', 'GIGCchem',
+
                              'AerMassSOAME                ', 'GIGCchem',
+
                              'AerMassSOAMG                ', 'GIGCchem',
+
                              'AerMassTSOA                  ', 'GIGCchem',
+
                              'BetaNO                      ', 'GIGCchem',
+
                              'PM25                        ', 'GIGCchem',
+
                              'TotalBiogenicOA              ', 'GIGCchem',
+
                              'TotalOA                      ', 'GIGCchem',
+
                              'TotalOC                      ', 'GIGCchem',
+
::
+
 
+
This table describes the diagnostic quantities belonging to the AerosolMass collection:
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="225px"|Diagnostic name
+
!width="225px"|Description
+
!width="125px"|Units
+
!width="80px"|Wildcards
+
!width="150px"|Simulations
+
!width="100px"|[[List of diagnostics archived to bpch format|Bpch equiv.]]
+
!width="150px"|Notes
+
 
+
|-valign="top"
+
|AerMassTSOA
+
|Aerosol products of terpene oxidation
+
|ug/m3
+
|none
+
|
+
*benchmark
+
*complexSOA
+
*complexSOA_SVPOA
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #1]]
+
|
+
 
+
|-valign="top"
+
|AerMassISOA
+
|Aerosol products of isoprene oxidation
+
|ug/m3
+
|none
+
|
+
*benchmark
+
*complexSOA
+
*complexSOA_SVPOA
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #2]]
+
|
+
 
+
|-valign="top"
+
|AerMassTSOA
+
|Aerosol products of terpene oxidation
+
|ug/m3
+
|none
+
|
+
*benchmark
+
*complexSOA
+
*complexSOA_SVPOA
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #1]]
+
|
+
 
+
|-valign="top"
+
|AerMassASOA
+
|Aerosol products of light aromatics + IVOC oxidation
+
|ug/m3
+
|none
+
|
+
*benchmark
+
*complexSOA
+
*complexSOA_SVPOA
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #3]]
+
|
+
 
+
|-valign="top"
+
|AerMassPOA
+
|Aerosols from SVOCs
+
|ug/m3
+
|none
+
|
+
*benchmark
+
*complexSOA
+
*complexSOA_SVPOA
+
*standard
+
*tropchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #4]]
+
|
+
 
+
|-valign="top"
+
|AerMassTSOA
+
|Aerosol products of terpene oxidation
+
|ug/m3
+
|none
+
|
+
*benchmark
+
*complexSOA
+
*complexSOA_SVPOA
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #1]]
+
|
+
 
+
|-valign="top"
+
|AerMassOPOA
+
|Aerosol products of POG oxidation
+
|ug/m3
+
|none
+
|
+
*complexSOA_SVPOA
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #5]]
+
|
+
 
+
|-valign="top"
+
|TotalOA
+
|Sum of all organic aerosol
+
|ug/m3
+
|none
+
|
+
*aerosol
+
*benchmark
+
*complexSOA
+
*complexSOA_SVPOA
+
*standard
+
*tropchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #6]]
+
|
+
*Will probably be renamed to AerMassTotalOA for consistency with other diagnostics in this collection
+
 
+
|-valign="top"
+
|TotalOC
+
|Sum of all organic carbon
+
|ug/m3
+
|none
+
|
+
*benchmark
+
*complexSOA
+
*complexSOA_SVPOA
+
*standard
+
*tropchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #7]]
+
|
+
*Will probably be renamed to AerMassTotalOC for consistency with other diagnostics in this collection
+
 
+
|-valign="top"
+
|BetaNO
+
|NO branching ratio
+
|ug/m3
+
|none
+
|
+
*benchmark
+
*complexSOA
+
*complexSOA_SVPOA
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #8]]
+
|
+
*Will probably be renamed to AerMassBetaNO for consistency with other diagnostics in this collection
+
 
+
|-valign="top"
+
|AerMassBC
+
|Black carbon (BCPI + BCPO)
+
|ug/m3
+
|none
+
|
+
*benchmark
+
*complexSOA
+
*complexSOA_SVPOA
+
*standard
+
*tropchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #13]]
+
|
+
 
+
|-valign="top"
+
|AerMassSO4
+
|Sulfate
+
|ug/m3
+
|none
+
|
+
*benchmark
+
*complexSOA
+
*complexSOA_SVPOA
+
*standard
+
*tropchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #14]]
+
|
+
 
+
|-valign="top"
+
|AerMassNH4
+
|Ammonium
+
|ug/m3
+
|none
+
|
+
*benchmark
+
*complexSOA
+
*complexSOA_SVPOA
+
*standard
+
*tropchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #15]]
+
|
+
 
+
|-valign="top"
+
|AerMassNIT
+
|Nitrate
+
|ug/m3
+
|none
+
|
+
*benchmark
+
*complexSOA
+
*complexSOA_SVPOA
+
*standard
+
*tropchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #16]]
+
|
+
 
+
|-valign="top"
+
|AerMassSAL
+
|Sea salt aerosol (SALA + SALC)
+
|ug/m3
+
|none
+
|
+
*benchmark
+
*complexSOA
+
*complexSOA_SVPOA
+
*standard
+
*tropchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #17]]
+
|
+
 
+
|-valign="top"
+
|PM25
+
|Particulate matter (r < 2.5 &mu;m)
+
|ug/m3
+
|none
+
|
+
*benchmark
+
*complexSOA
+
*complexSOA_SVPOA
+
*standard
+
*tropchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #18]]
+
|
+
*Will probably be renamed to AerMassBetaNO for consistency with other diagnostics in this collection
+
 
+
|-valign="top"
+
|AerMassSOAGX
+
|Aerosol-phase glyoxal
+
|ug/m3
+
|none
+
|
+
*benchmark
+
*complexSOA
+
*complexSOA_SVPOA
+
*standard
+
*tropchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #19]]
+
|
+
*New in [[GEOS-Chem v11-02|v11-02]]
+
 
+
|-valign="top"
+
|AerMassSOAMG
+
|Aerosol-phase methylglyoxal
+
|ug/m3
+
|none
+
|
+
*benchmark
+
*complexSOA
+
*complexSOA_SVPOA
+
*standard
+
*tropchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #20]]
+
|
+
*New in [[GEOS-Chem v11-02|v11-02]]
+
 
+
|-valign="top"
+
|AerMassSOAIE
+
|Aerosol-phase IEPOX
+
|ug/m3
+
|none
+
|
+
*benchmark
+
*complexSOA
+
*complexSOA_SVPOA
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #21]]
+
|
+
*New in [[GEOS-Chem v11-02|v11-02]]
+
 
+
|-valign="top"
+
|AerMassSOAME
+
|Aerosol-phase IMAE
+
|ug/m3
+
|none
+
|
+
*benchmark
+
*complexSOA
+
*complexSOA_SVPOA
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #22]]
+
|
+
*New in v11-02
+
 
+
|-valign="top"
+
|AerMassINDIOL
+
|Generic aerosol-phase organonitrate hydrolysis product
+
|ug/m3
+
|none
+
|
+
*benchmark
+
*complexSOA
+
*complexSOA_SVPOA
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #23]]
+
|
+
*New in v11-02
+
 
+
|-valign="top"
+
|AerMassLVOCOA
+
|Aerosol-phase low-volatility non-IEPOX product of ISOPOOH (RIP) oxidation
+
|ug/m3
+
|none
+
|
+
*benchmark
+
*complexSOA
+
*complexSOA_SVPOA
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #24]]
+
|
+
*New in v11-02
+
 
+
|-valign="top"
+
|AerMassISN1OA
+
| Aerosol-phase 2nd generation hydroxynitrates formed from ISOP+NO3 reaction pathway
+
|ug/m3
+
|none
+
|
+
*benchmark
+
*complexSOA
+
*complexSOA_SVPOA
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND42:_Aerosol_mass_and_PM2.5_diagnostics|ND42 #25]]
+
|
+
*New in v11-02
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:19, 16 May 2018 (UTC)
+
 
+
=== The Aerosols collection ===
+
 
+
Info to be added soon
+
 
+
=== The CloudConvFlux collection ===
+
 
+
The '''CloudConvFlux''' collection contains diagnostics for mass fluxes in cloud convection.
+
 
+
Here is a sample definition section for the CloudConvFlux collection.  If this collection is not already present in the <tt>HISTORY.rc</tt> file in [[Creating GEOS-Chem run directories|the GEOS-Chem run directory for your selected simulation]], you can copy and paste this into your <tt>HISTORY.rc</tt> file and edit accordingly.  To prevent an individual field from being included in the diagnostic output, place a comment character <tt>#</tt> in front of the field name.
+
 
+
  CloudConvFlux.template:    '%y4%m2%d2_%h2%n2z.nc4',
+
  CloudConvFlux.format:      'CFIO',
+
  CloudConvFlux.frequency:    00000100 000000
+
  CloudConvFlux.duration:    00000100 000000
+
  CloudConvFlux.mode:        'time-averaged'
+
  CloudConvFlux.fields:      'CloudConvFlux_?ADV?          ', 'GIGCchem',
+
::
+
 
+
This table describes the diagnostic quantities belonging to the CloudConvFlux collection:
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="225px"|Diagnostic name
+
!width="225px"|Description
+
!width="125px"|Units
+
!width="80px"|Wildcards
+
!width="150px"|Simulations
+
!width="100px"|[[List of diagnostics archived to bpch format|Bpch equiv.]]
+
!width="150px"|Notes
+
 
+
|-valign="top"
+
|CloudConvFlux_<spcname>
+
|Mass change due to cloud convection
+
|kg/s
+
|
+
*?ADV?
+
*?DRY?
+
*?GAS?
+
*?WET?
+
|
+
*all simulations
+
|
+
*[[List of diagnostics archived to bpch format|ND14]]
+
|
+
*Will be replaced by new flux diagnostics in v11-03
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:21, 16 May 2018 (UTC)
+
 
+
=== The ConcAfterChem collection ===
+
 
+
The '''ConcAfterChem''' collection contains diagnostics for OH, HO2, etc. species immediately upon exiting the [[FlexChem]] solver.
+
 
+
Here is a sample definition section for the ConcAfterChem collection.  If this collection is not already present in the <tt>HISTORY.rc</tt> file in [[Creating GEOS-Chem run directories|the GEOS-Chem run directory for your selected simulation]], you can copy and paste this into your <tt>HISTORY.rc</tt> file and edit accordingly.  To prevent an individual field from being included in the diagnostic output, place a comment character <tt>#</tt> in front of the field name.
+
 
+
  ConcAfterChem.template:    '%y4%m2%d2_%h2%n2z.nc4',
+
  ConcAfterChem.format:      'CFIO',
+
  ConcAfterChem.frequency:    00000100 000000
+
  ConcAfterChem.duration:    00000100 000000
+
  ConcAfterChem.mode:        'time-averaged'
+
  ConcAfterChem.fields:      'OHconcAfterChem                ', 'GIGCchem', 
+
                              'HO2concAfterChem              ', 'GIGCchem', 
+
                              'O1DconcAfterChem              ', 'GIGCchem', 
+
                              'O3PconcAfterChem              ', 'GIGCchem', 
+
::
+
 
+
This table describes the diagnostic quantities belonging to the ConcAfterChem collection:
+
 
+
''NOTE: '''All fullchem''' refers to all simulations that use [[GEOS-Chem_chemistry_mechanisms#Mechanisms_for_GEOS-Chem_v11-02|a full-chemistry mechanism]] (i.e. benchmark, complexSOA*, standard, tropchem. aciduptake, marinePOA, RRTMG, TOMAS).''
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="225px"|Diagnostic name
+
!width="225px"|Description
+
!width="125px"|Units
+
!width="80px"|Wildcards
+
!width="150px"|Simulations
+
!width="100px"|[[List of diagnostics archived to bpch format|Bpch equiv.]]
+
!width="150px"|Notes
+
 
+
|-valign="top"
+
|OHconcAfterChem
+
|OH concentration immediately after exiting the FlexChem solver
+
|molec/cm3
+
|
+
|
+
*all fullchem
+
|
+
*[[List of diagnostics archived to bpch format|ND43]], #1
+
|
+
 
+
|-valign="top"
+
|HO2concAfterChem
+
|HO2 concentration immediately after exiting the FlexChem solver
+
|molec/cm3
+
|
+
|
+
*all fullchem
+
|
+
*[[List of diagnostics archived to bpch format|ND43]], #3
+
|
+
+
|-valign="top"
+
|O1DconcAfterChem
+
|O1D concentration immediately after exiting the FlexChem solver
+
|molec/cm3
+
|
+
|
+
*aciduptake
+
*benchmark
+
*marinePOA
+
*standard
+
|
+
*[[List of diagnostics archived to bpch format|ND43]], #4
+
|
+
 
+
|-valign="top"
+
|O3PconcAfterChem
+
|O3P concentration immediately after exiting the FlexChem solver
+
|molec/cm3
+
|
+
|
+
*aciduptake
+
*benchmark
+
*marinePOA
+
*standard
+
|
+
*[[List of diagnostics archived to bpch format|ND43]], #5
+
|
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:59, 16 May 2018 (UTC)
+
 
+
=== The DryDep collection ===
+
 
+
The '''DryDep''' collection contains diagnostics for the flux and velocity of each species lost to dry-deposition.
+
 
+
Here is a sample definition section for the DryDep collection.  If this collection is not already present in the <tt>HISTORY.rc</tt> file in [[Creating GEOS-Chem run directories|the GEOS-Chem run directory for your selected simulation]], you can copy and paste this into your <tt>HISTORY.rc</tt> file and edit accordingly.  To prevent an individual field from being included in the diagnostic output, place a comment character <tt>#</tt> in front of the field name.
+
 
+
  DryDep.template:            '%y4%m2%d2_%h2%n2z.nc4',
+
  DryDep.format:              'CFIO',
+
  DryDep.frequency:          00000100 000000
+
  DryDep.duration:            00000100 000000
+
  DryDep.mode:                'time-averaged'
+
  DryDep.fields:              'DryDepVel_?DRY?              ', 'GIGCchem',
+
                              'DryDepMix_?DRY?              ', 'GIGCchem',
+
                              'DryDepChm_?DRY?              ', 'GIGCchem',
+
                              'DryDep_?DRY?                  ', 'GIGCchem',
+
::
+
 
+
This table describes the diagnostic quantities belonging to the DryDep collection:
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="225px"|Diagnostic name
+
!width="225px"|Description
+
!width="125px"|Units
+
!width="80px"|Wildcards
+
!width="150px"|Simulations
+
!width="100px"|[[List of diagnostics archived to bpch format|Bpch equiv.]]
+
!width="150px"|Notes
+
 
+
|-valign="top"
+
|DryDepVel_<spcname>
+
|Dry deposition velocity
+
|cm/s
+
|
+
*?DRY?
+
|
+
*all simulations with drydep species
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND44:_Dry_deposition_diagnostics|ND44]]
+
|
+
 
+
|-valign="top"
+
|DryDepMix_<spcname>
+
|Dry deposition flux<br>(computed in PBL mixing)
+
|molec/cm2/s
+
|
+
*?DRY?
+
|
+
*all simulations with drydep species
+
|
+
|
+
 
+
|-valign="top"
+
|DryDepChm_<spcname>
+
|Dry deposition flux<br>(computed in chemistry)
+
|molec/cm2/s
+
|
+
*?DRY?
+
|
+
*all simulations with drydep species
+
|
+
|
+
 
+
|-valign="top"
+
|DryDep_<spcname>
+
|Total dry deposition flux
+
|molec/cm2/s
+
|
+
*?DRY?
+
|
+
*all simulations with drydep species
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND44:_Dry_deposition_diagnostics|ND44]]
+
|
+
*Sum of drydep flux in mixing and drydep flux in chemistry.
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:33, 16 May 2018 (UTC)
+
 
+
=== The JValues collection ===
+
 
+
The '''JValues''' collection contains diagnostics for photolysis rates for various chemical species, obtained from the FAST-JX photolysis mechanism.
+
 
+
Here is a sample definition section for the JValues collection.  If this collection is not already present in the <tt>HISTORY.rc</tt> file in [[Creating GEOS-Chem run directories|the GEOS-Chem run directory for your selected simulation]], you can copy and paste this into your <tt>HISTORY.rc</tt> file and edit accordingly.  To prevent an individual field from being included in the diagnostic output, place a comment character <tt>#</tt> in front of the field name.
+
 
+
  JValues.template:          '%y4%m2%d2_%h2%n2z.nc4',
+
  JValues.format:            'CFIO',
+
  JValues.frequency:          00000000 010000
+
  JValues.duration:          00000000 010000
+
  JValues.mode:              'instantaneous'
+
  JValues.fields:            'Jval_?PHO?                    ', 'GIGCchem',
+
::
+
 
+
This table describes the diagnostic quantities belonging to the JValues collection:
+
 
+
''NOTE: '''All fullchem''' refers to all simulations that use [[GEOS-Chem_chemistry_mechanisms#Mechanisms_for_GEOS-Chem_v11-02|a full-chemistry mechanism]] (i.e. benchmark, complexSOA*, standard, tropchem. aciduptake, marinePOA, RRTMG, TOMAS).''
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="225px"|Diagnostic name
+
!width="225px"|Description
+
!width="125px"|Units
+
!width="80px"|Wildcards
+
!width="150px"|Simulations
+
!width="100px"|[[List of diagnostics archived to bpch format|Bpch equiv.]]
+
!width="150px"|Notes
+
 
+
|-valign="top"
+
|Jval_<spcname>
+
|Photolysis rates
+
|1/s
+
|
+
*?PHO?
+
|
+
*all fullchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND22:_Photolysis_diagnostics|ND22]]
+
|
+
*We recommend using saving out instantaneous values with this collection.
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:38, 16 May 2018 (UTC)
+
 
+
=== The JValuesLocalNoon collection ===
+
 
+
<span style="color:red">'''''NOTE: At present, we are debugging an issue in how the noontime J-values are archived for netCDF.  Until further notice, we recommend that you use the ND22 bpch diagnostic to archive noontime J-values. (Bob Yantosca, 16 May 2018)'''''</span>
+
 
+
The '''JValuesLocalNoon''' collection contains diagnostics for photolysis rates for various chemical species, obtained from the FAST-JX photolysis mechanism, at the grid box where it is nearest to local solar noon.
+
 
+
Here is a sample definition section for the JValuesLocalNoon collection.  If this collection is not already present in the <tt>HISTORY.rc</tt> file in [[Creating GEOS-Chem run directories|the GEOS-Chem run directory for your selected simulation]], you can copy and paste this into your <tt>HISTORY.rc</tt> file and edit accordingly.  To prevent an individual field from being included in the diagnostic output, place a comment character <tt>#</tt> in front of the field name.
+
 
+
  JValues.template:          '%y4%m2%d2_%h2%n2z.nc4',
+
  JValues.format:            'CFIO',
+
  JValues.frequency:          00000100 000000
+
  JValues.duration:          00000100 000000
+
  JValues.mode:              'time-averaged'
+
  JValues.fields:            'JNoon_?PHO?                    ', 'GIGCchem',
+
::
+
 
+
This table describes the diagnostic quantities belonging to the JValuesLocalNoon collection:
+
 
+
''NOTE: '''All fullchem''' refers to all simulations that use [[GEOS-Chem_chemistry_mechanisms#Mechanisms_for_GEOS-Chem_v11-02|a full-chemistry mechanism]] (i.e. benchmark, complexSOA*, standard, tropchem. aciduptake, marinePOA, RRTMG, TOMAS).''
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="225px"|Diagnostic name
+
!width="225px"|Description
+
!width="125px"|Units
+
!width="80px"|Wildcards
+
!width="150px"|Simulations
+
!width="100px"|[[List of diagnostics archived to bpch format|Bpch equiv.]]
+
!width="150px"|Notes
+
 
+
|-valign="top"
+
|JNoon_<spcname>
+
|Photolysis rates (archived where it is local noon)
+
|1/s
+
|
+
*?PHO?
+
|
+
*all fullchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND22:_Photolysis_diagnostics|ND22]]
+
|
+
*Currently debgugging an issue with locating the nearest box to noontime.
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 21:07, 16 May 2018 (UTC)
+
 
+
=== The LevelEdgeDiags collection ===
+
 
+
The '''LevelEdgeDiags''' collection contains diagnostics for quantities (mostly met fields) that are defined on the vertical edges of each grid box.  According to the COARDS convention, all of the data variables in a netCDF file must be defined with the same vertical dimension.
+
 
+
Here is a sample definition section for the LevelEdgeDiags collection.  If this collection is not already present in the <tt>HISTORY.rc</tt> file in [[Creating GEOS-Chem run directories|the GEOS-Chem run directory for your selected simulation]], you can copy and paste this into your <tt>HISTORY.rc</tt> file and edit accordingly.  To prevent an individual field from being included in the diagnostic output, place a comment character <tt>#</tt> in front of the field name.
+
 
+
  LevelEdgeDiags.template:    '%y4%m2%d2_%h2%n2z.nc4',
+
  LevelEdgeDiags.format:      'CFIO',
+
  LevelEdgeDiags.frequency:  00000100 000000
+
  LevelEdgeDiags.duration:    00000100 000000
+
  LevelEdgeDiags.mode:        'time-averaged'
+
  LevelEdgeDiags.fields:      'Met_CMFMC                    ', 'GIGCchem',
+
                              'Met_PEDGE                    ', 'GIGCchem',
+
                              'Met_PEDGEDRY                  ', 'GIGCchem',
+
                              'Met_PFICU                    ', 'GIGCchem',
+
                              'Met_PFILSAN                  ', 'GIGCchem',
+
                              'Met_PFLCU                    ', 'GIGCchem',
+
                              'Met_PFLLSAN                  ', 'GIGCchem',
+
::
+
 
+
This table describes the diagnostic quantities belonging to the JValuesLocalNoon collection:
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="225px"|Diagnostic name
+
!width="225px"|Description
+
!width="125px"|Units
+
!width="80px"|Wildcards
+
!width="150px"|Simulations
+
!width="100px"|[[List of diagnostics archived to bpch format|Bpch equiv.]]
+
!width="150px"|Notes
+
 
+
|-valign="top"
+
|Met_CMFMC
+
|Upward moist convective mass flux
+
|kg/m2/s
+
|
+
|
+
*all simulations
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND66: GMAO 3-D met fields|ND66 #5]]
+
|
+
 
+
|-valign="top"
+
|Met_PEDGE
+
|Surface pressure at level edges (based on moist air)
+
|hP
+
|
+
|
+
*all simulations
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND31:_Pressure_at_model_edges|ND31 #1]]
+
|
+
 
+
|-valign="top"
+
|Met_PEDGEDRY
+
|Surface pressure at level edges (based on dry air)
+
|hP
+
|
+
|
+
*all simulations
+
|
+
|
+
 
+
|-valign="top"
+
|Met_PFICU
+
|3d flux of ice convective precipitation
+
|kg/m2/s
+
|
+
|
+
*all simulations
+
|
+
|
+
 
+
|-valign="top"
+
|Met_PFILSAN
+
|3d flux of ice non-convective precipitation
+
|kg/m2/s
+
|
+
|
+
*all simulations
+
|
+
|
+
 
+
|-valign="top"
+
|Met_PFLCU
+
|3d flux of liquid convective precipitation
+
|kg/m2/s
+
|
+
|
+
*all simulations
+
|
+
|
+
 
+
|-valign="top"
+
|Met_PFLLSAN
+
|3d flux of liquid non-convective precipitation
+
|kg/m2/s
+
|
+
|
+
*all simulations
+
|
+
|
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 21:23, 16 May 2018 (UTC)
+
 
+
=== The ProdLoss Collection ===
+
 
+
The '''ProdLoss''' collection contains chemical production and loss rates.
+
 
+
Here is a sample definition section for the ProdLoss collection.  If this collection is not already present in the <tt>HISTORY.rc</tt> file in [[Creating GEOS-Chem run directories|the GEOS-Chem run directory for your selected simulation]], you can copy and paste this into your <tt>HISTORY.rc</tt> file and edit accordingly.  To prevent an individual field from being included in the diagnostic output, place a comment character <tt>#</tt> in front of the field name.
+
 
+
''NOTE: This example is for the '''benchmark''' simulation.  Some quantities in this collection are not applicable to certain simulations.''
+
 
+
  ProdLoss.template:          '%y4%m2%d2_%h2%n2z.nc4',
+
  ProdLoss.format:            'CFIO',
+
  ProdLoss.frequency:        00000100 000000
+
  ProdLoss.duration:          00000100 000000
+
  ProdLoss.mode:              'time-averaged'
+
  ProdLoss.fields:            'Prod_?PRD?                    ', 'GIGCchem',
+
                              'ProdBCPIfromBCPO              ', 'GIGCchem',
+
                              'ProdOCPIfromOCPO              ', 'GIGCchem',
+
                              'ProdSO4fromH2O2inCloud        ', 'GIGCchem',
+
                              'ProdSO4fromO2inCloudMetal    ', 'GIGCchem',
+
                              'ProdSO4fromO3inCloud          ', 'GIGCchem',
+
                              'ProdSO4fromO3inSeaSalt        ', 'GIGCchem',
+
                              'ProdSO4fromHOBrInCloud        ', 'GIGCchem',
+
                              'ProdSO4fromSRO3              ', 'GIGCchem',
+
                              'ProdSO4fromSRHObr            ', 'GIGCchem',
+
                              'ProdSO4fromO3s                ', 'GIGCchem',
+
                              'Loss_?LOS?                    ', 'GIGCchem',
+
                              'LossHNO3onSeaSalt            ', 'GIGCchem',
+
::
+
 
+
The table below describes diagnostic quantities belonging to the ProdLoss collection.
+
 
+
''NOTE: '''All fullchem''' refers to all simulations that use [[GEOS-Chem_chemistry_mechanisms#Mechanisms_for_GEOS-Chem_v11-02|a full-chemistry mechanism]] (i.e. benchmark, complexSOA*, standard, tropchem. aciduptake, marinePOA, RRTMG, TOMAS).''
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="225px"|Diagnostic name
+
!width="225px"|Description
+
!width="125px"|Units
+
!width="80px"|Wildcards
+
!width="150px"|Simulations
+
!width="100px"|[[List of diagnostics archived to bpch format|Bpch equiv.]]
+
!width="150px"|Notes
+
 
+
|-valign=top"
+
!colspan="7" bgcolor="#CCFFFF"|Diagnostics applicable only to the aciduptake simulation
+
 
+
|-valign="top"
+
|ProdSO4fromOxidationOnDust
+
|Production of SO4 from oxidation on dust aerosols
+
|kg S/s
+
|
+
|
+
*aciduptake
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND05:_P.2FL_for_sulfate_aerosols|ND05 #12]]
+
|
+
 
+
|-valign="top"
+
|ProdNITfromHNO3uptakeOnDust
+
|Production of NIT from HNO3 uptake on dust aerosols
+
|kg N/s
+
|
+
|
+
*aciduptake
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND05:_P.2FL_for_sulfate_aerosols|ND05 #13]]
+
|
+
 
+
|-valign="top"
+
|ProdSO4fromUptakeOfH2SO4g
+
|Production of SO4 from uptake of H2SO4(g)
+
||kg S/s
+
|
+
|
+
*aciduptake
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND05:_P.2FL_for_sulfate_aerosols|ND05 #14]]
+
|
+
 
+
|-valign=top"
+
!colspan="7" bgcolor="#CCFFFF"|Diagnostics applicable only to the aerosol-only simulation
+
 
+
|-valign="top"
+
|ProdSO2fromDMSandOH
+
|Production of SO2 from DMS + OH (in sulfate_mod.F)
+
|kg S/s
+
|
+
|
+
*aerosol
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND05:_P.2FL_for_sulfate_aerosols|ND05 #1]]
+
|
+
 
+
|-valign="top"
+
|ProdSO2fromDMSandNO3
+
|Production of SO2 from DMS + NO3
+
|kg S/s
+
|
+
|
+
*aerosol
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND05:_P.2FL_for_sulfate_aerosols|ND05 #2]]
+
|
+
 
+
|-valign="top"
+
|ProdSO2fromDMS
+
|Total P(SO2) from DMS
+
|kg S/s
+
|
+
|
+
*aerosol
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND05:_P.2FL_for_sulfate_aerosols|ND05 #3]]
+
|
+
 
+
|-valign="top"
+
|ProdMSAfromDMS
+
|Production of MSA from DMS
+
|kg S/s
+
|
+
|
+
*aerosol
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND05:_P.2FL_for_sulfate_aerosols|ND05 #4]]
+
|
+
 
+
|-valign="top"
+
|ProdSO4fromGasPhase
+
|Production of SO4 in the gas phase
+
|kg S/s
+
|
+
|
+
*aerosol
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND05:_P.2FL_for_sulfate_aerosols|ND05 #5]]
+
|
+
 
+
|-valign=top"
+
!colspan="7" bgcolor="#CCFFFF"|Diagnostics applicable only to the aerosol-only and all fullchem simulations
+
 
+
|-valign="top"
+
|ProdBCPIfromBCPO
+
|Production of hydrophilic BC from hydrophobic BCs
+
|kg
+
|
+
|
+
*aerosol
+
*all fullchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND07:_BC_and_OC_sources|ND07 #4]]
+
|
+
 
+
|-valign="top"
+
|ProdOCPIfromOCPO
+
|Production of hydrophilic BC from hydrophobic BCs
+
|kg
+
|
+
|
+
*aerosol
+
*all fullchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND07:_BC_and_OC_sources|ND07 #9]]
+
|
+
 
+
|-valign="top"
+
|ProdSO4fromH2O2inCloud
+
|Production of SO4 from aqueous oxidation of H2O2 in clouds
+
|kg S/s
+
|
+
|
+
*aerosol
+
*all fullchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND05:_P.2FL_for_sulfate_aerosols|ND05 #6]]
+
|
+
 
+
|-valign="top"
+
|ProdSO4fromO2inCloudMetal
+
|Production of SO4 from aqueous oxidation of H2O2 in clouds
+
|kg S/s
+
|
+
|
+
*aerosol
+
*all fullchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND05:_P.2FL_for_sulfate_aerosols|ND05 #8]]
+
|
+
*New in v11-02
+
 
+
|-valign="top"
+
|ProdSO4fromO3inCloud
+
|Production of SO4 from aqueous oxidation of O3 in clouds
+
|kg S/s
+
|
+
|
+
*aerosol
+
*all fullchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND05:_P.2FL_for_sulfate_aerosols|ND05 #7]]
+
|
+
 
+
|-valign="top"
+
|ProdSO4fromO3inSeaSalt
+
|Production of SO4 from O3 in sea salt
+
|kg S/s
+
|
+
|
+
*aerosol
+
*all fullchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND05:_P.2FL_for_sulfate_aerosols|ND05 #9]]
+
|
+
 
+
|-valign="top"
+
|ProdSO4fromO3s
+
|Production of SO4 from aqueous phase SO3-- loss by OH
+
|kg S/s
+
|
+
|
+
*aerosol
+
*all fullchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND05:_P.2FL_for_sulfate_aerosols|ND05 #19]]
+
|
+
*New in v11-02
+
 
+
|-valign="top"
+
|ProdSO4fromSRO3
+
|Production of SO4 from sulfur production rate of O3
+
|kg S/s
+
|
+
|
+
*aerosol
+
*all fullchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND05:_P.2FL_for_sulfate_aerosols|ND05 #17]]
+
|
+
*New in v11-02
+
 
+
|-valign="top"
+
|LossHNO3onSeaSalt
+
|Loss of HNO3 on sea salt aerosols
+
|kg S/s
+
|
+
|
+
*aerosol
+
*all fullchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND07:_BC_and_OC_sources|ND07 #15]]
+
|
+
 
+
|-valign=top"
+
!colspan="7" bgcolor="#CCFFFF"|Diagnostics applicable only to full-chemistry simulations
+
 
+
|-valign="top"
+
|ProdSO4fromHOBrinCloud
+
|Production of SO4 from aqueous oxidation of HOBr in clouds
+
|kg S/s
+
|
+
|
+
*all fullchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND05:_P.2FL_for_sulfate_aerosols|ND05 #16]]
+
|
+
*New in v11-02
+
 
+
|-valign="top"
+
|ProdSO4fromSRHOBr
+
|Production of SO4 from sulfur production rate of HOBr+O3
+
|kg S/s
+
|
+
|
+
*all fullchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND05:_P.2FL_for_sulfate_aerosols|ND05 #18]]
+
|
+
*New in v11-02
+
 
+
|-valign=top"
+
!colspan="7" bgcolor="#CCFFFF"|Diagnostics for production and loss of species or chemical families (e.g. Ox)
+
 
+
|-valign="top"
+
|Prod_<spcname>
+
|Chemical production for a given species or family
+
|molec/cm3/s
+
|
+
*?PRD?
+
|
+
*all fullchem
+
*tagCO
+
*tagO3
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND65:_Chemical_production_and_loss_diagnostics|ND65]]
+
|
+
 
+
|-valign="top"
+
|Loss_<spcname>
+
|Chemical loss for a given species or family
+
|molec/cm3/s
+
|
+
*?LOS?
+
|
+
*all fullchem
+
*tagCO
+
*tagO3
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND65:_Chemical_production_and_loss_diagnostics|ND65]]
+
|
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 19:25, 17 May 2018 (UTC)
+
 
+
=== The StateChm Collection ===
+
 
+
The '''StateChm ''' collection contains quantities from <tt>State_Chm</tt>, the Chemistry state object (other than the species concentrations, which are stored in the SpeciesConc collection). 
+
 
+
Here is a sample definition section for the StateChm collection.  If this collection is not already present in the <tt>HISTORY.rc</tt> file in [[Creating GEOS-Chem run directories|the GEOS-Chem run directory for your selected simulation]], you can copy and paste this into your <tt>HISTORY.rc</tt> file and edit accordingly.  To prevent an individual field from being included in the diagnostic output, place a comment character <tt>#</tt> in front of the field name.
+
 
+
Other fields of the <tt>State_Chm</tt> object can be added to this collection by prefixing the field name with <tt>Chem_</tt>.
+
 
+
  StateChm.template:          '%y4%m2%d2_%h2%n2z.nc4',
+
  StateChm.format:            'CFIO',
+
  StateChm.frequency:        00000100 000000
+
  StateChm.duration:          00000100 000000
+
  StateChm.mode:              'time-averaged'
+
  StateChm.fields:            'Chem_phSav                    ', 'GIGCchem', 
+
                              'Chem_HplusSav                ', 'GIGCchem', 
+
                              'Chem_WaterSav                ', 'GIGCchem', 
+
                              'Chem_SulRatSav                ', 'GIGCchem', 
+
                              'Chem_NaRatSav                ', 'GIGCchem', 
+
                              'Chem_AcidPurSav              ', 'GIGCchem', 
+
                              'Chem_BiSulSav                ', 'GIGCchem',
+
                              'Chem_pHCloud                  ', 'GIGCchem',
+
                              'Chem_SSAlk',                  ', 'GIGCchem',
+
                              'Chem_HSO3AQ                  ', 'GIGCchem',
+
                              'Chem_SO3AQ                    ', 'GIGCchem',
+
                              'Chem_fupdateHOBr              ', 'GIGCchem',
+
::
+
 
+
The table below describes diagnostic quantities belonging to the StateChm collection.
+
 
+
''NOTE: '''All fullchem''' refers to all simulations that use [[GEOS-Chem_chemistry_mechanisms#Mechanisms_for_GEOS-Chem_v11-02|a full-chemistry mechanism]] (i.e. benchmark, complexSOA*, standard, tropchem. aciduptake, marinePOA, RRTMG, TOMAS).''
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="225px"|Diagnostic name
+
!width="225px"|Description
+
!width="125px"|Units
+
!width="80px"|Wildcards
+
!width="150px"|Simulations
+
!width="100px"|[[List of diagnostics archived to bpch format|Bpch equiv.]]
+
!width="150px"|Notes
+
 
+
|-valign="top"
+
|Chem_phSav
+
|ISORROPIA aerosol pH
+
|1
+
|
+
|
+
*all fullchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND73:_ISORROPIA_diagnostics|ND73 #1]]
+
|
+
 
+
|-valign="top"
+
|Chem_HplusSav
+
|ISORROPIA H+ concentration
+
|M
+
|
+
|
+
*all fullchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND73:_ISORROPIA_diagnostics|ND73 #2]]
+
|
+
 
+
|-valign="top"
+
|Chem_WaterSav
+
|ISORROPIA aerosol water
+
|&mu;g/m3
+
|
+
|
+
*all fullchem
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND73:_ISORROPIA_diagnostics|ND73 #3]]
+
|
+
 
+
|-valign="top"
+
|Chem_SulRatSav
+
|ISORROPIA sulfate concentration
+
|M
+
|
+
|
+
*all fullchem
+
|
+
|
+
 
+
|-valign="top"
+
|Chem_NaRatSav
+
|ISORROPIA Na+ concentration
+
|M
+
|
+
|
+
*all fullchem
+
|
+
|
+
 
+
|-valign="top"
+
|Chem_AcidPurSav
+
|ISORROPIA acidpur ?? concentration
+
|M
+
|
+
|
+
*all fullchem
+
|
+
|
+
 
+
|-valign="top"
+
|Chem_BiSulSav
+
|ISORROPIA bisulfate (general acid) concentration
+
|M
+
|
+
|
+
*all fullchem
+
|
+
|
+
 
+
|-valign="top"
+
|Chem_phCloud
+
|Cloud PH
+
|1
+
|
+
|
+
*all fullchem
+
|
+
|
+
*New in v11-02
+
 
+
|-valign="top"
+
|Chem_SSAlk
+
|Sea salt alkalinity
+
|1
+
|
+
|
+
*all fullchem
+
|
+
|
+
*New in v11-02
+
 
+
|-valign="top"
+
|Chem_HSO3AQ
+
|Cloud bisulfite concentration
+
|mol/L
+
|
+
|
+
*all fullchem
+
|
+
|
+
*New in v11-02
+
 
+
|-valign="top"
+
|Chem_SO3AQ
+
|Cloud sulfite concentration
+
|mol/L
+
|
+
|
+
*all fullchem
+
|
+
|
+
*New in v11-02
+
 
+
|-valign="top"
+
|Chem_fupdateHOBr
+
|Correction factor for HOBr removal by SO2
+
|mol/L
+
|
+
|
+
*all fullchem
+
|
+
|
+
*New in v11-02
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 19:55, 17 May 2018 (UTC)
+
 
+
=== The StateMet collection ===
+
 
+
The '''StateMet''' collection contains met fields and other derived quantities that are carried in the <tt>State_Met</tt> object.
+
 
+
Here is a sample definition section for the '''StateMet''' collection.  If this collection is not already present in the <tt>HISTORY.rc</tt> file in [[Creating GEOS-Chem run directories|the GEOS-Chem run directory for your selected simulation]], you can copy and paste this into your <tt>HISTORY.rc</tt> file and edit accordingly.  To prevent an individual field from being included in the diagnostic output, place a comment character <tt>#</tt> in front of the field name.
+
 
+
Other fields of the <tt>State_Met</tt> object can be added to this collection by prefixing the field name with <tt>Met_</tt>.
+
 
+
  StateMet.template:          '%y4%m2%d2_%h2%n2z.nc4',
+
  StateMet.format:            'CFIO',
+
  StateMet.frequency:        00000100 000000
+
  StateMet.duration:          00000100 000000
+
  StateMet.mode:              'time-averaged'
+
  StateMet.fields:            'Met_AD                        ', 'GIGCchem',
+
                              'Met_AIRDEN                    ', 'GIGCchem',
+
                              'Met_AIRVOL                    ', 'GIGCchem',
+
                              'Met_ALBD                      ', 'GIGCchem',
+
                              'Met_AREAM2                    ', 'GIGCchem',
+
                              'Met_AVGW                      ', 'GIGCchem',
+
                              'Met_BXHEIGHT                  ', 'GIGCchem',
+
                              'Met_ChemGridLev              ', 'GIGCchem',
+
                              'Met_CLDF                      ', 'GIGCchem',
+
                              'Met_CLDFRC                    ', 'GIGCchem',
+
                              'Met_CLDTOPS                  ', 'GIGCchem',
+
                              'Met_DELP                      ', 'GIGCchem',
+
                              'Met_DQRCU                    ', 'GIGCchem',
+
                              'Met_DQRLSAN                  ', 'GIGCchem',
+
                              'Met_DTRAIN                    ', 'GIGCchem',
+
                              'Met_EFLUX                    ', 'GIGCchem',
+
                              'Met_FRCLND                    ', 'GIGCchem',
+
                              'Met_FRLAKE                    ', 'GIGCchem',
+
                              'Met_FRLAND                    ', 'GIGCchem',
+
                              'Met_FRLANDIC                  ', 'GIGCchem',
+
                              'Met_FROCEAN                  ', 'GIGCchem',
+
                              'Met_FRSEAICE                  ', 'GIGCchem',
+
                              'Met_FRSNO                    ', 'GIGCchem',
+
                              'Met_GWETROOT                  ', 'GIGCchem',
+
                              'Met_GWETTOP                  ', 'GIGCchem',
+
                              'Met_HFLUX                    ', 'GIGCchem',
+
                              'Met_LAI                      ', 'GIGCchem',
+
                              'Met_LWI                      ', 'GIGCchem',
+
                              'Met_PARDR                    ', 'GIGCchem',
+
                              'Met_PARDF                    ', 'GIGCchem',
+
                              'Met_PBLTOPL                  ', 'GIGCchem',
+
                              'Met_PBLH                      ', 'GIGCchem',
+
                              'Met_PHIS                      ', 'GIGCchem',
+
                              'Met_PMID                      ', 'GIGCchem',
+
                              'Met_PMIDDRY                  ', 'GIGCchem',
+
                              'Met_PRECANV                  ', 'GIGCchem',
+
                              'Met_PRECCON                  ', 'GIGCchem',
+
                              'Met_PRECLSC                  ', 'GIGCchem',
+
                              'Met_PRECTOT                  ', 'GIGCchem',
+
                              'Met_PS1DRY                    ', 'GIGCchem',
+
                              'Met_PS1WET                    ', 'GIGCchem',
+
                              'Met_PS2DRY                    ', 'GIGCchem',
+
                              'Met_PS2WET                    ', 'GIGCchem',
+
                              'Met_PSC2WET                  ', 'GIGCchem',
+
                              'Met_PSC2DRY                  ', 'GIGCchem',
+
                              'Met_QI                        ', 'GIGCchem',
+
                              'Met_QL                        ', 'GIGCchem',
+
                              'Met_OMEGA                    ', 'GIGCchem',
+
                              'Met_OPTD                      ', 'GIGCchem',
+
                              'Met_REEVAPCN                  ', 'GIGCchem',
+
                              'Met_REEVAPLS                  ', 'GIGCchem',
+
                              'Met_SLP                      ', 'GIGCchem',
+
                              'Met_SNODP                    ', 'GIGCchem',
+
                              'Met_SNOMAS                    ', 'GIGCchem',
+
                              'Met_SPHU                      ', 'GIGCchem',
+
                              'Met_SPHU1                    ', 'GIGCchem',
+
                              'Met_SPHU2                    ', 'GIGCchem',
+
                              'Met_SUNCOS                    ', 'GIGCchem',
+
                              'Met_SUNCOSmid                ', 'GIGCchem',
+
                              'Met_SWGDN                    ', 'GIGCchem',
+
                              'Met_T                        ', 'GIGCchem',
+
                              'Met_TAUCLI                    ', 'GIGCchem',
+
                              'Met_TAUCLW                    ', 'GIGCchem',
+
                              'Met_THETA                    ', 'GIGCchem',
+
                              'Met_TMPU1                    ', 'GIGCchem',
+
                              'Met_TMPU2                    ', 'GIGCchem',
+
                              'Met_TO3                      ', 'GIGCchem',
+
                              'Met_TropHt                    ', 'GIGCchem',
+
                              'Met_TropLev                  ', 'GIGCchem',
+
                              'Met_TropP                    ', 'GIGCchem',
+
                              'Met_TS                        ', 'GIGCchem',
+
                              'Met_TSKIN                    ', 'GIGCchem',
+
                              'Met_TV                        ', 'GIGCchem',
+
                              'Met_U                        ', 'GIGCchem',
+
                              'Met_U10M                      ', 'GIGCchem',
+
                              'Met_USTAR                    ', 'GIGCchem',
+
                              'Met_UVALBEDO                  ', 'GIGCchem',
+
                              'Met_V                        ', 'GIGCchem',
+
                              'Met_V10M                      ', 'GIGCchem',
+
                              'Met_Z0                        ', 'GIGCchem',
+
::
+
 
+
=== The WetLossConv collection ===
+
 
+
The '''WetLossConv''' collection contains diagnostics fluxes of soluble species lost to wet scaveinging in convective updrafts.
+
 
+
Here is a sample definition section for the WetLossConv collection.  If this collection is not already present in the <tt>HISTORY.rc</tt> file in [[Creating GEOS-Chem run directories|the GEOS-Chem run directory for your selected simulation]], you can copy and paste this into your <tt>HISTORY.rc</tt> file and edit accordingly.  To prevent an individual field from being included in the diagnostic output, place a comment character <tt>#</tt> in front of the field name.
+
 
+
  WetLossConv.template:      '%y4%m2%d2_%h2%n2z.nc4',
+
  WetLossConv.format:        'CFIO',
+
  WetLossConv.frequency:      00000100 000000
+
  WetLossConv.duration:      00000100 000000
+
  WetLossConv.mode:          'time-averaged'
+
  WetLossConv.fields:        'WetLossConv_?WET?            ', 'GIGCchem',
+
                              'WetLossConvFrac_?WET?        ', 'GIGCchem',
+
::
+
 
+
The table below describes diagnostic quantities belonging to the WetLossConv collection.
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="225px"|Diagnostic name
+
!width="225px"|Description
+
!width="125px"|Units
+
!width="80px"|Wildcards
+
!width="150px"|Simulations
+
!width="100px"|[[List of diagnostics archived to bpch format|Bpch equiv.]]
+
!width="150px"|Notes
+
 
+
|-valign="top"
+
|WetLossConv_<spcname>
+
|Loss of soluble species scavenged by cloud updrafts in moist convection
+
|kg/s
+
|
+
*?WET?
+
|
+
*all simulations
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND38: Loss of species by convection|ND38]]
+
|
+
 
+
|-valign="top"
+
|WetLossConvFrac_<spcname>
+
|Fraction of species scavenged by cloud updrafts in moist convection
+
|1
+
|
+
*?WET?
+
|
+
*all simulations
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND38: Loss of species by cloud updrafts in moist convection|ND37]]
+
|
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:23, 17 May 2018 (UTC)
+
 
+
=== The WetLossLS collection ===
+
 
+
The '''WetLossLS''' collection contains diagnostics fluxes of soluble species lost to rainout and washout in large-scale wet deposition.
+
 
+
Here is a sample definition section for the WetLossConv collection.  If this collection is not already present in the <tt>HISTORY.rc</tt> file in [[Creating GEOS-Chem run directories|the GEOS-Chem run directory for your selected simulation]], you can copy and paste this into your <tt>HISTORY.rc</tt> file and edit accordingly.  To prevent an individual field from being included in the diagnostic output, place a comment character <tt>#</tt> in front of the field name.
+
 
+
  WetLossLS.template:        '%y4%m2%d2_%h2%n2z.nc4',
+
  WetLossLS.format:          'CFIO',
+
  WetLossLS.frequency:        010000
+
  WetLossLS.duration:        010000
+
  WetLossLS.mode:            'time-averaged'
+
  WetLossLS.fields:          'WetLossLS_?WET?              ', 'GIGCchem',
+
::
+
 
+
The table below describes diagnostic quantities belonging to the WetLossLS collection.
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="225px"|Diagnostic name
+
!width="225px"|Description
+
!width="125px"|Units
+
!width="80px"|Wildcards
+
!width="150px"|Simulations
+
!width="100px"|[[List of diagnostics archived to bpch format|Bpch equiv.]]
+
!width="150px"|Notes
+
 
+
|-valign="top"
+
|WetLossLS_<spcname>
+
|Loss of soluble species in large-scale precipitation
+
|kg/s
+
|
+
*?WET?
+
|
+
*all simulations
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND38: Loss of species by convection|ND38]]
+
|
+
 
+
|-valign="top"
+
|WetLossConvFrac_<spcname>
+
|Fraction of species scavenged by cloud updrafts in moist convection
+
|1
+
|
+
*?WET?
+
|
+
*all simulations
+
|
+
*[[List_of_diagnostics_archived_to_bpch_format#ND38: Loss of species by cloud updrafts in moist convection|ND37]]
+
|
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:23, 17 May 2018 (UTC)
+
 
+
== Proposed diagnostic names for specialty simulations ==
+
 
+
Here is a list of our proposed netCDF diagnostic names for quantities archived in the GEOS-Chem specialty simulations.  This list is by no means exhaustive or complete. Contact [[User:bmy|Bob Yantosca]] with any suggestions or concerns.
+
 
+
=== CH4 simulation ===
+
 
+
<span style="color:darkorange">'''''NOTE: Diagnostic names are case-insensitive, but we recommend that you use mixed-case to improve readability.'''''</span>
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="250px"|Proposed diagnostic name
+
!width="200px"|Description
+
!width="100px"|replaces<br>NDXX
+
!width="100px"|with<br>CATEGORY
+
!width="100px"|and<br>TRACERS
+
!width="110px"|and<br>FREQUENCY
+
!width="275px"|from this bpch file
+
 
+
|-valign="top"
+
|<tt>LossCH4byOH</tt>
+
|CH4 removal by OH (for the CH4 specialty simualtion) [kg]
+
|ND19
+
|<tt>CH4-LOSS</tt>
+
|1
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>OHconcAfterChem</tt>
+
|OH concentration immediately after chemistry [molec/cm3]
+
|ND43
+
|<tt>CHEM-L=$</tt>
+
|1
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 18:57, 21 November 2017 (UTC)
+
 
+
=== CO2 simulation ===
+
 
+
<span style="color:darkorange">'''''NOTE: Diagnostic names are case-insensitive, but we recommend that you use mixed-case to improve readability.'''''</span>
+
 
+
<span style="color:darkorange">'''''NOTE: For consistency with the HEMCO emissions diagnostics, we propose changing the units of these diagnostics from [atoms C/cm2/s] to [kg/m2/s].'''''</span>
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="250px"|Proposed diagnostic name
+
!width="200px"|Description
+
!width="100px"|replaces<br>NDXX
+
!width="100px"|with<br>CATEGORY
+
!width="100px"|and<br>TRACERS
+
!width="110px"|and<br>FREQUENCY
+
!width="275px"|from this bpch file
+
 
+
|-valign="top"
+
|<tt>BalanceBiosph_<spcname></tt>
+
|CO2 balanced biospheres [atoms C/cm2/s]
+
 
+
NOTE: For tagged CO2 simuations you may specify all of the advected species.
+
|ND04
+
|<tt>CO2-SRCE</tt>
+
|3
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>ChemSource_<spcname></tt>
+
|CO2 chemical source [atoms C/cm2/s]
+
|ND04
+
|<tt>CO2-SRCE</tt>
+
|9
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>ChemSurfaceCorr_<spcname></tt>
+
|CO2 chemical source surface correction [atoms C/cm2/s]
+
|ND04
+
|<tt>CO2-SRCE</tt>
+
|10
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>EmisAircraft_<spcname></tt>
+
|CO2 aircraft emissions [atoms C/cm2/s]
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND04
+
|<tt>CO2-SRCE</tt>
+
|8
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>EmisAnthro_<spcname></tt>
+
|CO2 anthropogenic emissions [atoms C/cm2/s]
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND04
+
|<tt>CO2-SRCE</tt>
+
|1
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>EmisBiofuel_<spcname></tt>
+
|CO2 biofuel emissions [atoms C/cm2/s]
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND04
+
|<tt>CO2-SRCE</tt>
+
|5
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>Emis_Biomass_<spcname></tt>
+
|CO2 biomass burning emissions [atoms C/cm2/s]
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND04
+
|<tt>CO2-SRCE</tt>
+
|4
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>EmisOcean_<spcname></tt>
+
|CO2 ocean emissions [atoms C/cm2/s]
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND04
+
|<tt>CO2-SRCE</tt>
+
|2
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>EmisShip_<spcname></tt>
+
|CO2 ship emissions [atoms C/cm2/s]
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND04
+
|<tt>CO2-SRCE</tt>
+
|7
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>NetTerrExch_<spcname></tt>
+
|CO2 net terrestrial exchange [atoms C/cm2/s]
+
|ND04
+
|<tt>CO2-SRCE</tt>
+
|6
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 15:42, 15 November 2017 (UTC)
+
 
+
=== Hg simulation ===
+
 
+
<span style="color:darkorange">'''''NOTE: Diagnostic names are case-insensitive, but we recommend that you use mixed-case to improve readability.  ALSO NOTE: We will eliminate underscore characters within the variable name (except to separate the name from the species name or wildcard) at a later date.'''''</span>
+
 
+
<span style="color:darkorange">'''''NOTE: We will probably delay implementation of new diagnostics for the [[Mercury|Hg simulation]] until we receive updated Hg simulation source code from the [[Hg and POPs Working Group]].  Also we look to the Hg and POPs working group to inform us if any of these diagnostics are no longer necessary.'''''</span>
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="250px"|Proposed diagnostic name
+
!width="200px"|Description
+
!width="100px"|replaces<br>NDXX
+
!width="100px"|with<br>CATEGORY
+
!width="100px"|and<br>TRACERS
+
!width="110px"|and<br>FREQUENCY
+
!width="275px"|from this bpch file
+
 
+
|-valign="top"
+
|<tt>Emis_Anthro_Hg0</tt>
+
|Anthropogenic Hg0 emissions
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|1
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Mass_Ocean_Hg0</tt>
+
|Mass of oceanic Hg0
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|2
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>Emis_Ocean_Hg0</tt>
+
|Oceanic Hg0 emissions
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|3
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Emis_LandReem_Hg0</tt>
+
|Land Hg0 re-emission
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|4
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>Emis_Natural_Hg0</tt>
+
|Natural Hg0 emissions (from land)
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|5
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Emis_Anthro_Hg2</tt>
+
|Anthropogenic Hg2 emissions
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|6
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>Mass_Ocean_Hg2</tt>
+
|Oceanic Hg2 mass
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|7
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Sink_Ocean_Hg2</tt>
+
|Sink of Hg2 into deep ocean
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|8
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>Emis_Anthro_HgP</tt>
+
|Anthropogenic HgP emissions
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|9
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Mass_Total_Hg</tt>
+
|Mass of oceanic Hg
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|10
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>Mass_Ocean_HgP</tt>
+
|Mass of oceanic HgP
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|11
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Emis_Ocean_OC</tt>
+
|Sink of organic carbon to the ocean
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|12
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>Emis_Biomass_Hg0</tt>
+
|Hg0 emissions from biomass burning
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|13
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Emis_Vegetation_Hg0</tt>
+
|Hg0 emissions from vegetation
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|14
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>Emis_Soil_Hg0</tt>
+
|Hg0 emissions from soils
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|15
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Hg0_Flux_from_Ocean</tt>
+
|Upwelling flux of Hg0 volatized from the ocean
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|16
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>Hg0_Flux_to_Ocean</tt>
+
|Drydep flux of Hg0 to the ocean
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|17
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Emis_Snow_Hg</tt>
+
|Emission of Hg from snowpack
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|18
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>Hg2_Prod_from_Hg0</tt>
+
|Production of Hg2 from Hg0
+
|ND03
+
|<tt>PL-HG2-$</tt>
+
|19
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Hg2_Prod_from_OH</tt>
+
|Production of Hg2 from rxn with OH
+
|ND03
+
|<tt>PL-HG2-$</tt>
+
|20
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>Hg2_Prod_from_O3</tt>
+
|Production of Hg2 from rxn with O3
+
|ND03
+
|<tt>PL-HG2_$</tt>
+
|21
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Hg2_Loss_by_Seasalt</tt>
+
|Loss of Hg2 from reaction with sea salt
+
|ND03
+
|<tt>PL-HG2-$</tt>
+
|22
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>RxnRate_Seasalt_Hg2</tt>
+
|Loss rate of Hg2 from rxn with sea salt
+
|ND03
+
|<tt>PL-HG2-$</tt>
+
|23
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Br2_Prod_from_Br</tt>
+
|Production of Br2 from Br
+
|ND03
+
|<tt>PL-Hg2-$</tt>
+
|24
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>Concentration_Br</tt>
+
|Br concentration<br><span style="color:red">'''''NOTE: We can probably get this from the species concentration diagnostic; maybe no need to replicate it here.'''''</span>
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|25
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Concentration_BrO</tt>
+
|BrO concentration<br><span style="color:red">'''''NOTE: We can probably get this from the species concentration diagnostic; maybe no need to replicate it here.'''''</span>
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|26
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>Concentration_HgP</tt>
+
|Particulate bound mercury
+
 
+
<span style="color:red">'''''NOTE: Is this any different from the HgP species?''''</span>
+
|ND03
+
|<tt>PL-HG2-$</tt>
+
|27
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Concentratioin_RGM</tt>
+
|Reactive gaseous mercury
+
 
+
<span style="color:red">'''''NOTE: Can this be obtained by summing Hg0 + Hg2?''''</span>
+
|ND03
+
|<tt>PL-HG2-$</tt>
+
|28
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Mass_Ocean_Hg0</tt>
+
|Mass of oceanic Hg0
+
 
+
<span style="color:red">'''''Is this needed anymore? Does the Hg simulation still need the slab ocean?'''''</span>
+
|ND03
+
|<tt>OCEAN-HG</tt>
+
|29
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Mass_Ocean_Hg2</tt>
+
|Mass of oceanic Hg2
+
 
+
<span style="color:red">'''''Is this needed anymore? Does the Hg simulation still need the slab ocean?'''''</span>
+
|ND03
+
|<tt>OCEAN-Hg</tt>
+
|30
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>Mass_Ocean_HgP</tt>
+
|Mass of oceanic Hg
+
 
+
<span style="color:red">'''''Is this needed anymore? Does the Hg simulation still need the slab ocean?'''''</span>
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|31
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Mass_SnowPack_Hg</tt>
+
|Mass of Hg in snowpack
+
 
+
<span style="color:red">'''''Is this needed anymore? Does the Hg simulation still need the slab ocean?'''''</span>
+
|ND03
+
|<ttOCEAN_Hg</tt>
+
|32
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 16:57, 20 October 2017 (UTC)
+
 
+
=== POPs simulation ===
+
 
+
<span style="color:darkorange">'''''NOTE: Diagnostic names are case-insensitive, but we recommend that you use mixed-case to improve readability.'''''</span>
+
 
+
<span style="color:darkorange">'''''NOTE: We will probably delay implementation of new diagnostics for the [[POPs simulation]] until we receive updated Hg simulation source code from the [[Hg and POPs Working Group]].'''''</span>
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="250px"|Proposed diagnostic name
+
!width="200px"|Description
+
!width="100px"|replaces<br>NDXX
+
!width="100px"|with<br>CATEGORY
+
!width="100px"|and<br>TRACERS
+
!width="110px"|and<br>FREQUENCY
+
!width="275px"|from this bpch file
+
 
+
|-valign="top"
+
|<tt>Emis_POP</tt>
+
|Total POPs emissions
+
|ND53
+
|<tt>PG-SRCE</tt>
+
|1
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Emis_POPOC</tt>
+
|POP OC emissions
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND53
+
|<tt>PG-SRCE</tt>
+
|2
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>Emis_POPBC</tt>
+
|POP BC emissions
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND53
+
|<tt>PG-SRCE</tt>
+
|3
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Emis_POPG</tt>
+
|Gas-phase POPs emissions
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND53
+
|<tt>PG-SRCE</tt>
+
|4
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>Emis_Soil_POP</tt>
+
|Secondary emissions from soil
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND53
+
|<tt>PG-SRCE</tt>
+
|5
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Emis_Lake_POP</tt>
+
|Secondary emissions from lakes
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND53
+
|<tt>PG-SRCE</tt>
+
|6
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>Emis_Vegetation_POP</tt>
+
|Secondary emissions from vegetation (leaves)
+
 
+
<span style="color:red">'''''NOTE: Could we use HEMCO's diagnostic capability to archive this?'''''</span>
+
|ND53
+
|<tt>PG-SRCE</tt>
+
|7
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>FluxFromSoil_Pos_POP</tt>
+
|Secondary positive soil flux
+
|ND53
+
|<tt>PG-SRCE</tt>
+
|8
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>FluxFromSoil_Neg_POP</tt>
+
|Secondary negative soil flux
+
|ND53
+
|<tt>PG-SRCE</tt>
+
|9
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>FluxFromLake_Pos_POP</tt>
+
|Secondary positive lake flux
+
|ND53
+
|<tt>PG-SRCE</tt>
+
|10
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>FluxFromLake_Neg_POP</tt>
+
|Secondary negative lake flux
+
|ND53
+
|<tt>PG-SRCE</tt>
+
|11
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>FluxFromVegetation_Pos_POP</tt>
+
|Secondary positive vegetation flux
+
|ND53
+
|<tt>PG-SRCE</tt>
+
|12
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>FluxFromVegetation_Neg_POP</tt>
+
|Secondary negative leaf flux
+
|ND53
+
|<tt>PG-SRCE</tt>
+
|13
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Fugacity_Soil_Air</tt>
+
|Fugacity ratio: soil / air
+
|ND53
+
|<tt>PG-SRCE</tt>
+
|14
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>Fugacity_Lake_Air</tt>
+
|Fugacity ratios: lake/air
+
|ND53
+
|<tt>PG-SRCE</tt>
+
|15
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Fugacity_Leaf_Air</tt>
+
|Fugacity ratios: leaf/air
+
|ND53
+
|<tt>PG-SRCE</tt>
+
|16
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>POPOC_Loss_to_Gas</tt>
+
|Gross POPOC lost to gas
+
|ND53
+
|<tt>PG-PP</tt>
+
|17
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>POPOC_Prod_from_Gas</tt>
+
|Gross POPOC formed from gas
+
|ND53
+
|<tt>PG-PP</tt>
+
|18
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>POPBC_Loss_to_Gas</tt>
+
|Gross POPBC lost to gas
+
|ND53
+
|<tt>PG-PP</tt>
+
|19
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>POPBC_Prod_from_Gas</tt>
+
|Gross POPBC formed from gas
+
|ND53
+
|<tt>PG-PP</tt>
+
|20
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>POPG_Prod_from_OH</tt>
+
|Production of oxidized POPG from reaction with OH
+
|ND53
+
|<tt>PG-PP</tt>
+
|21
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>POPPOCPO_Prod_from_O3</tt>
+
|Production of oxidized POPPOCPO from reaction with O3
+
|ND53
+
|<tt>PG-PP</tt>
+
|22
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>POPPPOCPI_Prod_from_O3</tt>
+
|Production of oxidized POPPOCPI from reaction with O3
+
|ND53
+
|<tt>PG-PP</tt>
+
|23
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>POPPBCPO_Prod_from_O3</tt>
+
|Production of oxidized POPPBCPO from reaction with O3
+
|ND53
+
|<tt>PG-PP</tt>
+
|24
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>POPPBCPI_Prod_from_O3</tt>
+
|Production of oxidized POPBCPI from reaction with O3
+
|ND53
+
|<tt>PG-PP</tt>
+
|25
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>POPPOCPO_Prod_from_NO3</tt>
+
|Production of oxidized POPPOCPO from reaction with NO3
+
|ND53
+
|<tt>PG-PP</tt>
+
|26
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>POPPOCPI_Prod_from_NO3</tt>
+
|Production of oxidized POPPOCPI from reaction with NO3
+
|ND53
+
|<tt>PG-PP</tt>
+
|27
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>POPPBCPO_Prod_from_NO3</tt>
+
|Production of oxidized POPPBCPO from reaction with NO3
+
|ND53
+
|<tt>PG-PP</tt>
+
|28
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>POPPBCPI_Prod_from_NO3</tt>
+
|Production of oxidized POPPBCPI from reaction with NO3
+
|ND53
+
|<tt>PG-PP</tt>
+
|29
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 17:02, 20 October 2017 (UTC)
+
 
+
=== Rn-Pb-Be simulation ===
+
 
+
<span style="color:darkorange">'''''NOTE: Diagnostic names are case-insensitive, but we recommend that you use mixed-case to improve readability.'''''</span>
+
 
+
<span style="color:darkorange">'''''NOTE: We propose changing the units of emissions diagnostics from [kg/s] to the area-independent units [kg/m2/s], and decay diagnostics from [kg/s] to the area-independent units [kg/m3/s].'''''</span>
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="250px"|Proposed diagnostic name
+
!width="200px"|Description
+
!width="100px"|replaces<br>NDXX
+
!width="100px"|with<br>CATEGORY
+
!width="100px"|and<br>TRACERS
+
!width="110px"|and<br>FREQUENCY
+
!width="275px"|from this bpch file
+
 
+
|-valign="top"
+
|<tt>EMIS_Be7_COSMIC</tt>
+
|Source of Be<sup>7</sup> by cosmic rays [kg/m2/s]<br><span style="color:red">'''''(Archived by HEMCO)'''''</span>
+
|ND02
+
|<tt>RN--SRCE</tt>
+
|3
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>EMIS_Rn_SOIL</tt>
+
|Emission of Rn<sup>222</sup> from soils [kg/m2/s]<br><span style="color:red">'''''(Archived by HEMCO)'''''</span>
+
|ND01
+
|<tt>RN--SRCE</tt>
+
|1
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>PbFromRadDecay</tt>
+
|Emission of Pb<sup>210</sup> from Rn<sup>222</sup> decay [kg/s]
+
|ND01
+
|<tt>RN--SRCE</tt>
+
|2
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>RadDecay_<spcname></tt>
+
|Radioactive decay of Rn, Pb, or Be<sup>7</sup> [kg/s]
+
|ND02
+
|<tt>RN-DECAY</tt>
+
|1-3
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:38, 14 November 2017 (UTC)
+
 
+
=== RRTMG radiative transfer model ===
+
 
+
<span style="color:darkorange">'''''NOTE: Diagnostic names are case-insensitive, but we recommend that you use mixed-case to improve readability.'''''</span>
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="250px"|Proposed diagnostic name
+
!width="200px"|Description
+
!width="100px"|replaces<br>NDXX
+
!width="100px"|with<br>CATEGORY
+
!width="100px"|and<br>TRACERS
+
!width="110px"|and<br>FREQUENCY
+
!width="275px"|from this bpch file
+
 
+
|-valign="top"
+
|<tt>RadAllSkyLWSurf</tt>
+
|All-sky long-wave radiation @ surface [W/m2]
+
|ND72
+
|<tt>RADMAP-$</tt>
+
|4
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>RadAllSkyLWTOA</tt>
+
|All-sky long-wave radiation @ top of atm [W/m2]
+
|ND72
+
|<tt>RADMAP-$</tt>
+
|3
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>RadAllSkySWSurf</tt>
+
|All-sky short-wave radiation @ surface [W/m2]
+
|ND72
+
|<tt>RADMAP-$</tt>
+
|2
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>RadAllSkySWTOA</tt>
+
|All-sky short-wave radiation @ top of atm [W/m2]
+
|ND72
+
|<tt>RADMAP-$</tt>
+
|1
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>RadClrSkyLWSurf</tt>
+
|Clear-sky long-wave radiation @ surface [W/m2]
+
|ND72
+
|<tt>RADMAP-$</tt>
+
|8
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>RadClrSkyLWTOA</tt>
+
|Clear-sky long-wave radiation @ top of atm [W/m2]
+
|ND72
+
|<tt>RADMAP-$</tt>
+
|7
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>RadClrSkySWSurf</tt>
+
|Clear-sky short-wave radiation @ surface [W/m2]
+
|ND72
+
|<tt>RADMAP-$</tt>
+
|6
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>RadClrSkySWTOA</tt>
+
|Clear-sky short-wave radiation @ top of atm [W/m2]
+
|ND72
+
|<tt>RADMAP-$</tt>
+
|5
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 15:44, 2 November 2017 (UTC)
+
 
+
=== TOMAS aerosol microphysics ===
+
 
+
<span style="color:darkorange">'''''NOTE: Diagnostic names are case-insensitive, but we recommend that you use mixed-case to improve readability.'''''</span>
+
 
+
<span style="color:darkorange">'''''NOTE: We invite the TOMAS team to review these diagnostic names for accuracy.'''''</span>
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="250px"|Proposed diagnostic name
+
!width="200px"|Description
+
!width="100px"|replaces<br>NDXX
+
!width="100px"|with<br>CATEGORY
+
!width="100px"|and<br>TRACERS
+
!width="110px"|and<br>FREQUENCY
+
!width="275px"|from this bpch file
+
 
+
|-valign="top"
+
|<tt>RateCond_<spcname></tt>
+
|Condensation rate
+
|ND60
+
|<tt>TMS-COND</tt>
+
|1-nTomas
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>RateCoag_<spcname></tt>
+
|Coagulation rate
+
|ND60
+
|<tt>TMS-COAG</tt>
+
|1-nTomas
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>RateNucl_<spcname></tt>
+
|Nucleation rate
+
|ND60
+
|<tt>TMS-NUCL</tt>
+
|1-nTomas
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>RateAqOx_<spcname></tt>
+
|Aqueous oxidation rate
+
|ND60
+
|<tt>TMS-NUCL</tt>
+
|1-nTomas
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>ErrorAccumFix_<spcname></tt>
+
|Accumulated error fixed
+
|ND60
+
|<tt>AERO-FIX</tt>
+
|1-nTomas
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>RateCond_SOA</tt>
+
|SOA condensation rate
+
|ND60
+
|<tt>TMS-SOA</tt>
+
|1-nTomas
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>Rate3dForm</tt>
+
|Formation of particles with a diameter > 10nm
+
|ND61
+
|<tt>TOMAS-3D</tt>
+
|1
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Rate3dNucl</tt>
+
|Nucleation rate (cluster size)
+
|ND61
+
|<tt>TOMAS-3D</tt>
+
|2
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:43, 14 November 2017 (UTC)
+
 
+
== Diagnostics that are currently archived by HEMCO ==
+
 
+
The following is a list of diagnostics that are archived by HEMCO.  Usually, these diagnostics are written to the bpch file <tt>trac_avg_YYYYMMDDhhmm.bpch</tt>.  But they can also be sent to the <tt>HEMCO_diagnostics.YYYYMMDDhhmm.nc</tt> file if you list them specifically in the <tt>HEMCO_Diagnostics.rc</tt> file.
+
 
+
We will preserve the HEMCO diagnostic naming structure for the time being.
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="250px"|Current HEMCO diagnostic name
+
!width="200px"|Description
+
!width="100px"|saved to<br>NDXX
+
!width="100px"|with<br>CATEGORY
+
!width="100px"|and<br>TRACERS
+
!width="110px"|and<br>FREQUENCY
+
 
+
|-valign="top"
+
|rowspan="8"|<tt>EMIS_<spcname>_ANTH</tt>
+
|rowspan="8"|Anthropogenic emissions [kg/m2/s]
+
|ND36
+
|<tt>ANTHSRCE</tt>
+
|NO, CO, ALK4, ACET, MEK, ALD2, RCHO, MACR, PRPE, C3H8, CH2O, C2H6, NO2, HNO2, BENZ, TOLU, XYLE, EOH
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|Hg0, Hg2, HgP
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|ND04
+
|<tt>CO2-SRCE</tt>
+
|CO2
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|ND07
+
|<tt>BC-ANTH</tt><br><tt>OC-ANTH</tt>
+
|BCPI, BCPO<br>OCPI, OCPO
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|ND13
+
|<tt>SO2-AN-$</tt><br><tt>SO4-AN-$</tt><br><tt>NH3-AN-$</tt>
+
|SO2<br>SO4<br>NH3
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|ND29
+
|<tt>CO--SRCE</tt>
+
|CO
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|ND32
+
|<tt>NO-AN-$</tt>
+
|NO
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|ND58
+
|<tt>CH4-EMIS</tt>
+
|CH4
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|rowspan="7"|<tt>EMIS_<spcname>_BIOF</tt>
+
|rowspan="7"|Biofuel emissions [kg/m2/s]
+
 
+
<span style="color:red">'''''NOTE: some emissions inventories lump biofuel emissions in with the anthropogenic emissions.  For these inventories, the anthropogenic emissions diagnostics will contain the contribution from biofuels, and the biofuel emissions diagnostics will be zeroed out.'''''</span>
+
|ND34
+
|<tt>BIOFSRCE</tt>
+
|NO, CO, ALK4, ACET, MEK, ALD2, RCHO, MACR, PRPE, C3H8, CH2O, C2H6, NO2, HNO2, BENZ, TOLU, XYLE, EOH
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|ND04
+
|<tt>CO2-SRCE</tt>
+
|CO2
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|ND07
+
|<tt>BC-BIOF</tt><br><tt>OC-BIOF</tt>
+
|BCPI, BCPO<br>OCPI, OCPO
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|ND13
+
|<tt>SO2-BIOF</tt><br><tt>SO4-BIOF</tt><br><tt>NH3-BIOF</tt>
+
|SO2<br>SO4<br>NH3
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|ND29
+
|<tt>CO--SRCE</tt>
+
|CO
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|ND32
+
|<tt>NO-BIOF</tt>
+
|NO
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|ND58
+
|<tt>CH4-EMIS</tt>
+
|CH4
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|rowspan="8"|<tt>EMIS_<spcname>_BIOB</tt>
+
|rowspan="8"|Biomass burning emissions [kg/m2/s]
+
|ND28
+
|<tt>BIOBSRCE</tt>
+
|NO, CO, ALK4, ACET, MEK, ALD2, PRPE, C3H8, CH2O, C2H6, SO2, NH3, BC, OC, CH4, BENZ, TOLU, XYLE, EOH, MGLY
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|Hg0
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|ND04
+
|<tt>CO2-SRCE</tt>
+
|CO2
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|ND07
+
|<tt>BC-BIOB</tt><br><tt>OC-BIOB</tt>
+
|BCPI<br>OCPI
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|ND13
+
|<tt>SO2-BIOB</tt><br><tt>NH3-BIOB</tt>
+
|SO2<br>NH3
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|ND29
+
|<tt>CO--SRCE</tt>
+
|CO
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|ND32
+
|<tt>NO-BIOB</tt>
+
|NO
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|ND58
+
|<tt>CH4-EMIS</tt>
+
|CH4
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|rowspan="3"|<tt>EMIS_<spcname>_BIOG</tt>
+
|rowspan="3"|Biogenic emissions [kg/m2/s]
+
|ND46
+
|<tt>BIOGSRCE</tt>
+
|ISOP, ACET, PRPE, MONX, MBOX, C2H4, APIN, BPIN, LIMO, SABI, MYRC, CARE, OCIM, FAXX, AAXX, ALD2, OMON, MOHX, EOH, FARN, BCAR, OSQT
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|ND07
+
|<tt>OC-BIOG</tt>
+
|OCPI
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|ND11
+
|<tt>ACETSRCE</tt>
+
|ACET
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|rowspan="4"|<tt>EMIS_<spcname>_NATU</tt>
+
|rowspan="4"|Natural emissions [kg/m2/s]
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|Hg0
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|ND13
+
|<tt>NH3-NATU</tt>
+
|NH3
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|ND06
+
|<tt>DSTSRCE</tt>
+
|DST1-4
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|ND08
+
|<tt>SALTSRCE</tt>
+
|SALA, SALC
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|rowspan="4"|<tt>EMIS_<spcname>_SHIP</tt>
+
|rowspan="4"|Ship emissions [kg/m2/s]
+
|ND04
+
|<tt>CO2-SRCE</tt>
+
|CO2
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|ND13
+
|<tt>SO2-SHIP</tt>
+
|SO2
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|ND29
+
|<tt>CO--SRCE</tt>
+
|CO
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|ND32
+
|<tt>NO-AN-$</tt>
+
|NO
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|rowspan="4"|<tt>EMIS_<spcname>_AIRC</tt>
+
|rowspan="4"|Aircraft emissions [kg/m2/s]
+
|ND04
+
|<tt>CO2-SRCE</tt>
+
|CO2
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|ND13
+
|<tt>SO2-AC-$</tt>
+
|SO2
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|ND29
+
|<tt>CO--SRCE</tt>
+
|CO
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|ND32
+
|<tt>NO-AC-$</tt>
+
|NO
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|rowspan="5"|<tt>EMIS_<spcname>_OCEAN</tt>
+
|rowspan="5"|Emissions from oceans [kg/m2/s]
+
|ND03
+
|<tt>HG-SRCE</tt>
+
|Hg0, Hg2, HgP
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|ND04
+
|<tt>CO2-SRCE</tt>
+
|CO2
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|ND11
+
|<tt>ACETSRCE</tt>
+
|ACET
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|ND13
+
|<tt>DMS-BIOG</tt>
+
|DMS
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|ND46
+
|<tt>BIOGSRCE</tt>
+
|ALD2, CHBr3, CH2Br2
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|<tt>EMIS_<spcname>_SEN</tt>
+
|Emissions from senescing plants
+
|ND46
+
|<tt>BIOGSRCE</tt>
+
|ALD2, EOH
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>EMIS_<spcname>_EVOL</tt>
+
|Emissions from eruptive volcanoes
+
|ND13
+
|<tt>SO2-EV-$</tt>
+
|SO2
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|<tt>EMIS_<spcname>_NVOL</tt>
+
|Emissions from degassing (non-eruptive) volcanoes
+
|ND13
+
|<tt>SO2-NV-$</tt>
+
|SO2
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>EMIS_<spcname>_FERT</tt>
+
|Fertilizer emissions
+
|ND32
+
|<tt>NO-FERT</tt>
+
|NO
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|rowspan="2"|<tt>EMIS_<spcname>_SOIL</tt>
+
|rowspan="2"|Soil emissions [kg/m2/s]
+
|ND32
+
|<tt>NO-SOIL</tt>
+
|NO
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|ND01
+
|<tt>RN--SRCE</tt>
+
|Rn
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>EMIS_<spcname>_LGHTN</tt>
+
|Lightning emissions [kg/m2/s]
+
|ND32
+
|<tt>NO-LI-$</tt>
+
|NO
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|rowspan="2"|<tt>EMIS_<spcname>_MONO</tt>
+
|rowspan="2"|Produced from monoterpenes [kg/m2/s]
+
|ND11
+
|<tt>ACETSRCE</tt>
+
|ACET
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|ND29
+
|<tt>CO--SRCE</tt>
+
|CO
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>EMIS_ACET_MBO</tt>
+
|Acetone emissions from methyl butenol [kg/m2/s]
+
|ND11
+
|<tt>ACETSRCE</tt>
+
|ACET
+
|Daily<br>Monthly
+
 
+
|-valign="top"
+
|<tt>EMIS_Be7_COSMIC</tt>
+
|Source of Be<sup>7</sup> from cosmic rays [kg/m2/s]
+
|ND01
+
|<tt>RN--SRCE</tt>
+
|Be7
+
|Daily<br>Monthly
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>EMIS_<spcname>_TOTAL</tt>
+
|Total emissions [kg/m2/s]
+
|
+
|<tt></tt>
+
|1-nEmis
+
|Daily<br>Monthly
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 14:16, 19 October 2017 (UTC)
+
 
+
== Replicating the existing specialty diagnostics ==
+
 
+
Here we discuss our plans to replicate specialty diagnostic outputs (timeseries, local-time diagnostics, etc.) in the new GEOS-Chem netCDF diagnostic package.
+
 
+
<span style="color:darkorange">'''''NOTE: We will NOT retire the legacy bpch diagnostics in [[GEOS-Chem v11-02]].  We will preserve the bpch diagnostic output until we can find alternatives for specialty diagnostics, especially those which involve averaging in a local solar time window.'''''</span>
+
 
+
=== ND40 planeflight diagnostic ===
+
 
+
'''''Tomas Sherwen wrote:'''''
+
 
+
<blockquote>Please could I ask if there is s position on/plan for restoring the chemical rate tracking (<tt>REA_??</tt>) functionality  of the planeflight diagnostic?
+
 
+
In v11-01/ v11-02d <tt>REA_??</tt> has been deactivated due to [[FlexChem]].
+
 
+
I use this functionality (and I suspect many others do) for tracking rates (e.g. JNO2) along plane/ship/station tracks/timeseries at instrument resolution.</blockquote>
+
 
+
'''''[[User:Melissa Payer|Melissa Sulprizio]] replied:'''''
+
 
+
<blockquote>Yes, we will eventually restore the chemical rates in the planeflight diagnostic. One issue is that we're currently developing netCDF diagnostics and that will mess up the planeflight diagnostics even more. Bob wrote to the GCSC:
+
 
+
<blockquote>For the “planeflight” diagnostic, we will investigate using a separate package (such as NOAA ObsPack, as recommended by Andy Jacobsen at IGC8) that can more efficiently store point data.  Then new diagnostic package we are developing works well for array data but not as well for point data.</blockquote>
+
 
+
Once the netCDF diagnostics are in place, we will reconsider how to fix/update planeflight_mod.F. If you need these diagnostics in the meantime, you should be able to hack it into the chemical mechanism by adding dummy species to the reactions you want to track and then rebuilding the mechanism based on these instructions. In flexchem_mod.F90, you can then obtain the rate from KPP using the C array (e.g. <tt>Rate = C(ind_NEWSPC) / DT</tt> to get molec/cm3/s).</blockquote>
+
 
+
'''''[[User:Mje|Mat Evans]] replied:'''''
+
 
+
<blockquote>I’ve had a quick look at obspack. I’m not sure its well suited to our needs.</blockquote>
+
 
+
<blockquote>I personally don’t see much need to update the plane flight files. They are easy to understand at the moment and easy to manipulate being in ascii. The biggest problem at the moment is that the rate constants have fallen out of them because of the move to FlexChem. If we can get that sorted I don’t think there is a pressing need to update the format.</blockquote>
+
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 16:20, 15 November 2017 (UTC)
+
 
+
=== ND48 station diagnostics ===
+
 
+
We will keep the current ND48 station diagnostics (bpch format) in [[GEOS-Chem v11-02]] until we can find a suitable replacement.
+
 
+
'''''[[User:Jaf|Jenny Fisher]] wrote:'''''
+
 
+
<blockquote>It seems we are losing compatibility for both ND48 (station) and ND51 (satellite) diagnostics. These are probably the two my group uses most frequently (and replacing with e.g. hourly output everywhere will require a lot of extra disk space). If we are going to have regional subsetting of diagnostics available, then ND48 can probably be dealt with by subsetting down to the level of a single box – but ND51 is harder.</blockquote>
+
 
+
=== ND49 instantaneous timeseries diagnostic ===
+
 
+
You can replicate the ND49 bpch diagnostic (instantaneous timeseries) as follows:
+
 
+
#Define a diagnostic collection in <tt>HISTORY.rc</tt>:
+
#*Specify instantaneous output:
+
#** Set <tt>mode: instantaneous</tt>
+
#*Specify the desired output frequency:
+
#** Set <tt>frequency: 010000</tt> for hourly output
+
#** Set <tt>frequency: 030000</tt> for 3-hourly output
+
#** Set <tt>frequency: 120000</tt> for 12-hourly output, etc.
+
#*Specify that a new netCDF file should be created every 24 hours:
+
#** Set <tt>duration: 240000</tt>
+
#Within this diagnostic collection, you can add archive any available quantity from the <tt>State_Met</tt>, <tt>State_Chm</tt>, or <tt>State_Diag</tt> objects.
+
 
+
Example:
+
 
+
COLLECTIONS: inst3hr',
+
            ::
+
  inst3hr.filename:      './GEOSChem.inst3hr.%y4%m2%d2.nc4',
+
  inst3hr.frequency:      030000,
+
  inst3hr.duration:      240000,
+
  inst3hr.mode:          'instantaneous',
+
  inst3hr.fields:        'SpeciesConc_?ADV?', 'GIGCchem',
+
                          'Met_T',            'GIGCchem',
+
                          'DryDepVel_?DRY?',  'GIGCchem',
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 15:57, 15 November 2017 (UTC)
+
 
+
=== ND50 24-hr average timeseries diagnostic ===
+
 
+
You can replicate the ND50 bpch diagnostic (24-hr average timeseries) as follows:
+
 
+
#Define a diagnostic collection in <tt>HISTORY.rc</tt>:
+
#*Specify time-averaged output:
+
#** Set <tt>mode: time-averaged</tt>
+
#*Specify daily output frequency.  This will also set the averaging interval to be daily.
+
#** Set <tt>frequency: 240000</tt>
+
#*Specify that a new netCDF file should be created every 24 hours:
+
#** Set <tt>duration: 240000</tt>
+
#Within this diagnostic collection, you can add archive any available quantity from the <tt>State_Met</tt>, <tt>State_Chm</tt>, or <tt>State_Diag</tt> objects.
+
 
+
Example:
+
 
+
COLLECTIONS: avg24hr',
+
            ::
+
  avg24hr.filename:      './GEOSChem.avg24hr.%y4%m2%d2.nc4',
+
  avg24hr.frequency:      240000,
+
  avg24hr.duration:      240000,
+
  avg24hr.mode:          'time-averaged',
+
  avg24hr.fields:        'SpeciesConc_?ADV?', 'GIGCchem',
+
                          'Met_T',            'GIGCchem',
+
                          'DryDepVel_?DRY?',  'GIGCchem',
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 16:06, 15 November 2017 (UTC)
+
 
+
=== ND51 satellite diagnostic ===
+
 
+
'''''[[User:kelaar|Aaron van Donkelaar]] wrote:'''''
+
 
+
<blockquote>I wanted to double check about how the satellite-overpass diagnostic (ND51) was being included.  There was some mention of it within the [[Media:Netcdf_Diagnostics.pdf|(netCDF diagnostic) presentation]], but I wasn’t clear to me how the time-averaged netcdf collection could be made to output something similar to the current ND51.
+
+
My main concern was that ND51 samples between two defined local times once each day.  From what I understood of the time-averaged collection via netcdf, it could be set to regularly sample between a defined interval of time (e.g. every six hours), but I didn’t understand how this could be set to sample between, say, 10am-12pm local time each day.  Neither local time, nor once per day seemed an option.
+
+
Apologies if I’ve just misunderstood, but I thought I should check that an ND51-type output would still be possible.
+
</blockquote>
+
 
+
'''''[[User:Bmy|Bob Yantosca]] replied:'''''
+
 
+
<blockquote>At this time we don't yet have a good substitute for the ND51 satellite timeseries diagnostics.  We may be able to replicate this with some type of satellite simulator package, but that remains to be seen as of yet.  Right now we are focusing our efforts on implementing the netCDF diagnostics that are required for benchmarking.  (Specialty diagnostics will be added later.)
+
 
+
We have designed the netCDF diagnostics for GC-Classic to replicate the behavior of the diagnostics in GCHP.  Having the diagnostics work the same way in both configurations of GC facilitates benchmarking and comparing GC-Classic to GCHP.  It also makes it easier for users to switch between GC-Classic to GCHP.  But GCHP does not allow for local-time diagnostics.  GCHP relies on the MAPL library, and its diagnostic package (aka "History") only allows for instantaneous or time-averaged output.
+
 
+
One could save e.g hourly timeseries, along with a local time field, to netCDF, and apply the local time comparison in post-processing.  This would be doable but it would also end up generating a ton of output.
+
 
+
'''The good news is that we will preserve the bpch diagnostics in v11-02 (I need to update the wiki better to reflect that).  We will not remove the bpch diagnostics until we have found a suitable replacement for the local-time diagnostics.'''  So for the time being you can still rely on ND51.</blockquote>
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 15:33, 15 November 2017 (UTC)
+
 
+
== Validating the netCDF diagnostics ==
+
 
+
=== In GEOS-Chem Classic ===
+
 
+
We invite you to view the the presentation [[Media:NetCDF_diagnostic_update.pdf|''NetCDF diagnostic validation in GEOS-Chem "Classic"]] by Bob Yantosca and the GCST which summarizes the initial validation process.  A more robust validation will take place shortly.
+
 
+
One of the take-aways of the validation is that the timestep at which diagnostics are update could cause non-negligble differences.  For example, several GEOS-Chem time-averaged diagnostics are updated on each chemistry timestep, which is 20 minutes for most GEOS-Chem simulations.  But the default behavior of the new netCDF diagnostics in GEOS-Chem updates time-averaged diagnostic quantities every "heartbeat" timestep, which is 10 minutes for most simulations.  Therefore, the netCDF diagnostics will capture the state of the atmopshere on those timesteps where chemistry does not happen.  As shown in the presentation, this could cause non-negligible differences when comparing to the legacy diagnostics.
+
 
+
The [[GCST]] recommends that time-averaged diagnostic quantities in GEOS-Chem "Classic" be updated on each "heartbeat" timestep, as this mimics the behavior the diagnostics in [[GEOS-Chem HP|GCHP]].
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:14, 27 November 2017 (UTC)
+
 
+
=== In GCHP ===
+
 
+
Lizzie Lundgren ([[GCST]]) and Colin Lee (Dalhousie) are validating the new diagnostics in GCHP.  Stay tuned for more information.
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:14, 27 November 2017 (UTC)
+

Latest revision as of 19:52, 19 July 2019