Difference between revisions of "GEOS-Chem diagnostic output files"

From Geos-chem
Jump to: navigation, search
(List of History output files by collection)
 
(42 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
__FORCETOC__
 
__FORCETOC__
'''''[[GEOS-Chem restart files|Previous]] | [[Guide_to_visualization_and_analysis_tools_for_GEOS-Chem|Next]] | [[Getting Started with GEOS-Chem]]'''''
+
'''''[[GEOS-Chem restart files|Previous]] | [[Python tools for use with GEOS-Chem|Next]] | [[Getting Started with GEOS-Chem]]'''''
#[[Minimum system requirements for GEOS-Chem|Minimum system requirements]]
+
#[[Minimum system requirements for GEOS-Chem|Minimum system requirements (and software installation)]]
 +
#[[Configuring your computational environment]]
 
#[[Downloading GEOS-Chem source code|Downloading source code]]
 
#[[Downloading GEOS-Chem source code|Downloading source code]]
 
#[[Downloading GEOS-Chem data directories|Downloading data directories]]
 
#[[Downloading GEOS-Chem data directories|Downloading data directories]]
 
#[[Creating GEOS-Chem run directories|Creating run directories]]
 
#[[Creating GEOS-Chem run directories|Creating run directories]]
#[[GEOS-Chem input files|Configuring runs]]
+
#[[GEOS-Chem configuration files|Configuring runs]]
 
#[[Compiling GEOS-Chem|Compiling]]
 
#[[Compiling GEOS-Chem|Compiling]]
 
#[[Running GEOS-Chem|Running]]
 
#[[Running GEOS-Chem|Running]]
Line 12: Line 13:
 
#*[[GEOS-Chem restart files|Restart files]]
 
#*[[GEOS-Chem restart files|Restart files]]
 
#*<span style="color:blue">'''Diagnostic output files'''</span>
 
#*<span style="color:blue">'''Diagnostic output files'''</span>
#[[Guide_to_visualization_and_analysis_tools_for_GEOS-Chem|Visualizing and processing output]]
+
#[[Python tools for use with GEOS-Chem]]
 
#[[GEOS-Chem_coding_and_debugging|Coding and debugging]]
 
#[[GEOS-Chem_coding_and_debugging|Coding and debugging]]
 
#[[GEOS-Chem_overview#Further_reading|Further reading]]
 
#[[GEOS-Chem_overview#Further_reading|Further reading]]
  
  
[[Image:Page is under construction.jpg]]
+
On this page, we list the files that are generated by GEOS-Chem's various diagnostic packages.
 
+
We will be adding some more information here shortly. In the meantime, please see our ''[[Guide to GEOS-Chem diagnostics]]'' for more information about files that are generated by the various GEOS_Chem diagnostics.
+
  
 
== History diagnostics output ==
 
== History diagnostics output ==
  
The following files, which correspond to the [[Collections_for_History_diagnostics|default History diagnostic collections]], will be created in the <tt>OutputDir/</tt> folder in your GEOS-Chem run directory.  You can prevent any of these files by commenting out the collection name in the HISTORY.rc configuration file.  You can also add your own new collections (i.e. requesting species concentrations for both time-averaged and instantaneous averaging modes) by updating HISTORY.rc.
+
The following files, which correspond to the [[Collections_for_History_diagnostics|default History diagnostic collections]], will be created in the <tt>OutputDir/</tt> folder in your GEOS-Chem run directory.  You can prevent any of these files from being created by commenting out the collection name in the [[Overview_of_History_diagnostics#Sample_HISTORY.rc_diagnostic_input_file|HISTORY.rc configuration file]].  You can also add your own new collections (i.e. requesting species concentrations for both time-averaged and instantaneous averaging modes) by updating HISTORY.rc. For more information, please see our ''[[Guide to GEOS-Chem History diagnostics]]''.
 
+
For more information, please see our ''[[Guide to GEOS-Chem History diagnostics]]''.
+
 
+
=== List of History output files by collection ===
+
  
 
In the table below, <tt>YYYYMMDD</tt> and <tt>hhmms</tt> corresponds to the simulation date and time at which the file was created.  The <tt>z</tt> indicates UTC (sometimes called "Zulu" time).
 
In the table below, <tt>YYYYMMDD</tt> and <tt>hhmms</tt> corresponds to the simulation date and time at which the file was created.  The <tt>z</tt> indicates UTC (sometimes called "Zulu" time).
Line 33: Line 28:
 
{| border=1 cellspacing=0 cellpadding=5  
 
{| border=1 cellspacing=0 cellpadding=5  
 
|-valign="top" bgcolor="#CCCCCC"
 
|-valign="top" bgcolor="#CCCCCC"
!width="400px"|Diagnostic file name
+
!width="400px"|History diagnostic file name
!width="125px"|Collection
+
!width="100px"|Format
!width="300px"|Created by
+
!width="150px"|Collection
 +
!width="300px"|For simulation(s)
 
!width="150px"|Added/Removed
 
!width="150px"|Added/Removed
  
 
|-valign="top"
 
|-valign="top"
 
|<tt>GEOSChem.AdvFluxVert.YYYYMMDD_hhmmz.nc4</tt>
 
|<tt>GEOSChem.AdvFluxVert.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 
|[[History_collections_for_advection_and_mixing#The_AdvFluxVert_collection|AdvFluxVert]]
 
|[[History_collections_for_advection_and_mixing#The_AdvFluxVert_collection|AdvFluxVert]]
 
|
 
|
*All simulations
+
*fullchem_benchmark
*Typically used only with benchmark
+
 
|
 
|
*Added in [[GEOS-Chem 12#12.6.0|12.6.0]]
+
*<span style="color:darkgreen">'''Added in 12.6.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
 
|<tt>GEOSChem.AerosolMass.YYYYMMDD_hhmmz.nc4</tt>
 
|<tt>GEOSChem.AerosolMass.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 
|[[History_collections_for_aerosols#The_AerosolMass_collection|AerosolMass]]
 
|[[History_collections_for_aerosols#The_AerosolMass_collection|AerosolMass]]
 
|
 
|
*All full-chemistry simulations
+
*fullchem
*Aerosol-only simulations
+
*aerosol
 
|
 
|
 +
*<span style="color:darkgreen">'''Added in 12.0.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
 
|<tt>GEOSChem.Aerosols.YYYYMMDD_hhmmz.nc4</tt>
 
|<tt>GEOSChem.Aerosols.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 
|[[History_collections_for_aerosols#The_Aerosols_collection|Aerosols]]
 
|[[History_collections_for_aerosols#The_Aerosols_collection|Aerosols]]
 
|
 
|
*All full-chemistry simulations
+
*fullchem
*Aerosol-only simulations
+
*aerosol
 
|
 
|
 +
*<span style="color:darkgreen">'''Added in 12.0.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
 
|<tt>GEOSChem.BoundaryConditions.YYYYMMDD_hhmmz.nc4</tt>
 
|<tt>GEOSChem.BoundaryConditions.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 
|[[History_collections_for_species_concentrations#The_BoundaryConditions_collection|BoundaryConditions]]
 
|[[History_collections_for_species_concentrations#The_BoundaryConditions_collection|BoundaryConditions]]
 
|
 
|
*Can be created by all simulations
+
*can be created by: all simulations
*Can be read in by nested-grid simulations
+
*can be read by: nested-grid simulations
 
|
 
|
*Added in [[GEOS-Chem 12#12.4.0|12.4.0]]
+
*<span style="color:darkgreen">'''Added in 12.4.0'''</span>
  
 
|-valign="top"
 
|-valign="top"
 
|<tt>GEOSChem.Budget.YYYYMMDD_hhmmz.nc4</tt>
 
|<tt>GEOSChem.Budget.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 
|[[History_collections_for_budgets#The_Budget_collection|Budget]]
 
|[[History_collections_for_budgets#The_Budget_collection|Budget]]
 +
|
 +
*all simulations
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.1.0'''</span>
 +
 +
|-valign="top"
 +
|<tt>GEOSChem.CH4.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 +
|[[History_collections_for_methane#The_CH4_collection|CH4]]
 +
|
 +
*CH4
 +
*tagCH4
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.1.0'''</span>
 +
 +
|-valign="top"
 +
|<tt>GEOSChem.CloudConvFlux.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 +
|[[History_collections_for_convection_and_wet_deposition#The_CloudConvFlux_collection|CloudConvFlux]]
 +
|
 +
*all simulations
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.0.0'''</span>
 +
 +
|-valign="top"
 +
|<tt>GEOSChem.ConcAboveSfc.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 +
|[[History_collections_for_dry_deposition#The_ConcAboveSfc_collection|ConcAboveSfc]]
 +
|
 +
*fullchem
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.6.0'''</span>
 +
 +
|-valign="top"
 +
|<tt>GEOSChem.ConcAfterChem.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 +
|[[History_collections_for_chemistry_and_photolysis#The_ConcAfterChem_collection|ConcAfterChem]]
 +
|
 +
*fullchem
 +
*CH4
 +
*tagCH4
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.0.0'''</span>
 +
 +
|-valign="top"
 +
|<tt>GEOSChem.DryDep.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 +
|[[History_collections_for_dry_deposition#The_DryDep_collection|DryDep]]
 +
|
 +
*simulations w/ drydep species
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.0.0'''</span>
 +
 +
|-valign="top"
 +
|<tt>GEOSChem.Jvalues.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 +
|[[History_collections_for_chemistry_and_photolysis#The_JValues_collection|JValues]]
 +
|
 +
*fullchem
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.0.0'''</span>
 +
 +
|-valign="top"
 +
|<tt>GEOSChem.KppDiags.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 +
|[[History_collections_for_chemistry_and_photolysis#KppDiags|KppDiags]]
 +
|
 +
*fullchem
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.7.0'''</span>
 +
 +
|-valign="top"
 +
|<tt>GEOSChem.LevelEdgeDiags.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 +
|[[History_collections_for_met_fields_and_related_quantities#The_LevelEdgeDiags_collection|LevelEdgeDiags]]
 +
|
 +
*all simulations
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.0.0'''</span>
 +
 +
|-valign="top"
 +
|<tt>GEOSChem.MercuryChem.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 +
|[[History_collections_for_mercury_and_POPs#The_MercuryChem_collection|MercuryChem]]
 +
|
 +
*Hg
 +
*tagHg
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.0.0'''</span>
 +
 +
|-valign="top"
 +
|<tt>GEOSChem.MercuryEmis.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 +
|[[History_collections_for_mercury_and_POPs#The_MercuryEmis_collection|MercuryEmis]]
 +
|
 +
*Hg
 +
*tagHg
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.0.0'''</span>
 +
 +
|-valign="top"
 +
|<tt>GEOSChem.MercuryOcean.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 +
|[[History_collections_for_mercury_and_POPs#The_MercuryEmis_collection|MercuryOcean]]
 +
|
 +
*Hg
 +
*tagHg
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.0.0'''</span>
 +
 +
|-valign="top"
 +
|<tt>GEOSChem.POPs.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 +
|[[History_collections_for_mercury_and_POPs#The_MercuryEmis_collection|POPs]]
 +
|
 +
*Hg
 +
*tagHg
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.0.0'''</span>
 +
 +
|-valign="top"
 +
|<tt>GEOSChem.Metrics.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 +
|[[History_collections_for_chemistry_and_photolysis#The_Metrics_collection|Metrics]]
 +
|
 +
*fullchem
 +
*CH4
 +
*tagCH4
 +
|
 +
*<span style="color:darkgreen">'''Added in 13.0.0'''</span>
 +
 +
|-valign="top"
 +
|<tt>GEOSChem.ProdLoss.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 +
|[[History_collections_for_chemistry_and_photolysis#The_ProdLoss_Collection|ProdLoss]]
 +
|
 +
*fullchem
 +
*aerosol
 +
*tagCO
 +
*tagO3
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.0.0'''</span>
 +
 +
|-valign="top"
 +
|<tt>GEOSChem.RadioNuclide.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 +
|[[History_collections_for_TransportTracers#The_RadioNuclide_Collection|RadioNuclide]]
 +
|
 +
*TransportTracers
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.0.0'''</span>
 +
 +
|-valign="top"
 +
|<tt>GEOSChem.SpeciesConc.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 +
|[[History_collections_for_species_concentrations#The_SpeciesConc_collection|SpeciesConc]]
 +
|
 +
*all simulations
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.0.0'''</span>
 +
 +
|-valign="top"
 +
|<tt>GEOSChem.StateChm.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 +
|[[History_collections_for_chemistry_and_photolysis#The_StateChm_Collection|StateChm]]
 +
|
 +
*all simulations
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.0.0'''</span>
 +
 +
|-valign="top"
 +
|<tt>GEOSChem.StateMet.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 +
|[[History_collections_for_met_fields_and_related_quantities#The_StateMet_collection|StateMet]]
 +
|
 +
*all simulations
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.0.0'''</span>
 +
 +
|-valign="top"
 +
|<tt>GEOSChem.Transport.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 +
|[[History_collections_for_advection_and_mixing#The_Transport_collection|Transport]]
 +
|
 +
*Typically used for fullchem_benchmark
 +
*Moved to StateMet in 13.0.0
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.2.0'''</span>
 +
*<span style="color:red">'''Removed in 13.0.0'''</span>
 +
 +
|-valign="top"
 +
|<tt>GEOSChem.WetLossConv.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 +
|[[History_collections_for_convection_and_wet_deposition#The_WetLossConv_collection|WetLossConv]]
 +
|
 +
*simulations w/ wetdep species
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.0.0'''</span>
 +
 +
|-valign="top"
 +
|<tt>GEOSChem.WetLossLS.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 +
|[[History_collections_for_convection_and_wet_deposition#The_WetLossLS_collection|WetLossLS]]
 +
|
 +
*simulations w/ wetdep species
 +
|
 +
*<span style="color:darkgreen">'''Added in 12.0.0'''</span>
 +
 +
|}
 +
 +
== HEMCO diagnostic ouptut ==
 +
 +
The HEMCO diagnostic output files will be created in the <tt>OutputDir/</tt> folder in your GEOS-Chem run directory.  For more information, please see our ''[[The HEMCO User's Guide#Diagnostics|The HEMCO User's Guide: Diagnostics]]''.
 +
 +
In the table below, <tt>YYYYMMDD</tt> and <tt>hhmms</tt> corresponds to the simulation date and time at which the file was created. 
 +
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top" bgcolor="#CCCCCC"
 +
!width="400px"|HEMCO diagnostic file name
 +
!width="100px"|Format
 +
!width="400px"|Collections
 +
!width="150px"|Created by
 +
 +
|-valign="top"
 +
|<tt>HEMCO_diagnostics.YYYYMMDDhhmm.nc</tt>
 +
|netCDF
 +
|Diagnostic quantities requested in [[The_HEMCO_Diagn.rc_file|<tt>HEMCO_Diagn.rc</tt>]]
 
|
 
|
 
*All simulations
 
*All simulations
 +
 +
|}
 +
 +
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 16:07, 13 December 2019 (UTC)
 +
 +
== Planeflight diagnostic output ==
 +
 +
By default, the planefight diagnostic output files will be created in your top-level run directory.  You can change this setting by modifying the output file name setting in [[The_input.geos_file#Planeflight_diagnostic|the Planeflight Menu of <tt>input.geos</tt>]].  For more information, please see our ''[[Planeflight diagnostic]]'' page.
 +
 +
In the table below, <tt>YYYYMMDD</tt> corresponds to the simulation date and time at which the file was created. 
 +
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top" bgcolor="#CCCCCC"
 +
!width="400px"|Planeflight diagnostic file name
 +
!width="100px"|Format
 +
!width="400px"|Collections
 +
!width="150px"|Created by
 +
 +
|-valign="top"
 +
|<tt>plane.log.YYYYMMDD</tt>
 +
|text
 +
|Point diagnostics requested in [[Planeflight_diagnostic#Planeflight.dat_file|<tt>Planeflight.dat</tt>]]
 
|
 
|
*Added in [[GEOS-Chem 12#12.1.0|12.1.0]]
+
*All simulations
  
 +
|}
 +
 +
== ObsPack diagnostic output ==
 +
 +
By default, the ObsPack output files will be created in your top-level run directory.  You can change this setting by modifying the output file name setting in [[The_input.geos_file#ObsPack diagnostic|the ObsPack Menu of <tt>input.geos</tt>]].  For more information, please see our ''[[ObsPack diagnostic]]'' page.
 +
 +
In the table below, <tt>YYYYMMDD</tt> and <tt>hhmms</tt> corresponds to the simulation date and time at which the file was created.  The <tt>z</tt> indicates UTC (sometimes called "Zulu" time).
 +
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top" bgcolor="#CCCCCC"
 +
!width="400px"|Obspack diagnostic file name
 +
!width="100px"|Format
 +
!width="400px"|Collections
 +
!width="150px"|Created by
 +
 +
|-valign="top"
 +
|<tt>GEOSChem.ObsPack.YYYYMMDD_hhmmz.nc4</tt>
 +
|netCDF
 +
|Point diagnostics at locations specified in an ObsPack format netCDF file
 +
|
 +
*All simulations
  
 
|}
 
|}
  
 +
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 16:41, 13 December 2019 (UTC)
  
 +
== Satellite timeseries diagnostic output in bpch format ==
 +
 +
<span style="color:red">'''''NOTE: To use the satellite timeseries diagnostics, you must compile GEOS-Chem with the BPCH_DIAG=y option.'''''</span>
 +
 +
By default, the satellite timeseries files will be created in your top-level run directory.  You can change by modifying the output file name setting in [[List_of_diagnostics_archived_to_bpch_format#ND51_and_ND51b:_Satellite_timeseries|the ND51 MENU and/or ND51b MENU of <tt>input.geos</tt>]].
 +
 +
In the table below, <tt>YYYYMMDD</tt> and <tt>hhmms</tt> corresponds to the simulation date and time at which the file was created.
 +
 +
{| border=1 cellspacing=0 cellpadding=5
 +
|-valign="top" bgcolor="#CCCCCC"
 +
!width="400px"|Timeseries file name
 +
!width="100px"|Format
 +
!width="400px"|Collections
 +
!width="150px"|Created by
 +
 +
|-valign="top"
 +
|<tt>ts_satellite.YYYYMMDDhh.bpch</tt>
 +
|bpch
 +
|Diagnostics requested in the [[List_of_diagnostics_archived_to_bpch_format#ND51_and_ND51b:_Satellite_timeseries|ND51 MENU and/or ND51b MENU of <tt>input.geos</tt>]].
 +
|
 +
*All simulations
 +
 +
|}
  
<tt>GEOSChem.Budget.YYYYMMDD_hhmmz.nc4</tt>
 
<tt>GEOSChem.CH4.YYYYMMDD_hhmmz.nc4</tt>
 
<tt>GEOSChem.CloudConvFlux.YYYYMMDD_hhmmz.nc4</tt>
 
<tt>GEOSChem.ConcAboveSfc.YYYYMMDD_hhmmz.nc4</tt>
 
<tt>GEOSChem.ConcAfterChem.YYYYMMDD_hhmmz.nc4</tt>
 
<tt>GEOSChem.DryDep.YYYYMMDD_hhmmz.nc4</tt>
 
<tt>GEOSChem.Jvalues.YYYYMMDD_hhmmz.nc4</tt>
 
<tt>GEOSChem.KppDiags.YYYYMMDD_hhmmz.nc4</tt>
 
<tt>GEOSChem.LevelEdgeDiags.YYYYMMDD_hhmmz.nc4</tt>
 
<tt>GEOSChem.MercuryChem.YYYYMMDD_hhmmz.nc4</tt>
 
<tt>GEOSChem.MercuryEmis..YYYYMMDD_hhmmz.nc4</tt>
 
<tt>GEOSChem.MercuryOcean.YYYYMMDD_hhmmz.nc4</tt>
 
<tt>GEOSChem.POPs.YYYYMMDD_hhmmz.nc4</tt>
 
<tt>GEOSChem.ProdLoss.YYYYMMDD_hhmmz.nc4</tt>
 
<tt>GEOSChem.RadioNuclide.YYYYMMDD_hhmmz.nc4</tt>
 
<tt>GEOSChem.SpeciesConc.YYYYMMDD_hhmmz.nc4</tt>
 
<tt>GEOSChem.StateChm.YYYYMMDD_hhmmz.nc4</tt>
 
<tt>GEOSChem.StateMet.YYYYMMDD_hhmmz.nc4</tt>
 
<tt>GEOSChem.Transport.YYYYMMDD_hhmmz.nc4</tt>
 
<tt>GEOSChem.WetLossConv.YYYYMMDD_hhmmz.nc4</tt>
 
<tt>GEOSChem.WetLossLS.YYYYMMDD_hhmmz.nc4</tt>
 
  
 
----
 
----
'''''[[GEOS-Chem restart files|Previous]] | [[Guide_to_visualization_and_analysis_tools_for_GEOS-Chem|Next]] | [[Getting Started with GEOS-Chem]]'''''
+
'''''[[GEOS-Chem restart files|Previous]] | [[Python tools for use with GEOS-Chem|Next]] | [[Getting Started with GEOS-Chem]]'''''

Latest revision as of 15:27, 4 August 2022

Previous | Next | Getting Started with GEOS-Chem

  1. Minimum system requirements (and software installation)
  2. Configuring your computational environment
  3. Downloading source code
  4. Downloading data directories
  5. Creating run directories
  6. Configuring runs
  7. Compiling
  8. Running
  9. Output files
  10. Python tools for use with GEOS-Chem
  11. Coding and debugging
  12. Further reading


On this page, we list the files that are generated by GEOS-Chem's various diagnostic packages.

History diagnostics output

The following files, which correspond to the default History diagnostic collections, will be created in the OutputDir/ folder in your GEOS-Chem run directory. You can prevent any of these files from being created by commenting out the collection name in the HISTORY.rc configuration file. You can also add your own new collections (i.e. requesting species concentrations for both time-averaged and instantaneous averaging modes) by updating HISTORY.rc. For more information, please see our Guide to GEOS-Chem History diagnostics.

In the table below, YYYYMMDD and hhmms corresponds to the simulation date and time at which the file was created. The z indicates UTC (sometimes called "Zulu" time).

History diagnostic file name Format Collection For simulation(s) Added/Removed
GEOSChem.AdvFluxVert.YYYYMMDD_hhmmz.nc4 netCDF AdvFluxVert
  • fullchem_benchmark
  • Added in 12.6.0
GEOSChem.AerosolMass.YYYYMMDD_hhmmz.nc4 netCDF AerosolMass
  • fullchem
  • aerosol
  • Added in 12.0.0
GEOSChem.Aerosols.YYYYMMDD_hhmmz.nc4 netCDF Aerosols
  • fullchem
  • aerosol
  • Added in 12.0.0
GEOSChem.BoundaryConditions.YYYYMMDD_hhmmz.nc4 netCDF BoundaryConditions
  • can be created by: all simulations
  • can be read by: nested-grid simulations
  • Added in 12.4.0
GEOSChem.Budget.YYYYMMDD_hhmmz.nc4 netCDF Budget
  • all simulations
  • Added in 12.1.0
GEOSChem.CH4.YYYYMMDD_hhmmz.nc4 netCDF CH4
  • CH4
  • tagCH4
  • Added in 12.1.0
GEOSChem.CloudConvFlux.YYYYMMDD_hhmmz.nc4 netCDF CloudConvFlux
  • all simulations
  • Added in 12.0.0
GEOSChem.ConcAboveSfc.YYYYMMDD_hhmmz.nc4 netCDF ConcAboveSfc
  • fullchem
  • Added in 12.6.0
GEOSChem.ConcAfterChem.YYYYMMDD_hhmmz.nc4 netCDF ConcAfterChem
  • fullchem
  • CH4
  • tagCH4
  • Added in 12.0.0
GEOSChem.DryDep.YYYYMMDD_hhmmz.nc4 netCDF DryDep
  • simulations w/ drydep species
  • Added in 12.0.0
GEOSChem.Jvalues.YYYYMMDD_hhmmz.nc4 netCDF JValues
  • fullchem
  • Added in 12.0.0
GEOSChem.KppDiags.YYYYMMDD_hhmmz.nc4 netCDF KppDiags
  • fullchem
  • Added in 12.7.0
GEOSChem.LevelEdgeDiags.YYYYMMDD_hhmmz.nc4 netCDF LevelEdgeDiags
  • all simulations
  • Added in 12.0.0
GEOSChem.MercuryChem.YYYYMMDD_hhmmz.nc4 netCDF MercuryChem
  • Hg
  • tagHg
  • Added in 12.0.0
GEOSChem.MercuryEmis.YYYYMMDD_hhmmz.nc4 netCDF MercuryEmis
  • Hg
  • tagHg
  • Added in 12.0.0
GEOSChem.MercuryOcean.YYYYMMDD_hhmmz.nc4 netCDF MercuryOcean
  • Hg
  • tagHg
  • Added in 12.0.0
GEOSChem.POPs.YYYYMMDD_hhmmz.nc4 netCDF POPs
  • Hg
  • tagHg
  • Added in 12.0.0
GEOSChem.Metrics.YYYYMMDD_hhmmz.nc4 netCDF Metrics
  • fullchem
  • CH4
  • tagCH4
  • Added in 13.0.0
GEOSChem.ProdLoss.YYYYMMDD_hhmmz.nc4 netCDF ProdLoss
  • fullchem
  • aerosol
  • tagCO
  • tagO3
  • Added in 12.0.0
GEOSChem.RadioNuclide.YYYYMMDD_hhmmz.nc4 netCDF RadioNuclide
  • TransportTracers
  • Added in 12.0.0
GEOSChem.SpeciesConc.YYYYMMDD_hhmmz.nc4 netCDF SpeciesConc
  • all simulations
  • Added in 12.0.0
GEOSChem.StateChm.YYYYMMDD_hhmmz.nc4 netCDF StateChm
  • all simulations
  • Added in 12.0.0
GEOSChem.StateMet.YYYYMMDD_hhmmz.nc4 netCDF StateMet
  • all simulations
  • Added in 12.0.0
GEOSChem.Transport.YYYYMMDD_hhmmz.nc4 netCDF Transport
  • Typically used for fullchem_benchmark
  • Moved to StateMet in 13.0.0
  • Added in 12.2.0
  • Removed in 13.0.0
GEOSChem.WetLossConv.YYYYMMDD_hhmmz.nc4 netCDF WetLossConv
  • simulations w/ wetdep species
  • Added in 12.0.0
GEOSChem.WetLossLS.YYYYMMDD_hhmmz.nc4 netCDF WetLossLS
  • simulations w/ wetdep species
  • Added in 12.0.0

HEMCO diagnostic ouptut

The HEMCO diagnostic output files will be created in the OutputDir/ folder in your GEOS-Chem run directory. For more information, please see our The HEMCO User's Guide: Diagnostics.

In the table below, YYYYMMDD and hhmms corresponds to the simulation date and time at which the file was created.

HEMCO diagnostic file name Format Collections Created by
HEMCO_diagnostics.YYYYMMDDhhmm.nc netCDF Diagnostic quantities requested in HEMCO_Diagn.rc
  • All simulations

--Bob Yantosca (talk) 16:07, 13 December 2019 (UTC)

Planeflight diagnostic output

By default, the planefight diagnostic output files will be created in your top-level run directory. You can change this setting by modifying the output file name setting in the Planeflight Menu of input.geos. For more information, please see our Planeflight diagnostic page.

In the table below, YYYYMMDD corresponds to the simulation date and time at which the file was created.

Planeflight diagnostic file name Format Collections Created by
plane.log.YYYYMMDD text Point diagnostics requested in Planeflight.dat
  • All simulations

ObsPack diagnostic output

By default, the ObsPack output files will be created in your top-level run directory. You can change this setting by modifying the output file name setting in the ObsPack Menu of input.geos. For more information, please see our ObsPack diagnostic page.

In the table below, YYYYMMDD and hhmms corresponds to the simulation date and time at which the file was created. The z indicates UTC (sometimes called "Zulu" time).

Obspack diagnostic file name Format Collections Created by
GEOSChem.ObsPack.YYYYMMDD_hhmmz.nc4 netCDF Point diagnostics at locations specified in an ObsPack format netCDF file
  • All simulations

--Bob Yantosca (talk) 16:41, 13 December 2019 (UTC)

Satellite timeseries diagnostic output in bpch format

NOTE: To use the satellite timeseries diagnostics, you must compile GEOS-Chem with the BPCH_DIAG=y option.

By default, the satellite timeseries files will be created in your top-level run directory. You can change by modifying the output file name setting in the ND51 MENU and/or ND51b MENU of input.geos.

In the table below, YYYYMMDD and hhmms corresponds to the simulation date and time at which the file was created.

Timeseries file name Format Collections Created by
ts_satellite.YYYYMMDDhh.bpch bpch Diagnostics requested in the ND51 MENU and/or ND51b MENU of input.geos.
  • All simulations



Previous | Next | Getting Started with GEOS-Chem