Difference between revisions of "History collections for advection and mixing"

From Geos-chem
Jump to: navigation, search
(The AdvFluxVert collection)
(The Transport collection)
(14 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
__FORCETOC__
 
__FORCETOC__
'''''[[Collections for History diagnostics|Previous]] | [[History collections for aerosols|Next]] | [[Guide to GEOS-Chem History diagnostics]] | [[Guide to GEOS-Chem diagnostics]] | [[Getting Started with GEOS-Chem]] | [[Main Page|GEOS-Chem Main Page]]'''''
+
'''''[[Collections for History diagnostics|Previous]] | [[History collections for aerosols|Next]] | [[Guide to GEOS-Chem History diagnostics]]'''''
 
#[[Overview of History diagnostics]]
 
#[[Overview of History diagnostics]]
 
#[[Legend for History diagnostics]]
 
#[[Legend for History diagnostics]]
Line 10: Line 10:
 
#[[History collections for convection and wet deposition]]
 
#[[History collections for convection and wet deposition]]
 
#[[History collections for dry deposition]]
 
#[[History collections for dry deposition]]
#[[History collections for met fields and related quantities]]
 
 
#[[History collections for mercury and POPs]]
 
#[[History collections for mercury and POPs]]
 +
#[[History collections for met fields and related quantities]]
 
#[[History collections for methane]]
 
#[[History collections for methane]]
 
#[[History collections for species concentrations]]
 
#[[History collections for species concentrations]]
Line 21: Line 21:
 
== The AdvFluxVert collection ==
 
== The AdvFluxVert collection ==
  
Here is a sample definition section for the '''AdvFluxVert''' collection.  This is used to get vertical fluxes of species in advection for benchmarking purposes.
+
Here is a sample definition section for the '''AdvFluxVert''' collection.  This is used to obtain vertical fluxes of species from advection.
  
 
*If this collection is not already present in the <tt>HISTORY.rc</tt> file in [[Creating GEOS-Chem run directories|the GEOS-Chem run directory for your selected simulation]], you can copy and paste this into your <tt>HISTORY.rc</tt> file and edit accordingly.   
 
*If this collection is not already present in the <tt>HISTORY.rc</tt> file in [[Creating GEOS-Chem run directories|the GEOS-Chem run directory for your selected simulation]], you can copy and paste this into your <tt>HISTORY.rc</tt> file and edit accordingly.   
Line 27: Line 27:
 
*Please see our ''[[Legend for History diagnostics]]'' page for more information about each of the collection tags.
 
*Please see our ''[[Legend for History diagnostics]]'' page for more information about each of the collection tags.
  
#==============================================================================
 
# %%%%% THE AdvFluxVert COLLECTION %%%%%
 
#
 
# GEOS-Chem vertical mass flux of species in kg/s (default = O3 only)
 
#
 
# Available for all simulations
 
#==============================================================================
 
 
   AdvFluxVert.template:      '%y4%m2%d2_%h2%n2z.nc4',
 
   AdvFluxVert.template:      '%y4%m2%d2_%h2%n2z.nc4',
 
   AdvFluxVert.format:        'CFIO',
 
   AdvFluxVert.format:        'CFIO',
   AdvFluxVert.frequency:      {FREQUENCY}
+
   AdvFluxVert.frequency:      00000100 000000
   AdvFluxVert.duration:      {DURATION}
+
   AdvFluxVert.duration:      00000100 000000
 
   AdvFluxVert.mode:          'time-averaged'
 
   AdvFluxVert.mode:          'time-averaged'
   AdvFluxVert.fields:        'SpeciesConc_O3               ', 'GIGCchem',
+
   AdvFluxVert.fields:        'AdvFluxVert_O3               ', 'GIGCchem',
 
  ::
 
  ::
  
 
This table describes the diagnostic quantities belonging to the AdvFluxVert collection:
 
This table describes the diagnostic quantities belonging to the AdvFluxVert collection:
 +
*'''''NOTE:''' You can use this diagnostic to obtain the vertical flux of all species with the <tt>?ADV?</tt> wildcard.  But in practice, this collection is used to obtain the vertical flux of O3 in advection, which is needed for benchmarking purposes.''
  
 
{| border=1 cellspacing=0 cellpadding=5  
 
{| border=1 cellspacing=0 cellpadding=5  
Line 54: Line 48:
  
 
|-valign="top"
 
|-valign="top"
|SpeciesConc_O3
+
|AdvFluxVert_<spcname>
|Vertical flux of ozone in advection
+
|Vertical flux of species in advection
 
|kg/s
 
|kg/s
|
+
|?ADV?
 
|Can be used with
 
|Can be used with
 
*all simulations
 
*all simulations
Line 68: Line 62:
 
|}
 
|}
  
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 17:55, 19 July 2019 (UTC)
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 18:00, 19 July 2019 (UTC)
  
 
== The Transport collection ==
 
== The Transport collection ==
  
The '''Transport''' collection contains diagnostics for age of air.  This is used for benchmarking purposes
+
The '''Transport''' collection contains diagnostics for age of air.  This is primarily used for benchmarking purposes
  
 
Here is a sample definition section for the Transport collection.   
 
Here is a sample definition section for the Transport collection.   
Line 79: Line 73:
 
*Please see our ''[[Legend for History diagnostics]]'' page for more information about each of the collection tags.
 
*Please see our ''[[Legend for History diagnostics]]'' page for more information about each of the collection tags.
  
#==============================================================================
 
# %%%%% THE Transport COLLECTION %%%%%
 
#
 
# Diagnostics for evaluating transport, including age of air [s]
 
#
 
# Available for all simulations
 
#==============================================================================
 
 
   Transport.template:        '%y4%m2%d2_%h2%n2z.nc4',
 
   Transport.template:        '%y4%m2%d2_%h2%n2z.nc4',
 
   Transport.format:          'CFIO',
 
   Transport.format:          'CFIO',
Line 110: Line 97:
 
|years
 
|years
 
|
 
|
|Typically used with:
+
|Can be used with
 +
*all simulations
 +
Typically only used with
 
*benchmark
 
*benchmark
 
*TransportTracers
 
*TransportTracers
Line 117: Line 106:
  
 
|}
 
|}
 +
 +
'''''PLEASE NOTE:''''' The Age of Air diagnostic will be zero everywhere at the surface level, but nonzero at levels above the surface.
 +
 +
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:34, 19 July 2019 (UTC)
 +
 +
----
 +
'''''[[Collections for History diagnostics|Previous]] | [[History collections for aerosols|Next]] | [[Guide to GEOS-Chem History diagnostics]]'''''

Revision as of 18:36, 5 November 2019

Previous | Next | Guide to GEOS-Chem History diagnostics

  1. Overview of History diagnostics
  2. Legend for History diagnostics
  3. Collections for History diagnostics
  4. History collections for advection and mixing
  5. History collections for aerosols
  6. History collections for budgets
  7. History collections for chemistry and photolysis
  8. History collections for convection and wet deposition
  9. History collections for dry deposition
  10. History collections for mercury and POPs
  11. History collections for met fields and related quantities
  12. History collections for methane
  13. History collections for species concentrations
  14. History collections for TransportTracers
  15. Replicating the behavior of the prior timeseries diagnostics
  16. Adding new History diagnostics


The AdvFluxVert collection

Here is a sample definition section for the AdvFluxVert collection. This is used to obtain vertical fluxes of species from advection.

  • If this collection is not already present in the HISTORY.rc file in the GEOS-Chem run directory for your selected simulation, you can copy and paste this into your HISTORY.rc file and edit accordingly.
  • To prevent an individual field from being included in the diagnostic output, place a comment character # in front of the field name.
  • Please see our Legend for History diagnostics page for more information about each of the collection tags.
  AdvFluxVert.template:       '%y4%m2%d2_%h2%n2z.nc4',
  AdvFluxVert.format:         'CFIO',
  AdvFluxVert.frequency:      00000100 000000
  AdvFluxVert.duration:       00000100 000000
  AdvFluxVert.mode:           'time-averaged'
  AdvFluxVert.fields:         'AdvFluxVert_O3               ', 'GIGCchem',
::

This table describes the diagnostic quantities belonging to the AdvFluxVert collection:

  • NOTE: You can use this diagnostic to obtain the vertical flux of all species with the ?ADV? wildcard. But in practice, this collection is used to obtain the vertical flux of O3 in advection, which is needed for benchmarking purposes.
Diagnostic name Description Units Wildcards Simulations Notes
AdvFluxVert_<spcname> Vertical flux of species in advection kg/s ?ADV? Can be used with
  • all simulations

Typically only used with

  • benchmark

--Bob Yantosca (talk) 18:00, 19 July 2019 (UTC)

The Transport collection

The Transport collection contains diagnostics for age of air. This is primarily used for benchmarking purposes

Here is a sample definition section for the Transport collection.

  • If this collection is not already present in the HISTORY.rc file in the GEOS-Chem run directory for your selected simulation, you can copy and paste this into your HISTORY.rc file and edit accordingly.
  • To prevent an individual field from being included in the diagnostic output, place a comment character # in front of the field name.
  • Please see our Legend for History diagnostics page for more information about each of the collection tags.
  Transport.template:         '%y4%m2%d2_%h2%n2z.nc4',
  Transport.format:           'CFIO',
  Transport.frequency:        'End',
  Transport.duration:         'End',
  Transport.mode:             'instantaneous'
  Transport.fields:           'Met_AgeOfAir                  ', 'GIGCchem',
::

This table describes the diagnostic quantities belonging to the Transport collection:

Diagnostic name Description Units Wildcards Simulations Notes
Met_AgeOfAir Age of air years Can be used with
  • all simulations

Typically only used with

  • benchmark
  • TransportTracers

PLEASE NOTE: The Age of Air diagnostic will be zero everywhere at the surface level, but nonzero at levels above the surface.

--Bob Yantosca (talk) 20:34, 19 July 2019 (UTC)


Previous | Next | Guide to GEOS-Chem History diagnostics