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

From Geos-chem
Jump to: navigation, search
(24 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
__FORCETOC__
 
__FORCETOC__
'''''[[Collections for History diagnostics|Previous]] | [[History collections for budgets|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]]
 
#[[Collections for History diagnostics]]
 
#[[Collections for History diagnostics]]
 
#<span style="color:blue">'''History collections for advection and mixing'''</span>
 
#<span style="color:blue">'''History collections for advection and mixing'''</span>
 +
#[[History collections for aerosols]]
 
#[[History collections for budgets]]
 
#[[History collections for budgets]]
#[[History collections for aerosols]]
 
 
#[[History collections for chemistry and photolysis]]
 
#[[History collections for chemistry and photolysis]]
 
#[[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]]
 
#[[History collections for TransportTracers]]
 
#[[History collections for TransportTracers]]
 +
#[[History collections for CO2]]
 
#[[Replicating the behavior of the prior timeseries diagnostics]]
 
#[[Replicating the behavior of the prior timeseries diagnostics]]
 
#[[Adding new History diagnostics]]
 
#[[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 <tt>HISTORY.rc</tt> file in [[Creating GEOS-Chem run directories|the GEOS-Chem run directory for your selected simulation]], you can copy and paste this into your <tt>HISTORY.rc</tt> file and edit accordingly. 
 +
*To prevent an individual field from being included in the diagnostic output, place a comment character <tt>#</tt> in front of the field name.
 +
*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 <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
 +
|-valign="top" bgcolor="#CCCCCC"
 +
!width="225px"|Diagnostic name
 +
!width="225px"|Description
 +
!width="125px"|Units
 +
!width="100px"|Wildcards
 +
!width="150px"|Simulations
 +
!width="175px"|Notes
 +
 +
|-valign="top"
 +
|AdvFluxVert_<spcname>
 +
|Vertical flux of species in advection
 +
|kg/s
 +
|?ADV?
 +
|Can be used with
 +
*all simulations
 +
Typically only used with
 +
*benchmark
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.6.0'''</span>
 +
 +
|}
  
 
== 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 AerosolMass collection.   
+
Here is a sample definition section for the Transport collection.   
 
*If this collection is not already present in the <tt>HISTORY.rc</tt> file in [[Creating GEOS-Chem run directories|the GEOS-Chem run directory for your selected simulation]], you can copy and paste this into your <tt>HISTORY.rc</tt> file and edit accordingly.   
 
*If this collection is not already present in the <tt>HISTORY.rc</tt> file in [[Creating GEOS-Chem run directories|the GEOS-Chem run directory for your selected simulation]], you can copy and paste this into your <tt>HISTORY.rc</tt> file and edit accordingly.   
 
*To prevent an individual field from being included in the diagnostic output, place a comment character <tt>#</tt> in front of the field name.
 
*To prevent an individual field from being included in the diagnostic output, place a comment character <tt>#</tt> in front of the field name.
 
*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 41: Line 77:
 
   Transport.mode:            'instantaneous'
 
   Transport.mode:            'instantaneous'
 
   Transport.fields:          'Met_AgeOfAir                  ', 'GIGCchem',
 
   Transport.fields:          'Met_AgeOfAir                  ', 'GIGCchem',
 +
::
  
This table describes the diagnostic quantities belonging to the AerosolMass collection:
+
This table describes the diagnostic quantities belonging to the Transport collection:
  
 
{| border=1 cellspacing=0 cellpadding=5  
 
{| border=1 cellspacing=0 cellpadding=5  
Line 51: Line 88:
 
!width="100px"|Wildcards
 
!width="100px"|Wildcards
 
!width="150px"|Simulations
 
!width="150px"|Simulations
!width="150px"|Notes
+
!width="175px"|Notes
  
 
|-valign="top"
 
|-valign="top"
 
|Met_AgeOfAir
 
|Met_AgeOfAir
 +
*NOTE: This collection was merged into StateMet in GEOS-Chem 13.0.0 and later versions
 
|Age of air
 
|Age of air
 
|years
 
|years
 
|
 
|
|Typically used with:
+
|Can be used with
 +
*all simulations
 +
Typically only used with
 
*benchmark
 
*benchmark
 
*TransportTracers
 
*TransportTracers
|
 
*New in [[GEOS-Chem 12#12.2.0|12.2.0]]
 
  
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.2.0'''</span>
 +
*<span style="color:red">'''Removed in 12.2.0'''</span>
 
|}
 
|}
 +
 +
'''''PLEASE NOTE:''''' The Age of Air diagnostic will be zero everywhere at the surface level, but nonzero at levels above the surface.
 +
 +
 +
----
 +
'''''[[Collections for History diagnostics|Previous]] | [[History collections for aerosols|Next]] | [[Guide to GEOS-Chem History diagnostics]]'''''

Revision as of 16:43, 22 April 2021

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. History collections for CO2
  16. Replicating the behavior of the prior timeseries diagnostics
  17. 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
  • Added in 12.6.0

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
  • NOTE: This collection was merged into StateMet in GEOS-Chem 13.0.0 and later versions
Age of air years Can be used with
  • all simulations

Typically only used with

  • benchmark
  • TransportTracers
  • Added in 12.2.0
  • Removed in 12.2.0

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



Previous | Next | Guide to GEOS-Chem History diagnostics