Difference between revisions of "History collections for species concentrations"

From Geos-chem
Jump to: navigation, search
(The BoundaryConditions collection)
Line 47: Line 47:
 
!width="100px"|Wildcards
 
!width="100px"|Wildcards
 
!width="150px"|Simulations
 
!width="150px"|Simulations
!width="150px"|Notes
+
!width="175px"|Notes
  
 
|-valign="top"
 
|-valign="top"
Line 57: Line 57:
 
|
 
|
 
*all simulations
 
*all simulations
|Added in [[GEOS-Chem 12#12.4.0|12.4.0]]
+
|
 +
*<span style="color:darkgreen">'''Added in 12.4.0'''</span>
 
|}
 
|}
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:54, 18 July 2019 (UTC)
 
  
 
== The ConcAboveSfc collection ==
 
== The ConcAboveSfc collection ==
  
 
The ConcAboveSfc collection is [[History collections for dry deposition#The ConcAboveSfc collection|listed on our ''History collections for dry deposition'' page]].
 
The ConcAboveSfc collection is [[History collections for dry deposition#The ConcAboveSfc collection|listed on our ''History collections for dry deposition'' page]].
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 21:24, 18 July 2019 (UTC)
 
  
 
== The ConcAfterChem collection ==
 
== The ConcAfterChem collection ==
Line 112: Line 109:
 
!width="100px"|Wildcards
 
!width="100px"|Wildcards
 
!width="150px"|Simulations
 
!width="150px"|Simulations
!width="150px"|Notes
+
!width="175px"|Notes
  
 
|-valign="top"
 
|-valign="top"
Line 139: Line 136:
 
*tropchem
 
*tropchem
 
|
 
|
*New addition to GEOS-Chem restart file in [[GEOS-Chem 12#12.1.0|12.1.0]]
+
*<span style="color:darkgreen">'''Added in 12.1.0'''</span>
 
*Replaced local array <tt>H2O2s</tt> in wetscav_mod.F
 
*Replaced local array <tt>H2O2s</tt> in wetscav_mod.F
  
Line 155: Line 152:
 
*tropchem
 
*tropchem
 
|
 
|
*New in [[GEOS-Chem 12#12.1.0|12.1.0]]
+
*<span style="color:darkgreen">'''Added in 12.1.0'''</span>
 
*Replaced local array <tt>SO2s</tt> in wetscav_mod.F
 
*Replaced local array <tt>SO2s</tt> in wetscav_mod.F
  
Line 170: Line 167:
 
*tropchem
 
*tropchem
 
|
 
|
*New in [[GEOS-Chem 12#12.1.0|12.1.0]]
+
*<span style="color:darkgreen">'''Added in 12.1.0'''</span>
 
*Replaced local array <tt>DRY_TOTN</tt> in get_ndep_mod.F
 
*Replaced local array <tt>DRY_TOTN</tt> in get_ndep_mod.F
  
Line 185: Line 182:
 
*tropchem
 
*tropchem
 
|
 
|
*New in [[GEOS-Chem 12#12.1.0|12.1.0]]
+
*<span style="color:darkgreen">'''Added in 12.1.0'''</span>
 
*Replaced local array <tt>WET_TOTN</tt> in get_ndep_mod.F
 
*Replaced local array <tt>WET_TOTN</tt> in get_ndep_mod.F
  
Line 200: Line 197:
 
*tropchem
 
*tropchem
 
|
 
|
*New in [[GEOS-Chem 12#12.1.0|12.1.0]]
+
*<span style="color:darkgreen">'''Added in 12.1.0'''</span>
 
*Replaced local array <tt>HSAVE_KPP</tt> in flexchem_mod.F90
 
*Replaced local array <tt>HSAVE_KPP</tt> in flexchem_mod.F90
  
Line 222: Line 219:
 
*all simulations
 
*all simulations
 
|
 
|
*New in [[GEOS-Chem 12#12.1.0|12.1.0]]
+
*<span style="color:darkgreen">'''Added in 12.1.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
Line 232: Line 229:
 
*all simulations
 
*all simulations
 
|
 
|
*New in [[GEOS-Chem 12#12.1.0|12.1.0]]
+
*<span style="color:darkgreen">'''Added in 12.1.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
Line 242: Line 239:
 
*all simulations
 
*all simulations
 
|
 
|
*New in [[GEOS-Chem 12#12.1.0|12.1.0]]
+
*<span style="color:darkgreen">'''Added in 12.1.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
Line 252: Line 249:
 
*all simulations
 
*all simulations
 
|
 
|
*New in [[GEOS-Chem 12#12.1.0|12.1.0]]
+
*<span style="color:darkgreen">'''Added in 12.1.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
Line 262: Line 259:
 
*all simulations
 
*all simulations
 
|
 
|
*New in [[GEOS-Chem 12#12.1.0|12.1.0]]
+
*<span style="color:darkgreen">'''Added in 12.1.0'''</span>
  
 
|}
 
|}
 
--[[User:Melissa Payer|Melissa Sulprizio]] ([[User talk:Melissa Payer|talk]]) 16:05, 7 November 2018 (UTC)
 
  
 
== The SpeciesConc collection ==
 
== The SpeciesConc collection ==
Line 294: Line 289:
 
!width="100px"|Wildcards
 
!width="100px"|Wildcards
 
!width="150px"|Simulations
 
!width="150px"|Simulations
!width="150px"|Notes
+
!width="175px"|Notes
 
!width="100px"|[[List of diagnostics archived to bpch format|Bpch equiv.]]
 
!width="100px"|[[List of diagnostics archived to bpch format|Bpch equiv.]]
  
Line 325: Line 320:
 
*[[List of diagnostics archived to bpch format|ND51]]
 
*[[List of diagnostics archived to bpch format|ND51]]
 
|}
 
|}
 
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 20:36, 18 July 2019 (UTC)
 
  
  
 
----
 
----
 
'''''[[History collections for methane|Previous]] | [[History collections for TransportTracers|Next]] | [[Guide to GEOS-Chem History diagnostics]]'''''
 
'''''[[History collections for methane|Previous]] | [[History collections for TransportTracers|Next]] | [[Guide to GEOS-Chem History diagnostics]]'''''

Revision as of 22:38, 8 December 2020

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 BoundaryConditions collection

NOTE: If you are not setting up for a nested-grid simulation, then you can disable this collection.

The BoundaryConditions diagnostic collection contains advected species concentrations (archived from a global simulation) that will be used by nested-grid simulations as transport boundary conditions. Like SpeciesConc, it archives data with units of mol/mol dry air.

Here is a sample definition section for the SpeciesConc 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.
  BoundaryConditions.template:   '%y4%m2%d2_%h2%n2z.nc4',
  BoundaryConditions.format:     'CFIO',
  BoundaryConditions.frequency:  00000000 030000
  BoundaryConditions.duration:   00000100 000000
  BoundaryConditions.mode:       'instantaneous'
  BoundaryConditions.fields:     'SpeciesBC_?ADV?             ', 'GIGCchem',
::

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

Diagnostic name Description Units Wildcards Simulations Notes
SpeciesBC_<spcname> Advected species concentrations used as boundary conditions for nested-grid simulations mol/mol dry air
  • ?ADV?
  • all simulations
  • Added in 12.4.0

The ConcAboveSfc collection

The ConcAboveSfc collection is listed on our History collections for dry deposition page.

The ConcAfterChem collection

The ConcAfterChem collection is listed on our History collections for chemistry and photolysis page.

--Bob Yantosca (talk) 14:21, 19 July 2019 (UTC)

The Restart collection

The Restart diagnostic collection contains fields for saving out to the GEOS-Chem restart file. This type of diagnostic output is used in all GEOS-Chem simulations; therefore, we have listed Restart first in the HISTORY.rc files that ship with each GEOS-Chem run directory.

Here is a sample definition section for the Restart 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.

NOTE: The restart file will be created in the GEOS_Chem run directory, not in the OutputDir sub-folder.

  Restart.filename:           './GEOSChem.Restart.%y4%m2%d2_%h2%n2z.nc4',
  Restart.format:             'CFIO',
  Restart.frequency:          'End',
  Restart.duration:           'End',
  Restart.mode:               'instantaneous'
  Restart.fields:             'SpeciesRst_?ALL?               ', 'GIGCchem',
                              'Chem_H2O2AfterChem             ', 'GIGCchem',
                              'Chem_SO2AfterChem              ', 'GIGCchem',
                              'Chem_DryDepNitrogen            ', 'GIGCchem',
                              'Chem_WetDepNitrogen            ', 'GIGCchem',
                              'Chem_KPPHvalue                 ', 'GIGCchem',
                              'Met_DELPDRY                    ', 'GIGCchem',
                              'Met_PS1WET                     ', 'GIGCchem',
                              'Met_PS1DRY                     ', 'GIGCchem',
                              'Met_SPHU1                      ', 'GIGCchem',
                              'Met_TMPU1                      ', 'GIGCchem',
::

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

Diagnostic name Description Units Wildcards Simulations Notes
SpeciesRst_<spcname> Instantaneous chemical species concentrations for use in starting subsequent GEOS-Chem simulations mol/mol dry air
  • ?ALL?
  • all simulations
  • Use ?ALL? to make sure all species get archived
  • Variables renamed from SPC_ to SpeciesRst_ in 12.1.0
Chm_H2O2AfterChem Concentration of H2O2 after sulfate chemistry v/v
  • aerosol only
  • benchmark
  • complexSOA
  • complexSOA_SVPOA
  • standard
  • tropchem
  • Added in 12.1.0
  • Replaced local array H2O2s in wetscav_mod.F
Chm_SO2AfterChem Concentration of SO2 after sulfate chemistry v/v
  • aerosol only
  • benchmark
  • complexSOA
  • complexSOA_SVPOA
  • standard
  • tropchem
  • Added in 12.1.0
  • Replaced local array SO2s in wetscav_mod.F
Chm_DryDepNitrogen Dry deposited nitrogen molec/cm2/s
  • benchmark
  • complexSOA
  • complexSOA_SVPOA
  • standard
  • tropchem
  • Added in 12.1.0
  • Replaced local array DRY_TOTN in get_ndep_mod.F
Chm_WetDepNitrogen Wet deposited nitrogen molec/cm2/s
  • benchmark
  • complexSOA
  • complexSOA_SVPOA
  • standard
  • tropchem
  • Added in 12.1.0
  • Replaced local array WET_TOTN in get_ndep_mod.F
Chm_KPPHvalue H-value for Rosenbrock solver unitless
  • benchmark
  • complexSOA
  • complexSOA_SVPOA
  • standard
  • tropchem
  • Added in 12.1.0
  • Replaced local array HSAVE_KPP in flexchem_mod.F90
Chm_StatePSC Polar stratospheric cloud type count
  • benchmark
  • standard
  • Moved to Restart collection from HEMCO restart file in 12.1.0
Met_DELPDRY Delta-pressure across grid box (dry air) hPa
  • all simulations
  • Added in 12.1.0
Met_PS1WET Wet surface pressure at dt start hPa
  • all simulations
  • Added in 12.1.0
Met_PS1DRY Dry surface pressure at dt start hPa
  • all simulations
  • Added in 12.1.0
Met_SPHU1 Instantaneous specific humidity at time=T g kg-1
  • all simulations
  • Added in 12.1.0
Met_TMPU1 Instantaneous temperature at time=T K
  • all simulations
  • Added in 12.1.0

The SpeciesConc collection

The SpeciesConc diagnostic collection contains advected species concentrations. This type of diagnostic output is used in all GEOS-Chem simulations.

Here is a sample definition section for the SpeciesConc 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.
  SpeciesConc.template:       '%y4%m2%d2_%h2%n2z.nc4',
  SpeciesConc.format:         'CFIO',
  SpeciesConc.frequency:      00000100 000000
  SpeciesConc.duration:       00000100 000000
  SpeciesConc.mode:           'time-averaged'
  SpeciesConc.fields:         'SpeciesConc_?ADV?             ', 'GIGCchem',
::

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

Diagnostic name Description Units Wildcards Simulations Notes Bpch equiv.
SpeciesConc_<spcname> Chemical species concentrations mol/mol dry air
  • ?ADV?
  • ?AER?
  • ?ALL?
  • ?DRYALT?
  • ?DRY?
  • ?FIX?
  • ?GAS?
  • ?HYG?
  • ?KPP?
  • ?PHO?
  • ?VAR?
  • ?WET?
  • all simulations



Previous | Next | Guide to GEOS-Chem History diagnostics