GEOS-5 Documentation for Heracles 5.3: Difference between revisions

 
Running Heracles 5.3: Add link to Extdata page
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
__FORCETOC__
__FORCETOC__
This page lists pages with information on setting up and running GEOS-5 Heracles 5.2.  Earlier and later versions of GEOS-5 may differ in details that, while minor, will require different steps for building and running, so ''caveat utilitor''.  
This page lists pages with information on setting up and running GEOS-5 Heracles 5.3.  Earlier and later versions of GEOS-5 may differ in details that, while minor, will require different steps for building and running, so ''caveat utilitor''.  


'''Back to [[GEOS-5 User's and Developer's Guides]]'''
'''Back to [[GEOS-5 User's and Developer's Guides]]'''
Line 9: Line 9:


<pre>
<pre>
==========================================================================
30Jun2016, Takacs,    CVS Tag: Heracles-5_3 (pushed,    zero diff)
29Jun2016, Takacs,    CVS Tag: Heracles-5_3 (pushed, non-zero diff)
27Jun2016, Takacs,    CVS Tag: Heracles-5_3 (pushed,    zero diff)
24Jun2016, Takacs,    CVS Tag: Heracles-5_3 (        non-zero diff to Heracles-5_2_p1)
                      Module: GEOSagcm
------------------------------------------------------------------------------
1) Updates to Aerosols (following: AeroChem-Heracles-5_2-b9), including tag: b_AMM_H521MOPS_move2d
  for single moment diagnostic partition of precip, and tag: AMM_H53U_moistforFP for updated 2-Moment
2) Updates to GMI, StratChem, and Tr_GridComp (zero-diff for default case)
3) Updates to QUICKSTAT
4) Pushed on 27Jun2016 to correct CLOUDNEW diagnostic and to add MAPL_SKIP to TR_GridComp IMPORT SPEC (Zero-Diff)
5) Pushed on 29Jun2016 to correct REGRESSION for GOCART OPS Sulfates (Non-Zero Diff, minor error)
6) Pushed on 29Jun2016 to correct error in Chem_RegistryMod.F90 in accounting GOCART components
  Note:  Binary GOCART Restarts will be incorrect if using original Heracles-5_3 tag (prior to 29Jun2016)
7) Pushed on 30Jun2016 to update  Chem_BundleMod.F90 (Zero-Diff, new optional arguments)
Restart Changes: yes
        Additional Internals to: gocart_internal_rst (Bootstrappable)
        Additional Imports  to: tr_import_rst      (Bootstrappable)
==========================================================================
08Jun2016, Takacs,    CVS Tag: Heracles-5_2_p1 (non-zero diff to Heracles-5_2)
                      Module: GEOSagcm
------------------------------------------------------------------------------
1) Updates to ADD_INCS, PHYSICS, and AGCM GridComp to perform proper mass-weighted Temperature tendencies.
2) Added option for mass-weighting Analysis Temperature Tendencies (ANA_IS_WEIGHTED, DEFAULT=NO)
3) Updates to QUICKPLOT
Restart Changes: none
==========================================================================
==========================================================================
25May2016, Takacs,    CVS Tag: Heracles-5_2 (AKA: Heracles-5_2_BETA_1MOPS, non-zero diff to Heracles-5_1)
25May2016, Takacs,    CVS Tag: Heracles-5_2 (AKA: Heracles-5_2_BETA_1MOPS, non-zero diff to Heracles-5_1)
Line 75: Line 109:
Restart Changes: none
Restart Changes: none


</pre>


==========================================================================
== Running Heracles 5.3 ==
21Sep2015, Takacs,    CVS Tag: Heracles-4_3 (zero-diff to Heracles-4_2)
                      Module: GEOSagcm
------------------------------------------------------------------------------
1) Implemented new saltwater merge with CICE  (zero-diff if disabled)
2) Updates to 2nd-moment microphysics, tag: b_HR42_091015_2M
3) Updates Surface/Shared/Raster from Sarith for latest BC development
 
Restart Changes: none
 
 
==========================================================================
14Aug2015, Takacs,    CVS Tag: Heracles-4_2 (zero-diff to Heracles-4_1)
                      Module: GEOSagcm
------------------------------------------------------------------------------
1) Added AGCM.rc parameter:  MAPL_ENABLE_BOOTSTRAP
 
  The Default valus is "NO", which means that ALL restart files must exist and
  the must contain ALL variables used by the model.
 
  By setting MAPL_ENABLE_BOOTSTRAP: YES
  the model will bootstrap all missing variables from the restarts which
  are classified as OPTIONAL.  This works for both binary and nc4 files.
  Currently, all variables within the model restarts are OPTIONAL (by default)
  except for:
 
    1) ALL variables within fvcore_internal_rst (except DZ and W)
    2) Q-Vapor      within  moist_internal_rst
    3) All variables within  catch_internal_rst
 
  You can still bootstrap individual restarts by placing the "+" or "-"
  as before, together with MAPL_ENABLE_BOOTSTRAP: NO
  However, there is no mechanism to bootstrap REQUIRED variables.
  Only variables that are classified as OPTIONAL are bootstrappable.
 
Restart Changes: none
          Note: +/- notation no longer needed
 
 
==========================================================================
04Aug2015, Takacs,    CVS Tag: Heracles-4_1 (non-zero-diff to Heracles-4_0)
                      Module: GEOSagcm
------------------------------------------------------------------------------
1) Modified GOCART to use ExtData for IMPORTS
2) Updates to QUICKPLOT
3) Fixed LandIce ALBEDO diagnostic (zero-diff)
4) Added GCMICHEM and STRATCHEM setups and HISTORY
5) Added rs_numtiles(.F90, .x) to check ocean tiles for consistency with BCs


Restart Changes: none
* [[Heracles 5.3 Quick Start]]: This page describes the minimum steps required to build and run GEOS-5 Heracles 5.3 on NCCS discover and NAS pleiades.  You should successfully complete the steps in these instructions before doing anything more complicated.
          Note: Converts to NC4 Restarts automatically


</pre>
* [[Heracles 5.3 User's Guide]]


== Running Heracles 5.2 ==
* [[Using the ExtData component]]
 
* [[Heracles 5.2 Quick Start]]: This page describes the minimum steps required to build and run GEOS-5 Heracles 5.2 on NCCS discover and NAS pleiades.  You should successfully complete the steps in these instructions before doing anything more complicated.
 
* [[Heracles 5.2 User's Guide]]


* [[Running a Suite of Forecasts]]
* [[Running a Suite of Forecasts]]
Line 144: Line 127:
* [[Heracles Single Column Model]]
* [[Heracles Single Column Model]]


== Heracles 5.2 Documentation ==
== Heracles 5.3 Documentation ==


* [[Media:GEOS5_doc.pdf|GEOS 5 Developer's Guide]] (pdf)
* [[Media:GEOS5_doc.pdf|GEOS 5 Developer's Guide]] (pdf)
<!--
* [[Heracles 5.2 Boundary Conditions]]
-->
* List of Export/Import/Internal states, generated with <code>src/GMAO_Shared/MAPL_Base/mapl_vlist.py</code>
* List of Export/Import/Internal states, generated with <code>src/GMAO_Shared/MAPL_Base/mapl_vlist.py</code>
** [[Heracles 5.2 states sorted by short name | Sorted by short name]]
** [[Heracles 5.3 states sorted by short name | Sorted by short name]]
** [[Heracles 5.2 states sorted by component name | Sorted by component name]]
** [[Heracles 5.3 states sorted by component name | Sorted by component name]]
<!--
<!--
* [[Heracles 5.2 Single Column Model]]
Created by:
* [[Regridding Restarts for Ganymed 1.0]]: Explains how to create restart (initial condition) files for Ganymed 1.0 starting from those of other versions, or to convert them from different resolutions.
$ ./GMAO_Shared/MAPL_Base/mapl_vlist.py --sort comp --format wiki /home/mathomp4/Models/Heracles-5_3/GEOSagcm/src/GEOSgcs_GridComp/ > states_sort_by_comp.txt
 
$ ./GMAO_Shared/MAPL_Base/mapl_vlist.py --sort short --format wiki /home/mathomp4/Models/Heracles-5_3/GEOSagcm/src/GEOSgcs_GridComp/ > states_sort_by_short.txt
-->
-->


Line 162: Line 144:
* [[GEOS-5 Run-Time Characteristics]]
* [[GEOS-5 Run-Time Characteristics]]


* Hierarchical structure: Below is a (partially folded) view of the Heracles 5.2 hierarchy where each node is a GridComp. Some of the nodes are folded (marked with a circle at the end) for clarity - clicking the composite node reveals the sub-nodes.
* Hierarchical structure: Below is a (partially folded) view of the Heracles 5.3 hierarchy where each node is a GridComp. Some of the nodes are folded (marked with a circle at the end) for clarity - clicking the composite node reveals the sub-nodes.


<!--
<!--
To create these files, I made a stock checkout of Heracles, went to
To create these files, I made a stock checkout of Heracles, went to
GEOSgms (or agcm or ogcm) and ran:
GEOSgcs (or agcm or ogcm) and ran:


   $ tree -d -I CVS -X | sed -f ~/MindMapFiles/mindmap.sedfile > ~/MindMapFiles/h51_tree.mm
   $ tree -d -I CVS -X | sed -f ~/MindMapFiles/mindmap.sedfile > ~/MindMapFiles/h53_tree.mm


You'll then need to manually go into the XML file and change the top
You'll then need to manually go into the XML file and change the top
Line 174: Line 156:
-->
-->


<mm>[[h52_tree.mm|flash|500px|parameters startCollapsedToLevel=4]]</mm>
<mm>[[h53_tree.mm|flash|500px|parameters startCollapsedToLevel=4]]</mm>


----  
----  
'''Back to [[GEOS-5 User's and Developer's Guides]]'''
'''Back to [[GEOS-5 User's and Developer's Guides]]'''