Difference between revisions of "Replicating the behavior of the prior timeseries diagnostics"
(→ND51 satellite diagnostic) |
(→ND51 satellite diagnostic) |
||
Line 104: | Line 104: | ||
== The SatDiagn collection (replaces bpch ND51) == | == 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 <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. | ||
+ | *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_* ', | ||
+ | 'SatDiagnOH ', | ||
+ | 'SatDiagnRH ', | ||
+ | 'SatDiagnAirDen ', | ||
+ | 'SatDiagnBoxHeight ', | ||
+ | 'SatDiagnPEdge ', | ||
+ | 'SatDiagnTROPP ', | ||
+ | 'SatDiagnPBLHeight ', | ||
+ | 'SatDiagnPBLTop ', | ||
+ | 'SatDiagnTAir ', | ||
+ | 'SatDiagnGWETROOT ', | ||
+ | 'SatDiagnGWETTOP ', | ||
+ | 'SatDiagnPARDR ', | ||
+ | 'SatDiagnPARDF ', | ||
+ | 'SatDiagnPRECTOT ', | ||
+ | 'SatDiagnSLP ', | ||
+ | 'SatDiagnSPHU ', | ||
+ | 'SatDiagnTS ', | ||
+ | 'SatDiagnPBLTOPL ', | ||
+ | 'SatDiagnMODISLAI ', | ||
+ | 'SatDiagnWetLossLS_* ', | ||
+ | 'SatDiagnWetLossConv_* ', | ||
+ | 'SatDiagnJval_* ', | ||
+ | 'SatDiagnJvalO3O1D ', | ||
+ | 'SatDiagnJvalO3O3P ', | ||
+ | 'SatDiagnDryDep_* ', | ||
+ | 'SatDiagnDryDepVel_* ', | ||
+ | 'SatDiagnDryDepVel_NO2 ', | ||
+ | 'SatDiagnDryDepVel_O3 ', | ||
+ | 'SatDiagnOHreactivity ', | ||
+ | 'SatDiagnColEmis_* ', | ||
+ | 'SatDiagnSurfFlux_* ', | ||
+ | 'SatDiagnProd_?PRD? ', | ||
+ | 'SatDiagnLoss_?LOS? ', | ||
+ | 'SatDiagnRxnRate_EQnnn ', | ||
+ | :: | ||
+ | |||
+ | |||
+ | This table describes the diagnostic quantities belonging to the BoundaryConditions collection: | ||
+ | |||
+ | {| border=1 cellspacing=0 cellpadding=5 | ||
+ | |-valign="top" bgcolor="#CCCCCC" | ||
+ | !width="225px"|Diagnostic name | ||
+ | !width="225px"|Description | ||
+ | !width="125px"|Units | ||
+ | !width="100px"|Wildcards | ||
+ | !width="150px"|Simulations | ||
+ | !width="175px"|Notes | ||
+ | |||
+ | |-valign="top" | ||
+ | |SpeciesBC_<spcname> | ||
+ | |Advected species concentrations used as boundary conditions for nested-grid simulations | ||
+ | |mol/mol dry air | ||
+ | | | ||
+ | *?ADV? | ||
+ | | | ||
+ | *all simulations | ||
+ | | | ||
+ | *<span style="color:darkgreen">'''Added in 12.4.0'''</span> | ||
+ | |} | ||
---- | ---- | ||
'''''[[History collections for CO2|Previous]] | [[Adding new History diagnostics|Next]] | [[Guide to GEOS-Chem History diagnostics]]''''' | '''''[[History collections for CO2|Previous]] | [[Adding new History diagnostics|Next]] | [[Guide to GEOS-Chem History diagnostics]]''''' |
Revision as of 20:32, 28 March 2023
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
On this page we discuss our plans to replicate specialty diagnostic outputs (timeseries, local-time diagnostics, etc.) in with the GEOS-Chem History diagnostics..
Contents
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:
- 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)
- Set duration: 00000001 000000
- Specify instantaneous output:
- 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:
- 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
- Specify time-averaged output:
- 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_* ', 'SatDiagnOH ', 'SatDiagnRH ', 'SatDiagnAirDen ', 'SatDiagnBoxHeight ', 'SatDiagnPEdge ', 'SatDiagnTROPP ', 'SatDiagnPBLHeight ', 'SatDiagnPBLTop ', 'SatDiagnTAir ', 'SatDiagnGWETROOT ', 'SatDiagnGWETTOP ', 'SatDiagnPARDR ', 'SatDiagnPARDF ', 'SatDiagnPRECTOT ', 'SatDiagnSLP ', 'SatDiagnSPHU ', 'SatDiagnTS ', 'SatDiagnPBLTOPL ', 'SatDiagnMODISLAI ', 'SatDiagnWetLossLS_* ', 'SatDiagnWetLossConv_* ', 'SatDiagnJval_* ', 'SatDiagnJvalO3O1D ', 'SatDiagnJvalO3O3P ', 'SatDiagnDryDep_* ', 'SatDiagnDryDepVel_* ', 'SatDiagnDryDepVel_NO2 ', 'SatDiagnDryDepVel_O3 ', 'SatDiagnOHreactivity ', 'SatDiagnColEmis_* ', 'SatDiagnSurfFlux_* ', 'SatDiagnProd_?PRD? ', 'SatDiagnLoss_?LOS? ', 'SatDiagnRxnRate_EQnnn ', ::
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 |
|
|
|