Difference between revisions of "History collections for species concentrations"

From Geos-chem
Jump to: navigation, search
(The Restart collection)
(The Restart collection)
Line 36: Line 36:
 
!width="80px"|Wildcards
 
!width="80px"|Wildcards
 
!width="150px"|Simulations
 
!width="150px"|Simulations
!width="250px"|Notes
+
!width="150px"|Notes
  
 
|-valign="top"
 
|-valign="top"
Line 46: Line 46:
 
|
 
|
 
*all simulations
 
*all simulations
|
 
 
|
 
|
 
*Use <tt>?ALL?</tt> to make sure all species get archived
 
*Use <tt>?ALL?</tt> to make sure all species get archived
Line 63: Line 62:
 
*standard
 
*standard
 
*tropchem
 
*tropchem
|
 
 
|
 
|
 
*New addition to GEOS-Chem restart file in [[GEOS-Chem 12#12.1.0|12.1.0]]
 
*New addition to GEOS-Chem restart file in [[GEOS-Chem 12#12.1.0|12.1.0]]
Line 81: Line 79:
 
*tropchem
 
*tropchem
 
|
 
|
|
+
*New in [[GEOS-Chem 12#12.1.0|12.1.0]]
*New addition to GEOS-Chem restart file in [[GEOS-Chem 12#12.1.0|12.1.0]]
+
 
*Replaced local array <tt>SO2s</tt> in wetscav_mod.F
 
*Replaced local array <tt>SO2s</tt> in wetscav_mod.F
  
Line 97: Line 94:
 
*tropchem
 
*tropchem
 
|
 
|
|
+
*New in [[GEOS-Chem 12#12.1.0|12.1.0]]
*New addition to GEOS-Chem restart file in [[GEOS-Chem 12#12.1.0|12.1.0]]
+
 
*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 113: Line 109:
 
*tropchem
 
*tropchem
 
|
 
|
|
+
*New in [[GEOS-Chem 12#12.1.0|12.1.0]]
*New addition to GEOS-Chem restart file in [[GEOS-Chem 12#12.1.0|12.1.0]]
+
 
*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 129: Line 124:
 
*tropchem
 
*tropchem
 
|
 
|
|
+
*New in [[GEOS-Chem 12#12.1.0|12.1.0]]
*New addition to GEOS-Chem restart file in [[GEOS-Chem 12#12.1.0|12.1.0]]
+
 
*Replaced local array <tt>HSAVE_KPP</tt> in flexchem_mod.F90
 
*Replaced local array <tt>HSAVE_KPP</tt> in flexchem_mod.F90
  
Line 141: Line 135:
 
*benchmark
 
*benchmark
 
*standard
 
*standard
|
 
 
|
 
|
 
*Moved to Restart collection from HEMCO restart file in [[GEOS-Chem 12#12.1.0|12.1.0]]
 
*Moved to Restart collection from HEMCO restart file in [[GEOS-Chem 12#12.1.0|12.1.0]]
Line 153: Line 146:
 
*all simulations
 
*all simulations
 
|
 
|
|
+
*New in [[GEOS-Chem 12#12.1.0|12.1.0]]
*New addition to GEOS-Chem restart file in [[GEOS-Chem 12#12.1.0|12.1.0]]
+
  
 
|-valign="top"
 
|-valign="top"
Line 164: Line 156:
 
*all simulations
 
*all simulations
 
|
 
|
|
+
*New in [[GEOS-Chem 12#12.1.0|12.1.0]]
*New addition to GEOS-Chem restart file in [[GEOS-Chem 12#12.1.0|12.1.0]]
+
  
 
|-valign="top"
 
|-valign="top"
Line 175: Line 166:
 
*all simulations
 
*all simulations
 
|
 
|
|
+
*New in [[GEOS-Chem 12#12.1.0|12.1.0]]
*New addition to GEOS-Chem restart file in [[GEOS-Chem 12#12.1.0|12.1.0]]
+
  
 
|-valign="top"
 
|-valign="top"
Line 186: Line 176:
 
*all simulations
 
*all simulations
 
|
 
|
|
+
*New in [[GEOS-Chem 12#12.1.0|12.1.0]]
*New addition to GEOS-Chem restart file in [[GEOS-Chem 12#12.1.0|12.1.0]]
+
  
 
|-valign="top"
 
|-valign="top"
Line 197: Line 186:
 
*all simulations
 
*all simulations
 
|
 
|
|
+
*New in [[GEOS-Chem 12#12.1.0|12.1.0]]
*New addition to GEOS-Chem restart file in [[GEOS-Chem 12#12.1.0|12.1.0]]
+
  
 
|}
 
|}

Revision as of 20:52, 18 July 2019


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 SpeciesConc collection. 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
  • New addition to GEOS-Chem restart file 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
  • New 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
  • New 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
  • New 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
  • New 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
Met_PS1WET Wet surface pressure at dt start hPa
  • all simulations
Met_PS1DRY Dry surface pressure at dt start hPa
  • all simulations
Met_SPHU1 Instantaneous specific humidity at time=T g kg-1
  • all simulations
Met_TMPU1 Instantaneous temperature at time=T K
  • all simulations

--Melissa Sulprizio (talk) 16:05, 7 November 2018 (UTC)

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. 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 Bpch equiv. Notes
SpeciesConc_<spcname> Chemical species concentrations mol/mol dry air
  • ?ADV?
  • ?AER?
  • ?ALL?
  • ?DRYALT?
  • ?DRY?
  • ?FIX?
  • ?GAS?
  • ?HYG?
  • ?KPP?
  • ?PHO?
  • ?VAR?
  • ?WET?
  • all simulations

--Bob Yantosca (talk) 20:36, 18 July 2019 (UTC)

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. 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 SpeciesConc collection:

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

--Bob Yantosca (talk) 20:31, 18 July 2019 (UTC)