Difference between revisions of "GEOS-Chem restart files"

From Geos-chem
Jump to: navigation, search
(Viewing and manipulating restart files)
 
(31 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This page contains information about files produced by GEOS-Chem simulations, including diagnostic data and restart files used for initial conditions.  For information the input files that ship with the GEOS-Chem run directories, please see our [[GEOS-Chem Input Files|''GEOS-Chem Input Files'' wiki page]].
+
__FORCETOC__
 +
'''''[[GEOS-Chem log files|Previous]] | [[GEOS-Chem diagnostic output files|Next]] | [[Getting Started with GEOS-Chem]]'''''
 +
#[[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 data directories|Downloading data directories]]
 +
#[[Creating GEOS-Chem run directories|Creating run directories]]
 +
#[[GEOS-Chem configuration files|Configuring runs]]
 +
#[[Compiling GEOS-Chem|Compiling]]
 +
#[[Running GEOS-Chem|Running]]
 +
#[[GEOS-Chem output files|Output files]]
 +
#*[[GEOS-Chem log files|Log files]]
 +
#*<span style="color:blue">'''Restart files'''</span>
 +
#*[[GEOS-Chem diagnostic output files|Diagnostic output files]]
 +
#[[Python tools for use with GEOS-Chem]]
 +
#[[GEOS-Chem_coding_and_debugging|Coding and debugging]]
 +
#[[GEOS-Chem_overview#Further_reading|Further reading]]
  
== Restart files in GEOS-Chem 12 ==
 
  
<span style="color:green">'''''These updates were included in [[GEOS-Chem 12#12.1.0|GEOS-Chem 12.1.0]], which was released on 26 Nov 2018.'''''</span>
+
This content has been migrated to the [https://geos-chem.readthedocs.io/en/latest/gcc-guide/04-data/restart-files.html '''Restart files''' chapter of <tt>geos-chem.readthedocs.io</tt>].
  
In [[GEOS-Chem 12#12.1.0|GEOS-Chem 12.1.0]], several restart file updates were introduced. These include:
 
  
=== Restart collection in HISTORY.rc ===
+
-----
 
+
'''''[[GEOS-Chem log files|Previous]] | [[GEOS-Chem diagnostic output files|Next]] | [[Getting Started with GEOS-Chem]]'''''
GEOS-Chem restart files are now saved out via the History component. A new [[List_of_diagnostics_archived_to_netCDF_format#The_Restart_collection|Restart collection]] has been defined in <tt>HISTORY.rc</tt> and fields saved out to the restart file can be modified in that file.
+
 
+
=== New restart file names ===
+
 
+
Because we are now [[#Restart collection in HISTORY.rc|using the History component to archive restart files]] in GEOS-Chem 12.1.0 and later versions, GEOS-Chem restart file names now use this nomenclature: <tt>GEOSChem.Restart.YYYYMMDD_hhmmz.nc4</tt>.
+
 
+
For example, the restart file that was created at 00:00 UTC on August 1, 2016 is named: <tt>GEOSChem.Restart.20160801_0000z.nc4</tt>.  The <tt>z</tt> indicates "Zulu" or "Z" time, which is another name for UTC.
+
 
+
=== New variable names ===
+
 
+
Prior to [[GEOS-Chem 12#12.1.0|GEOS-Chem 12.1.0]], species names in restart files began with the <tt>SPC_</tt> prefix:
+
 
+
  SPC_NO          # Initial concentration of NO
+
  SPC_O3          # Initial concentration of O3
+
  SPC_CO          # Initial concentration of CO
+
  SPC_CH4          # Initial concentration of CH4
+
  ...etc...
+
 
+
In [[GEOS-Chem 12#12.1.0|GEOS-Chem 12.1.0]] and later versions, the species names now begin with the prefix <tt>SpeciesRst_</tt> prefix:
+
 
+
  SpeciesRst_NO    # Initial concentration of NO
+
  SpeciesRst_O3    # Initial concentration of O3
+
  SpeciesRst_CO    # Initial concentration of CO
+
  SpeciesRst_CH4  # Initial concentration of CH4
+
  ...etc...
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 15:16, 30 November 2018 (UTC)
+
 
+
=== New fields added to the GEOS-Chem restart file ===
+
 
+
Several new fields have been added to the GEOS-Chem restart file in an attempt to remove differences between single and multi-segmented GEOS-Chem simulations.
+
 
+
{| border=1 cellpadding=5 cellspacing=0
+
 
+
|-valign="top"
+
!width="50px"  bgcolor="#CCCCCC"|Item
+
!width="950px" bgcolor="#CCCCCC"|Description
+
 
+
|-valign="top"
+
|1
+
|Module-level variables <tt>H2O2s</tt> and <tt>SO2s</tt> from <tt>wetscav_mod.F</tt> have been added to State_Chm (as <tt>State_Chm%H2O2AfterChem, StateChm%SO2AfterChem</tt>). These fields will be output to the GEOS-Chem restart file and then initialized to the values saved in the restart file at the start of the next simulation. Prior to this update, both H2O2s and SO2s were initialized to the H2O2 and SO2 tracer concentrations at the start of every simulation. '''''This change will impact multi-segmented runs only'''''.
+
 
+
|-valign="top"
+
|2
+
|Module-level variables <tt>DRY_TOTN</tt> and <tt>WET_TOTN</tt> from <tt>get_ndep_mod.F</tt> have been added to State_Chm (as <tt>State_Chm%DryDepNitrogen, StateChm%WetDepNitrogen</tt>). These fields will be output to the GEOS-Chem restart file and then initialized to the values saved in the restart file at the start of the next simulation. Prior to this update, both variables were initialized to zero at the start of every simulation. Storing them in the restart file may improve accuracy of soil NOx emissions over multi-segmented runs. '''''This change will impact multi-segmented runs only'''''.
+
 
+
|-valign="top"
+
|3
+
|Move <tt>State_PSC</tt> from the HEMCO restart file to the GEOS-Chem restart file.
+
 
+
|-valign="top"
+
|4
+
|Save out instantaneous met fields <tt>TMPU1, SPHU1, PS1DRY, PS1WET, DELPDRY</tt> to the GEOS-Chem restart file. These will be used to initialize the met fields at the start of the timestep, otherwise they will be set to the values of those fields at the end of the timestep.
+
 
+
|}
+
 
+
While this update was added to GEOS-Chem Classic in [[GEOS-Chem_12#12.1.0|12.1.0]], it will be added to GCHP in 12.2.0.
+
 
+
=== Read restart file via HEMCO ===
+
 
+
GEOS-Chem restart files are now read in via HEMCO. The entries listed below have been added to <tt>HEMCO_Config.rc</tt> (and may vary slightly for different simulation types). These fields are obtained from HEMCO and copied to the appropriate <tt>State_Chm</tt> and <tt>State_Met</tt> fields in the new routine <tt>Get_GC_Restart</tt> (found in <tt>GeosCore/hcoi_gc_main_mod.F90</tt>).
+
 
+
  #==============================================================================
+
  # --- GEOS-Chem restart file ---
+
  #
+
  # PSC state only needed for UCX
+
  #==============================================================================
+
  (((GC_RESTART
+
  * SPC_          ./GEOSChem.Restart.$YYYY$MM$DD_$HH$MNz.nc4 SpeciesRst_?ALL?    $YYYY/$MM/$DD/$HH CS xyz 1 * - 1 1
+
  * TMPU1          ./GEOSChem.Restart.$YYYY$MM$DD_$HH$MNz.nc4 Met_TMPU1          $YYYY/$MM/$DD/$HH E  xyz 1 * - 1 1
+
  * SPHU1          ./GEOSChem.Restart.$YYYY$MM$DD_$HH$MNz.nc4 Met_SPHU1          $YYYY/$MM/$DD/$HH E  xyz 1 * - 1 1
+
  * PS1DRY        ./GEOSChem.Restart.$YYYY$MM$DD_$HH$MNz.nc4 Met_PS1DRY          $YYYY/$MM/$DD/$HH E  xy  1 * - 1 1
+
  * PS1WET        ./GEOSChem.Restart.$YYYY$MM$DD_$HH$MNz.nc4 Met_PS1WET          $YYYY/$MM/$DD/$HH E  xy  1 * - 1 1
+
  * DELPDRY        ./GEOSChem.Restart.$YYYY$MM$DD_$HH$MNz.nc4 Met_DELPDRY        $YYYY/$MM/$DD/$HH E  xyz 1 * - 1 1
+
  * KPP_HVALUE    ./GEOSChem.Restart.$YYYY$MM$DD_$HH$MNz.nc4 Chem_KPPHvalue      $YYYY/$MM/$DD/$HH E  xyz 1 * - 1 1
+
  * WETDEP_N      ./GEOSChem.Restart.$YYYY$MM$DD_$HH$MNz.nc4 Chem_WetDepNitrogen $YYYY/$MM/$DD/$HH E  xy  1 * - 1 1
+
  * DRYDEP_N      ./GEOSChem.Restart.$YYYY$MM$DD_$HH$MNz.nc4 Chem_DryDepNitrogen $YYYY/$MM/$DD/$HH E  xy  1 * - 1 1
+
  * SO2_AFTERCHEM  ./GEOSChem.Restart.$YYYY$MM$DD_$HH$MNz.nc4 Chem_SO2AfterChem  $YYYY/$MM/$DD/$HH E  xyz 1 * - 1 1
+
  * H2O2_AFTERCHEM ./GEOSChem.Restart.$YYYY$MM$DD_$HH$MNz.nc4 Chem_H2O2AfterChem  $YYYY/$MM/$DD/$HH E  xyz 1 * - 1 1
+
  (((+STATE_PSC+
+
  * STATE_PSC      ./GEOSChem.Restart.$YYYY$MM$DD_$HH$MNz.nc4 Chem_StatePSC      $YYYY/$MM/$DD/$HH E  xyz count      * - 1 1
+
  )))+STATE_PSC+
+
  )))GC_RESTART
+
 
+
The <tt>CS</tt> cycle flag was added as an option to HEMCO in [[GEOS-Chem 12#12.1.0|GEOS-Chem 12.1.0]] to tell HEMCO to skip fields that aren't found in the provided file. This is useful when certain species aren't found in the restart file and, in that case, GEOS-Chem will initialize that species to the background concentrations specified in the species database.
+
 
+
--[[User:Melissa Payer|Melissa Sulprizio]] ([[User talk:Melissa Payer|talk]]) 16:30, 7 November 2018 (UTC)
+
 
+
== Viewing and manipulating restart files ==
+
 
+
For information on viewing and manipulating GEOS-Chem restart files in netCDF format, please see the following sections of [[Working with netCDF data files|our ''Working with netCDF data files'' wiki page]]:
+
 
+
# [[Working_with_netCDF_data_files#Viewing and manipulating netCDF files|Resources for viewing and manipulating netCDF files]]
+
# [[Working_with_netCDF_data_files#Regridding_netCDF_files|Regridding netCDF files]]
+
# [[Working_with_netCDF_data_files#Adding_a_new_variable_to_a_netCDF_file|Adding a new species to a restart file]]
+
# [[Working_with_netCDF_data_files#Cropping_netCDF_files|Cropping restart files to a subset of the globe]]
+
# [[Working_with_netCDF_data_files#Chunking_and_deflating_a_netCDF_file_to_improve_I.2FO|Chunking and deflating restart files]]
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 15:19, 30 November 2018 (UTC)
+
 
+
== Previous issues that are now resolved ==
+
 
+
=== Enable compression in netCDF-4 output files ===
+
 
+
<span style="color:green">'''''This update was included in [[GEOS-Chem v11-02#v11-02a|v11-02a]] (approved 12 May 2017).'''''</span>
+
 
+
For more information about this issue, please see [[The_NcdfUtilities_package#Enable_compression_in_netCDF-4_output_files|this post on our ''The NcdfUtilities package'' wiki page]].
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 17:50, 24 May 2018 (UTC)
+
 
+
=== Improve write speed of netCDF output files ===
+
 
+
<span style="color:green">'''''This update was included in [[GEOS-Chem v11-01#v11-01 public release|GEOS-Chem v11-01 public release]]'''''</span>
+
 
+
For more information about this issue, please see [[The_NcdfUtilities_package#Improve_write_speed_of_netCDF_output_files|this post on our ''The NcdfUtilities package'' wiki page]].
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 19:05, 8 March 2017 (UTC)
+
 
+
=== GAMAP can now read GEOS-Chem restart files in netCDF format ===
+
 
+
<span style="color:green">'''''This update was included in [[GEOS-Chem v11-01#v11-01 public release|GEOS-Chem v11-01 public release]]'''''</span>
+
 
+
Starting in [[GEOS-Chem v11-01]], all restart files are now saved in [[Preparing_data_files_for_use_with_HEMCO#The_COARDS_netCDF_standard|COARDS-compliant netCDF format]].  We have had to make some minor modifications to both GEOS-Chem and GAMAP in order to allow GAMAP to read these files.  The table below gives a summary of these modifications.
+
 
+
{| border=1 cellspacing=0 cellpadding=5
+
|-valign="top" bgcolor="#CCCCCC"
+
!width="100px"|GEOS-Chem or GAMAP?
+
!width="250px"|File
+
!width="650px"|Modification
+
 
+
|-valign="top"
+
|GEOS-Chem
+
|<tt>GeosCore/gamap_mod.F</tt>
+
|In routine <tt>INIT_TRACERINFO</tt>, we now write metadata for all species (advected or not) to the tracerinfo.dat file under the ND45 tracer concentration diagnostic section.  Because the netCDF restart file contains concentrations for both advected and non-advected species, we need to make sure that the <tt>tracerinfo.dat</tt> file created by GEOS-Chem contains metadata for all species.
+
 
+
|-valign="top"
+
|GAMAP
+
|<tt>internals/ctm_open_file.pro</tt>
+
|The prior algorithm always assumed that a netCDF file would end in either <tt>.nc</tt> or <tt>.nc4</tt>.  We now have removed this restriction.  We now split the filename string on <tt>.</tt> and then examine the substrings for <tt>nc</tt> or <tt>nc4</tt> (case-insensitive).
+
 
+
|-valign="top"
+
|GAMAP
+
|<tt>internals/ctm_read_coards.pro</tt>
+
|Added some minor modifications to read netCDF restart files:
+
   
+
#Determine vertical grid from the number of layers (if the <tt>Model</tt> global attribute is not specified).
+
#Assign category <tt>DXYP</tt> to variable <tt>AREA</tt>, which is included in the netCDF restart file.
+
#Assign category <tt>IJ-AVG-$</tt> to variables beginning with either <tt>SPC_</tt> or <tt>TRC_</tt>.  Also remove the <tt>SPC_</tt> and <tt>TRC_</tt> from the variable name internally so that the variable name will match the metadata in <tt>tracerinfo.dat</tt>.
+
 
+
|}
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 19:29, 23 January 2017 (UTC)
+

Latest revision as of 15:26, 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


This content has been migrated to the Restart files chapter of geos-chem.readthedocs.io.



Previous | Next | Getting Started with GEOS-Chem