Difference between revisions of "History collections for advection and mixing"
From Geos-chem
(→The Transport collection) |
|||
(21 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 | + | '''''[[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 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]] | ||
Line 21: | Line 22: | ||
== The AdvFluxVert collection == | == The AdvFluxVert collection == | ||
− | Here is a sample definition section for 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. | *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. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
AdvFluxVert.template: '%y4%m2%d2_%h2%n2z.nc4', | AdvFluxVert.template: '%y4%m2%d2_%h2%n2z.nc4', | ||
AdvFluxVert.format: 'CFIO', | AdvFluxVert.format: 'CFIO', | ||
− | AdvFluxVert.frequency: | + | AdvFluxVert.frequency: 00000100 000000 |
− | AdvFluxVert.duration: | + | AdvFluxVert.duration: 00000100 000000 |
AdvFluxVert.mode: 'time-averaged' | AdvFluxVert.mode: 'time-averaged' | ||
− | AdvFluxVert.fields: ' | + | 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 50: | Line 46: | ||
!width="100px"|Wildcards | !width="100px"|Wildcards | ||
!width="150px"|Simulations | !width="150px"|Simulations | ||
− | !width=" | + | !width="175px"|Notes |
|-valign="top" | |-valign="top" | ||
− | | | + | |AdvFluxVert_<spcname> |
− | | | + | |Vertical flux of species in advection |
− | | | + | |kg/s |
− | | | + | |?ADV? |
|Can be used with | |Can be used with | ||
*all simulations | *all simulations | ||
Typically only used with | Typically only used with | ||
*benchmark | *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 Transport collection. | Here is a sample definition section for the Transport collection. | ||
Line 78: | Line 71: | ||
*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. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
Transport.template: '%y4%m2%d2_%h2%n2z.nc4', | Transport.template: '%y4%m2%d2_%h2%n2z.nc4', | ||
Transport.format: 'CFIO', | Transport.format: 'CFIO', | ||
Line 102: | Line 88: | ||
!width="100px"|Wildcards | !width="100px"|Wildcards | ||
!width="150px"|Simulations | !width="150px"|Simulations | ||
− | !width=" | + | !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 | ||
− | |||
− | |||
+ | | | ||
+ | *<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
- Overview of History diagnostics
- Legend for History diagnostics
- Collections for History diagnostics
- History collections for advection and mixing
- History collections for aerosols
- History collections for budgets
- History collections for chemistry and photolysis
- History collections for convection and wet deposition
- History collections for dry deposition
- History collections for mercury and POPs
- History collections for met fields and related quantities
- History collections for methane
- History collections for species concentrations
- History collections for TransportTracers
- History collections for CO2
- Replicating the behavior of the prior timeseries 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 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
Typically only used with
|
|
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
Typically only used with
|
|
PLEASE NOTE: The Age of Air diagnostic will be zero everywhere at the surface level, but nonzero at levels above the surface.