Legend for History 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

This section contains a description of how the information about each diagnostic quantity is arranged in the sections below.

General information about each diagnostic

The tables below list the following parameters for each diagnostic that is archived to bpch format:

Diagnostic name The name of the given diagnostic quantity that will be archived to netCDF file format.
  • NOTE: Wildcards can be used with certain diagnostics. This will let you specify all possible species, wavelength bins, etc. for a given diagnostic instead of having to list them individually. See the next section for a list of all possible wildcards.
  • ALSO NOTE: At this time, wildcards are not allowed in GCHP simulations. We are working to resolve this.
Description A short overview of the given diagnostic.
Units The physical units of the given diagnostic quantity.
Wildcards A list of wildcards that can be used to specify all possible species, wavelength bins, etc. for the given diagnostic quantity. For a complete list of wildcards, please see the table below.
Simulations A list of simulations for which this particular diagnostic is valid.
Bpch equivalent The NDxx diagnostic number (and slot) under which the same diagnostic is available as bpch output. See the List of diagnostics archived to bpch format wiki page for more information.
Notes Lists supplemental information for the given diagnostic.

Wildcards and prefixes

The following terms are used in the tables below.

Term Explanation Example
<spcname> Short name of a GEOS-Chem species, used in several diagnostics listed below.


  1. The single-underscore (_) preceding the species name indicates that use of a species wildcard (e.g SpeciesConc_?ADV?, which only selects advected species) is possible.
  2. Allowable wild card values (case-insensitive) for species name are:
    • ?ADV?: Only the advected species
    • ?AER?: Only the aerosol species
    • ?ALL?: All GEOS-Chem species
    • ?DRYALT?: Only the dry-deposited species whose concentrations we wish to archive at a given altitude above the surface. (In practice these are only O3 and HNO3.)
    • ?DRY?: Only the dry-deposited species
    • ?FIX?: Only the inactive (aka "fixed") species in the KPP chemical mechanism
    • ?GAS?: Only the gas-phase species
    • ?HYG?: Only aerosols that undergo hygroscopic growth
      • (e.g. sulfate, BC, OC, SALA, SALC)
    • ?LOS?: Only chemical loss species or families
    • ?KPP?: Only the KPP species
    • ?PHO: Only the photolyzed species
    • ?VAR?: Only the active (aka "variable") species in the KPP chemical mechanism
    • ?WET?: Only the wet-deposited species
    • ?PRD?: Only chemical production species or families
    • ?DUSTBIN: Only the dust bin number
  3. <spcname> should be case-insensitive. In most places where species names are compared, species names are first converted to uppercase and then a string match test is done. But because most species names represent a chemical formula (e.g. NO, CO),they will be mostly all uppercase. Some species names would have mixed-case, e.g. BrCl, Rn, Pb, Be7, etc.
  • SpeciesConc_NO
  • SpeciesConc_CO
  • SpeciesConc_?ADV?
  • SpeciesConc_?AER?
  • SpeciesConc_?ALL?
  • SpeciesConc_?DRYALT?
  • SpeciesConc_?DUSTBIN?
  • SpeciesConc_?PHO?
  • SpeciesConc_?FIX?
  • SpeciesConc_?GAS?
  • SpeciesConc_?HYG
  • SpeciesConc_?LOS?
  • SpeciesConc_?KPP?
  • SpeciesConc_?PHO?
  • SpeciesConc_?PRD?
  • SpeciesConc_?VAR?
  • SpeciesConc_?WET?
<photobin> Number of a given wavelength bin for FAST-JX photolysis
  • 1-18 (with UCX on);
  • 1-12 (with UCX off)
<KPPrxn> To request diagnostics for all reactions in a mechanism rather than listing out EQ001, EQ002, ..., EQnnn use the ?RXN? wildcard.
  • RxnRate_?RXN?
  • RxnConst_?RXN?
Chem_ To request diagnostic output for fields of the State_Chm object (other than SpeciesConc), add this prefix in front of the field name. (Prefix is case-insensitive.)
  • Chem_phCloud
  • Chem_HplusSav
Met_ To request diagnostic output for fields of the State_Met object, add this prefix in front of the field name. (Prefix is case-insensitive.)
  • Met_T
  • Met_PS
  • Met_SPHU
  • Met_U10M

--Bob Yantosca (talk) 14:00, 8 June 2018 (UTC)

Previous | Next | Guide to GEOS-Chem History diagnostics