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

From Geos-chem
Jump to: navigation, search
(The AerosolMass collection)
 
(298 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. 
+
 
+
#===================================================================
+
# Declare collection names.  Disable collections by commenting
+
# each collection name out with a "#" character.
+
#===================================================================
+
COLLECTIONS: <span style="color:red">'SpeciesConc'</span>,
+
              <span style="color:blue">'ConcAfterChem'</span>,
+
::
+
#===================================================================
+
# Collection to save out GEOS-Chem species concentrations
+
#===================================================================
+
<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',
+
::
+
#===================================================================
+
# Collection to save out concentrations after chemistry
+
# (from the FlexChem/KPP solver)
+
#===================================================================
+
<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.
+
 
+
{| 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)
+
 
+
=== 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.
+
 
+
NOTE: '''all fullchem''' simulations are those that use one of the following full-chemistry mechanisms with the [[FlexChem|FlexChem/KPP]] solver:
+
*benchmark
+
*standard
+
*tropchem
+
*complexSOA
+
*complesSOA_SVPOA
+
*marinePOA
+
*aciduptake
+
 
+
|-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 ==
+
 
+
'''''More information to be added'''''
+
 
+
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.
+
 
+
=== The SpeciesConc collection ===
+
 
+
The '''SpeciesConc''' collection specifies diagnostic output for the concentrations of advected species.  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 GEOS-Chem run directory.
+
 
+
A sample collection definition section is listed below.  You may cut-and-paste this into your <tt>HISTORY.rc</tt> file and edit accordingly.
+
 
+
  SpeciesConc.template:      '%y4%m2%d2_%h2%n2z.nc4',
+
  SpeciesConc.format:        'CFIO',
+
  SpeciesConc.frequency:      00000001 000000
+
  SpeciesConc.duration:      00000001 000000
+
  SpeciesConc.mode:          'time-averaged'
+
  SpeciesConc.fields:        'SpeciesConc_?ADV?            ', 'GIGCchem',
+
  ::
+
 
+
The table below describes 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 ===
+
 
+
  AerosolMass.template:      '%y4%m2%d2_%h2%n2z.nc4',
+
  AerosolMass.format:        'CFIO',
+
  AerosolMass.frequency:      00000001 000000
+
  AerosolMass.duration:      00000001 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',
+
 
+
The table below describes 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 CloudConvFlux collection ==
+
 
+
A sample collection definition section is listed below.  You may cut-and-paste this into your <tt>HISTORY.rc</tt> file and edit accordingly.
+
 
+
  CloudConvFlux.template:    '%y4%m2%d2_%h2%n2z.nc4',
+
  CloudConvFlux.format:      'CFIO',
+
  CloudConvFlux.frequency:    010000
+
  CloudConvFlux.duration:    010000
+
  CloudConvFlux.mode:        'time-averaged'
+
  CloudConvFlux.fields:      'CloudConvFlux_?ADV?          ', 'GIGCchem',
+
  ::
+
 
+
Here follows a description of 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
+
|}
+
 
+
== The ConcAfterChem collection ==
+
 
+
A sample collection definition section is listed below.  You may cut-and-paste this into your <tt>HISTORY.rc</tt> file and edit accordingly.
+
 
+
  ConcAfterChem.template:    '%y4%m2%d2_%h2%n2z.nc4',
+
  ConcAfterChem.format:      'CFIO',
+
  ConcAfterChem.frequency:    010000
+
  ConcAfterChem.duration:    010000
+
  ConcAfterChem.mode:        'time-averaged'
+
  ConcAfterChem.fields:      'OHconcAfterChem                ', 'GIGCchem', 
+
                              'HO2concAfterChem              ', 'GIGCchem', 
+
                              'O1DconcAfterChem              ', 'GIGCchem', 
+
                              'O3PconcAfterChem              ', 'GIGCchem', 
+
  ::
+
 
+
Here follows a description of diagnostic quantities belonging to the ConcAfterChem 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"
+
|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
+
|
+
|
+
*fullchem simuations using the UCX mechanism
+
|
+
*[[List of diagnostics archived to bpch format|ND43]], #4
+
|
+
 
+
|-valign="top"
+
|O3PconcAfterChem
+
|O3P concentration immediately after exiting the FlexChem solver
+
|molec/cm3
+
|
+
|
+
*fullchem simuations using the UCX mechanism
+
|
+
*[[List of diagnostics archived to bpch format|ND43]], #5
+
|
+
 
+
|}
+
 
+
== Proposed diagnostic names for fields of the State_Chm object ==
+
 
+
The table below lists the available fields of the <tt>State_Chm</tt> chemistry state object that can be archived and sent to netCDF output files.
+
 
+
<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:  Each of the diagnostic quantities listed below must begin with the case-insensitive text <tt>CHEM_</tt> (or <tt>Chem_</tt> or <tt>chem_</tt>).  This will tell the diagnostics modules to look for these quantities in the <tt>State_Chm</tt> object.'''''</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"
+
|rowspan="6"|<tt>CHEM_Species_<spcname></tt>
+
|rowspan="6"|Species concentrations in <tt>State_Chm%Species</tt>, in native units.
+
 
+
<span style="color:red">'''''NOTE: This diagnostic may be useful for debugging and/or checkpointing.  We do not recommend normal use of this diagnostic, because the units of <tt>State_Chm%Species</tt> change throughout a GEOS-Chem simulation.  We recommend that you use the <tt>SpeciesConc</tt> diagnostic, which will always have consistent units (i.e. [mol/mol dry air]).'''''</span>
+
|ND45
+
|<tt>IJ-AVG-$</tt>
+
|1-nAdvect
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|ND47
+
|<tt>IJ-24H-$</tt>
+
|1-nAdvect
+
|Daily
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|ND48
+
|<tt>IJ-24H-$</tt>
+
|1-nAdvect
+
|Instantaneous
+
|<tt>stations.YYYYMMDDhh</tt>
+
 
+
|-valign="top"
+
|ND49
+
|<tt>IJ-AVG-$</tt>
+
|1-nAdvect
+
|Instantaneous
+
|<tt>ts.YYYYMMDDhh.bpch</tt>
+
 
+
|-valign="top"
+
|ND50
+
|<tt>IJ-AVG-$</tt>
+
|1-nAdvect
+
|Daily
+
|<tt>ts_24h_avg.YYYYMMDDhh.bpch</tt>
+
 
+
|-valign="top"
+
|ND51 & ND51b
+
|<tt>IJ-AVG-$</tt>
+
|1-nAdvect
+
|User-defined time avg
+
|<tt>ts_24h_avg.YYYYMMDDhh.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>CHEM_AeroArea<aername></tt>
+
|Dry aerosol area [cm2/cm3] for several aerosol types, stored in the <tt>State_Chm%AeroArea</tt> array.
+
| -
+
| -
+
| -
+
| -
+
| -
+
 
+
|-valign="top"
+
|<tt>CHEM_AeroRadi<aername></tt>
+
|Dry aerosol radii [cm] for several aerosol types, stored in the <tt>State_Chm%AeroRadi</tt> array.
+
| -
+
| -
+
| -
+
| -
+
| -
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>CHEM_WetAeroArea<aername></tt>
+
|Wet aerosol area [cm2/cm3] for several aerosol types, stored in the <tt>State_Chm%WetAeroArea</tt> array.
+
| -
+
| -
+
| -
+
| -
+
| -
+
 
+
|-valign="top"
+
|<tt>CHEM_WetAeroRadi<aername></tt>
+
|Wet aerosol radii [cm] for several aerosol types, stored in the <tt>State_Chm%WetAeroRadi</tt> array.
+
| -
+
| -
+
| -
+
| -
+
| -
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>CHEM_StatePsc</tt>
+
|Polar stratospheric cloud type (cf Kirner et al, 2011, GMD) [1]
+
| -
+
| -
+
| -
+
| -
+
| -
+
 
+
|-valign="top"
+
|<tt>CHEM_KhetiSlaN2O5H2O</tt>
+
|Sticking coefficient for N2O5 + H2O reaction [1]
+
| -
+
| -
+
| -
+
| -
+
| -
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>CHEM_KhetiSlaN2O5HCl</tt>
+
|Sticking coefficient for N2O5 + HCl reaction [1]
+
| -
+
| -
+
| -
+
| -
+
| -
+
 
+
|-valign="top"
+
|<tt>CHEM_KhetiSlaClNO3H2O</tt>
+
|Sticking coefficient for ClNO3 + H2O reaction [1]
+
| -
+
| -
+
| -
+
| -
+
| -
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>CHEM_KhetiSlaClNO3HCl</tt>
+
|Sticking coefficient for ClNO3 + HCl reaction [1]
+
| -
+
| -
+
| -
+
| -
+
| -
+
 
+
|-valign="top"
+
|<tt>CHEM_KhetiSlaClNO3HBr</tt>
+
|Sticking coefficient for ClNO3 + HBr reaction [1]
+
| -
+
| -
+
| -
+
| -
+
| -
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>CHEM_KhetiSlaBrNO3H2O</tt>
+
|Sticking coefficient for BrNO3 + H2O reaction [1]
+
| -
+
| -
+
| -
+
| -
+
| -
+
 
+
|-valign="top"
+
|<tt>CHEM_KhetiSlaBrNO3HCl</tt>
+
|Sticking coefficient for BrNO3 + HCl reaction [1]
+
| -
+
| -
+
| -
+
| -
+
| -
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>CHEM_KhetiSlaHOClHCl</tt>
+
|Sticking coefficient for HOCl + HCl reaction [1]
+
| -
+
| -
+
| -
+
| -
+
| -
+
 
+
|-valign="top"
+
|<tt>CHEM_KhetiSlaHOClHBr</tt>
+
|Sticking coefficient for HOCl + HBr reaction [1]
+
| -
+
| -
+
| -
+
| -
+
| -
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>CHEM_KhetiSlaHOBrHCl</tt>
+
|Sticking coefficient for HOBr + HCl reaction [1]
+
| -
+
| -
+
| -
+
| -
+
| -
+
 
+
|-valign="top"
+
|<tt>CHEM_KhetiSlaHOBrHBr</tt>
+
|Sticking coefficient for N2O5 + H2O reaction
+
| -
+
| -
+
| -
+
| -
+
| -
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>CHEM_phSav</tt>
+
|ISORROPIA aerosol pH
+
|ND73
+
|<tt>ISOROP-$</tt>
+
|1
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>CHEM_HplusSav</tt>
+
|ISORROPIA H+ concentration [M]
+
|ND73
+
|<tt>ISOROP-$</tt>
+
|2
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>CHEM_WaterSav</tt>
+
|ISORROPIA aerosol water [&mu;g m-3]
+
|ND73
+
|<tt>ISOROP-$</tt>
+
|3
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>CHEM_SulRatSav</tt>
+
|ISORROPIA sulfate concentration [M]
+
|none (not archived in v11-01)
+
|" "
+
|" "
+
|" "
+
|" "
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>CHEM_NaRatSav</tt>
+
|ISORROPIA Na+ concentration [M]
+
|none (not archived in v11-01)
+
|" "
+
|" "
+
|" "
+
|" "
+
 
+
|-valign="top"
+
|<tt>CHEM_AcidPurSav</tt>
+
|ISORROPIA acidpur ?? concentration [M]
+
|none (not archived in v11-01)
+
|" "
+
|" "
+
|" "
+
|" "
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>CHEM_BiSulSav</tt>
+
|ISORROPIA bisulfate (general acide) concentration [M]
+
|none (not archived in v11-01)
+
|" "
+
|" "
+
|" "
+
|" "
+
 
+
|-valign="top"
+
|<tt>CHEM_phCloud</tt>
+
|Cloud PH [1]
+
|none (new in v11-02)
+
|" "
+
|" "
+
|" "
+
|" "
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>CHEM_SSAlk</tt>
+
|Sea salt alkalinity [1]
+
|none (new in v11-02)
+
|" "
+
|" "
+
|" "
+
|" "
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 18:55, 29 November 2017 (UTC)
+
 
+
== Proposed diagnostic names for aerosols ==
+
 
+
Here is a list of our proposed netCDF diagnostic names for quantities archived in the GEOS-Chem aerosol modules.  This list is by no means exhaustive or complete. Contact [[User:bmy|Bob Yantosca]] with any suggestions or concerns.
+
 
+
<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 prod and loss diagnostics to the area-independent units of [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>LossHNO3onSeaSalt</tt>
+
|Loss of NO3 by DMS [kg]<br><span style="color:red">'''''NOTE: Only archived for dust uptake simulations'''''</span>
+
|ND05
+
|<tt>PL-SUL-$</tt>
+
|14
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>LossNO3byDMS</tt>
+
|Loss of NO3 by DMS [kg]<br><span style="color:red">'''''NOTE: Only archived for aerosol-only simulations'''''</span>
+
|ND05
+
|<tt>PL-SUL-$</tt>
+
|10
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>LossOHbyDMS</tt>
+
|Loss of OH by DMS [kg]<br><span style="color:red">'''''NOTE: Only archived for aerosol-only simulations'''''</span>
+
|ND05
+
|<tt>PL-SUL-$</tt>
+
|9
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>ProdMSAfromDMS</tt>
+
|Production of MSA from DMS [kg]<br><span style="color:red">'''''NOTE: Only archived for aerosol-only simulations'''''</span>
+
|ND05
+
|<tt>PL-SUL-$</tt>
+
|4
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>ProdNITfromHNO3uptakeOnDust</tt>
+
|Production of NIT from HNO3 uptake on dust aerosols [kg N]<br><span style="color:red">'''''NOTE: Only archived for dust uptake simulations'''''</span>
+
|ND05
+
|<tt>PL-SUL-$</tt>
+
|12
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>ProdSO2fromDMS</tt>
+
|Total P(SO2) from DMS [kg S]<br><span style="color:red">'''''NOTE: Only archived for aerosol-only simulations'''''</span>
+
|ND05
+
|<tt>PL-SUL-$</tt>
+
|3
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>ProdSO2fromDMSandNO3</tt>
+
|Production of SO2 from DMS + NO3 (in <tt>sulfate_mod.F</tt>) [kg S]<br><span style="color:red">'''''NOTE: Only archived for aerosol-only simulations'''''</span>
+
|ND05
+
|<tt>PL-SUL-$</tt>
+
|2
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>ProdSO2fromDMSandOH</tt>
+
|Production of SO2 from DMS + OH (in <tt>sulfate_mod.F</tt>) [kg S]<br><span style="color:red">'''''NOTE: Only archived for Aerosol-only simulations'''''</span>
+
|ND05
+
|<tt>PL-SUL-$</tt>
+
|1
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>ProdSO4fromGasPhase</tt>
+
|Production of SO4 in the gas phase [kg S]
+
|ND05
+
|<tt>PL-SUL-$</tt>
+
|5
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>ProdSO4fromH2O2inCloud</tt>
+
|Production of SO4 from aqueous oxidation of H2O2 in clouds [kg S]
+
|ND05
+
|<tt>PL-SUL-$</tt>
+
|6
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>ProdSO4fromHOBrinCloud</tt>
+
|Production of SO4 from aqueous oxidation of HOBr in clouds [kg S]
+
|ND05
+
|<tt>PL-SUL-$</tt>
+
|15
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>ProdSO4fromO3inCloud</tt>
+
|Production of SO4 from aqueous oxidation of O3 in clouds [kg S]
+
|ND05
+
|<tt>PL-SUL-$</tt>
+
|7
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>ProdSO4fromO3inSeaSalt</tt>
+
|Production of SO4 from O3 in sea salt [kg S]
+
|ND05
+
|<tt>PL-SUL-$</tt>
+
|8
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>ProdSO4fromO3s</tt>
+
|Production of SO4 from aqueous phase SO3-- loss by OH [kg S]
+
|ND05
+
|<tt>PL-SUL-$</tt>
+
|18
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>ProdSO4fromOxidationOnDust</tt>
+
|Production of SO4 from oxidation on dust aerosols [kg S]<br><span style="color:red">'''''NOTE: Only archived for dust uptake simulations'''''</span>
+
|ND05
+
|<tt>PL-SUL-$</tt>
+
|11
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>ProdSO4fromSRHOBr</tt>
+
|Production of SO4 from sulfur production rate of HOBr+O3
+
|ND05
+
|<tt>PL-SUL-$</tt>
+
|17
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>ProdSO4fromSRO3r</tt>
+
|Production of SO4 from sulfur production rate of O3
+
|ND05
+
|<tt>PL-SUL-$</tt>
+
|16
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>ProdSO4fromUptakeOfH2SO4g</tt>
+
|Production of SO4 from uptake of H2SO4(g) [kg S]<br><span style="color:red">'''''NOTE: Only archived for dust uptake simulations'''''</span>
+
|ND05
+
|<tt>PL-SUL-$</tt>
+
|13
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>ProdBCPIfromBCPO</tt>
+
|Hydrophilic BC that was converted from hydrophobic BC [kg]
+
|ND07
+
|<tt>PL-BC-$</tt>
+
|4
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>ProdOCPIfromOCPO</tt>
+
|Hydrophilic OC that was converted from hydrophobic OC [kg]
+
|ND07
+
|<tt>PL-OC-$</tt>
+
|9
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 15:44, 8 December 2017 (UTC)
+
 
+
== Proposed diagnostic names for chemistry ==
+
 
+
Here is a list of our proposed netCDF diagnostic names for quantities archived in the GEOS-Chem chemistry modules.  Contact [[User:bmy|Bob Yantosca]] with any suggestions or concerns.
+
 
+
<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>Jvalues_<spcname></tt>
+
|J-values for photolyzing species, computed by FAST-JX [s-1]
+
|ND22
+
|<tt>JV-MAP-$</tt>
+
|1-nPhoto
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>RxnRate_<spcname></tt>
+
|Reaction rates from the KPP chemical solver [molec/cm3/s]
+
|none
+
|none
+
|1-nKppSpc
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|rowspan="5"|<tt>OHconcAfterChem</tt>
+
|rowspan="5"|OH concentration immediately after exiting the FlexChem chemistry solver [molec/cm3]
+
|ND43
+
|<tt>CHEM-L=$</tt>
+
|1
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|ND48
+
|<tt>TIME-SER</tt>
+
|1
+
|Hourly
+
|<tt>stations.YYYYMMDDhh</tt>
+
 
+
|-valign="top"
+
|ND49
+
|<tt>TIME-SER</tt>
+
|1
+
|Hourly
+
|<tt>tsYYYYMMDDh.bpch</tt>
+
 
+
|-valign="top"
+
|ND50
+
|<tt>TIME-SER</tt>
+
|1
+
|Daily
+
|<tt>ts_24h_avg.YYYYMMDDh.bpch</tt>
+
 
+
|-valign="top"
+
|ND51
+
|<tt>TIME-SER</tt>
+
|1
+
|Local-time avg
+
|<tt>ts_satellite.YYYYMMDDh.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>HO2concAfterChem</tt>
+
|HO2 concentration immediately after exiting the FlexChem chemistry solver [molec/cm3]
+
|ND43
+
|<tt>CHEM-L=$</tt>
+
|3
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>O1DconcAfterChem</tt>
+
|O1D concentration immediately after exiting the FlexChem chemistry solver [molec/cm3]
+
|ND43
+
|<tt>CHEM-L=$</tt>
+
|4
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>O3PconcAfterChem</tt>
+
|O3P concentration immediately after exiting the FlexChem chemistry solver [molec/cm3]
+
|ND43
+
|<tt>CHEM-L=$</tt>
+
|5
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>UVFluxDiffuse_<photobin></tt>
+
|Diffuse UV flux in each photolysis wavelength bin [W/m2]
+
|ND64
+
|<tt>FJX-FLUX</tt>
+
|1-18 (w/ UCX)<br>1-12 (w/o UCX)
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>UVFluxDirect_<photobin></tt>
+
|Direct UV flux in each photolysis wavelength bin [W/m2]
+
|ND64
+
|<tt>FJX-FLUX</tt>
+
|1-18 (w/ UCX)<br>1-12 (w/o UCX)
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>UVFluxNet_<photobin></tt>
+
|Net UV flux in each photolysis wavelength bin [W/m2]
+
|ND64
+
|<tt>FJX-FLUX</tt>
+
|1-18 (w/ UCX)<br>1-12 (w/o UCX)
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>Prod_<prodlossname></tt><br><tt>Loss_<prodlossname></tt>
+
|Production and loss of families and/or species: [molec/cm3/s]
+
*From the KPP solver (fullchem simulations)
+
*From the tagged O3 simulation
+
*From the tagged CO simulation
+
|ND65
+
|<tt>PORL-L=$</tt>
+
|1-5 (fullchem)<br>1-nAdvect*2 (tagO3, tagCO)
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 23:37, 30 November 2017 (UTC)
+
 
+
== Proposed diagnostic names for dry deposition ==
+
 
+
Here is a list of our proposed netCDF diagnostic names for quantities archived in the GEOS-Chem chemistry and dry deposition modules.  Contact [[User:bmy|Bob Yantosca]] with any suggestions or concerns.
+
 
+
<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 of dry deposition fluxes from [molec/cm2/s] to [kg/m2/s].  This will also consistent with the units of emission fluxes archived by [[HEMCO]].'''''</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>DryDepChm_<spcname></tt>
+
|Dry deposition fluxes, applied in chemistry [molec/cm2/s]
+
|ND44
+
|<tt>DRYD-FLX</tt>
+
|1-nDryDep
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>DryDepMix_<spcname></tt>
+
|Dry deposition fluxes, applied in PBL mixing [molec/cm2/s]
+
 
+
<span style="color:red">'''''NOTE: This needs to be archived separately, because PBL mixing is called each dynamic timestep, which done 2X as frequently as chemistry.'''''</span>
+
|ND44
+
|<tt>DRYD-FLX</tt>
+
|1-nDryDep
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>DryDepVel_<spcname></tt>
+
|Dry deposition velocities [cm/s]
+
|ND44
+
|<tt>DRYD-FLX</tt>
+
|1-nDryDep
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>DryDepRstRA</tt>
+
|Aerodynamic resistance [s/m]
+
| -
+
| -
+
| -
+
| -
+
| -
+
 
+
|-valign="top"
+
|<tt>DryDepRstRB</tt>
+
|Aerodynamic resistance [s/m]
+
| -
+
| -
+
| -
+
| -
+
| -
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>DryDepRstRC_<spcname></tt>
+
|Total resistance to deposition for dry-depositing species [s/m]
+
| -
+
| -
+
| -
+
| -
+
| -
+
 
+
|-valign="top"
+
|<tt>DryDepRstRI</tt>
+
|Stomatal resistance [s/m]
+
| -
+
| -
+
| -
+
| -
+
| -
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 18:12, 21 November 2017 (UTC)
+
 
+
== Proposed diagnostic names for advection and boundary layer mixing ==
+
 
+
Here is a list of our proposed netCDF diagnostic names for quantities archived in the GEOS-Chem transport and boundary layer mixing modules.  This list is by no means exhaustive or complete. Contact [[User:bmy|Bob Yantosca]] with any suggestions or concerns.
+
 
+
<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 flux diagnostics from [kg/s] to the area-independent units [kg/m2/s].  This will also be consistent with the units of emission fluxes archived by [[HEMCO]].'''''</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>AdvFluxZonal_<spcname></tt>
+
|Advection of species in the E-W direction [kg/s]
+
|ND24
+
|<tt>EW-FLX-$</tt>
+
|1-nAdvect
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>AdvFluxMerid_<spcname></tt>
+
|Advection of species in the N-S direction [kg/s]
+
|ND25
+
|<tt>NS-FLX-$</tt>
+
|1-nAdvect
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>AdvFluxVert_<spcname></tt>
+
|Advection of species in the vertical direction [kg/s]
+
|ND26
+
|<tt>UP-FLX-$</tt>
+
|1-nAdvect
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>PBLMixFrac</tt>
+
|Fraction of boundary layer occupied by level L [1]
+
 
+
<span style="color:red">'''''NOTE: HEMCO appears to have disabled this diagnostic in [[GEOS-Chem v11-01]].  It is not yet clear how this can be restored.'''''</span>
+
|ND02
+
|<tt>EMDIS-BL</tt>
+
|1-nAdvect
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>PBLFlux_<spcname></tt>
+
|Species mass change due to boundary layer mixing [kg/s]
+
|ND15
+
|<tt>TURBMC-$</tt>
+
|1-nAdvect
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:35, 14 November 2017 (UTC)
+
 
+
== Proposed diagnostic names for convection and wet scavenging ==
+
 
+
Here is a list of our proposed netCDF diagnostic names for quantities archived in the GEOS-Chem convection and wet scavenging modules.  This list is by no means exhaustive or complete. Contact [[User:bmy|Bob Yantosca]] with any suggestions or concerns.
+
 
+
<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 flux diagnostics from [kg/s] to the area-independent units [kg/m2/s]. This will also be consistent with the units of emission fluxes archived by [[HEMCO]].'''''</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>CloudConvFlux_<spcname></tt>
+
|Mass change due to cloud convection [kg/s]
+
|ND14
+
|<tt>CV-FLX-$</tt>
+
|1-nAdvect
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>WetLossConv_<spcname></tt>
+
|Loss of soluble species in convective updrafts [kg/s]
+
|ND38
+
|<tt>WETDCV-$</tt>
+
|1-nWetDep
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>WetLossLS_<spcname></tt>
+
|Loss of soluble species in large-scale rainout/washout [kg/s]
+
|ND39
+
|<tt>WETDLS-$</tt>
+
|1-nWetDep
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>PrecipFracLS</tt>
+
|Fraction of grid box undergoing large-scale precipitation [1]
+
|ND16
+
|<tt>WD-FRC-$</tt>
+
|1
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top"
+
|<tt>RainFracLS_<spcname></tt>
+
|Fraction of soluble species lost to rainout in large-scale precipitation [1]
+
|ND17
+
|<tt>WD-LSR-$</tt>
+
|1-nWetDep
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|-valign="top" bgcolor="#CCFFFF"
+
|<tt>WashFracLS_<spcname></tt>
+
|Fraction of soluble species lost to washout in large-scale precipitation [1]
+
|ND18
+
|<tt>WD-LSW-$</tt>
+
|1-nWetDep
+
|Daily<br>Monthly
+
|<tt>trac_avg.YYYYMMDDhhmm.bpch</tt>
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 18:52, 15 November 2017 (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