Replicating the behavior of the prior timeseries diagnostics

From Geos-chem
Jump to: navigation, search

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


On this page we discuss our plans to replicate specialty diagnostic outputs (timeseries, local-time diagnostics, etc.) in with the GEOS-Chem History diagnostics..

ND40 planeflight diagnostic

At present, there are no plans to remove the planeflight diagnostic in GEOS-Chem classic. You may continue to use it.

The ObsPack diagnostic can also archive point data at selected station sites. The coordinates (lat, lon, altitude, species) must be contained in in NOAA ObsPack-format netCDF files.

ND48 station diagnostics

The GEOS-Chem History diagnostics are unable to replicate the point station data output of the prior ND48 station timeseries. If you need to archive this type of data, we would recommend that you consider using the ObsPack diagnostic, which can save GEOS-Chem output at point locations.

ND49 instantaneous timeseries diagnostic

You can replicate the ND49 bpch diagnostic (instantaneous timeseries) as follows:

  1. Define a diagnostic collection in HISTORY.rc:
    • Specify instantaneous output:
      • Set mode: instantaneous
    • Specify the desired output frequency:
      • Set frequency: 00000000 010000 for hourly output
      • Set frequency: 00000000 030000 for 3-hourly output
      • Set frequency: 00000000 120000 for 12-hourly output, etc.
        • You can also use the full date/time descriptor (00000000 010000, etc.)
    • Specify that a new netCDF file should be created every 24 hours = 1 day:
      • Set duration: 00000001 000000
        • You can also use the full date/time descriptor (00000001 000000)
  2. Within this diagnostic collection, you can add archive any available quantity from the State_Met, State_Chm, or State_Diag objects.

Example:

#===================================================================
# Add an instantaneous timeseries collection to the master list
#===================================================================
COLLECTIONS: 'inst3hr',
::
#====================================================================
# Define the properties of the instantaneous timeseries collection 
#====================================================================
  inst3hr.template:      '%y4%m2%d2_%h2%n2z.nc4',
  inst3hr.format:        'CFIO'
  inst3hr.frequency:      00000000 030000,
  inst3hr.duration:       00000001 000000,
  inst3hr.mode:          'instantaneous',
  inst3hr.fields:        'SpeciesConc_?ADV?', 'GIGCchem',
                         'Met_T',             'GIGCchem',
                         'DryDepVel_?DRY?',   'GIGCchem',
::

ND50 24-hr average timeseries diagnostic

You can replicate the ND50 bpch diagnostic (24-hr average timeseries) as follows:

  1. Define a diagnostic collection in HISTORY.rc:
    • Specify time-averaged output:
      • Set mode: time-averaged
    • Specify daily output frequency. This will also set the averaging interval to be daily.
      • Set frequency: 00000001 000000
    • Specify that a new netCDF file should be created every 24 hours:
      • Set duration: 00000001 000000
  2. Within this diagnostic collection, you can add archive any available quantity from the State_Met, State_Chm, or State_Diag objects.

Example:

#===================================================================
# Add an 24-hr average timeseries collection to the master list
#===================================================================
COLLECTIONS: avg24hr',
::
#===================================================================
# Define the properties of the 24-hr average timeseries collection
#===================================================================
  avg24hr.template:      '%y4%m2%d2_%h2%n2z.nc4',
  avg24hr.format:        'CFIO'
  avg24hr.frequency:     00000001 000000
  avg24hr.duration:      00000001 000000
  avg24hr.mode:          'time-averaged',
  avg24hr.fields:        'SpeciesConc_?ADV?', 'GIGCchem',
                         'Met_T',             'GIGCchem',
                         'DryDepVel_?DRY?',   'GIGCchem',
::

The SatDiagn collection (replaces bpch ND51)

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.
#==============================================================================
# %%%%% THE SatDiagn COLLECTION %%%%%
#
# GEOS-Chem data during satellite overpass
#
# Available for all simulations
#==============================================================================
  SatDiagn.template:          '%y4%m2%d2_%h2%n2z.nc4',
  SatDiagn.format:            'CFIO',
  SatDiagn.frequency:         00000001 000000
  SatDiagn.duration:          00000100 000000
  SatDiagn.hrrange:           11.98 15.02
  SatDiagn.mode:              'time-averaged'
  SatDiagn.fields:            'SatDiagnConc_<spcname>         ',
                              'SatDiagnOH                     ',
                              'SatDiagnRH                     ',
                              'SatDiagnAirDen                 ',
                              'SatDiagnBoxHeight              ',
                              'SatDiagnPEdge                  ',
                              'SatDiagnTROPP                  ',
                              'SatDiagnPBLHeight              ',
                              'SatDiagnPBLTop                 ',
                              'SatDiagnTAir                   ',
                              'SatDiagnGWETROOT               ',
                              'SatDiagnGWETTOP                ',
                              'SatDiagnPARDR                  ',
                              'SatDiagnPARDF                  ',
                              'SatDiagnPRECTOT                ',
                              'SatDiagnSLP                    ',
                              'SatDiagnSPHU                   ',
                              'SatDiagnTS                     ',
                              'SatDiagnPBLTOPL                ',
                              'SatDiagnMODISLAI               ',
                              'SatDiagnWetLossLS_<spcname>    ',
                              'SatDiagnWetLossConv_<spcname>  ',
                              'SatDiagnJval_<spcname>         ',
                              'SatDiagnJvalO3O1D              ',
                              'SatDiagnJvalO3O3P              ',
                              'SatDiagnDryDep_<spcname>       ',
                              'SatDiagnDryDepVel_<spcname>    ',
                              'SatDiagnOHreactivity           ',
                              'SatDiagnColEmis_<spcname>      ',
                              'SatDiagnSurfFlux_<spcname>     ',
                              'SatDiagnProd_?PRD?             ',
                              'SatDiagnLoss_?LOS?             ',
                              'SatDiagnRxnRate_EQnnn          ',
::

Previous | Next | Guide to GEOS-Chem History diagnostics