GEOS-5 Documentation for Heracles 5.3: Difference between revisions

From GEOS-5
Jump to navigation Jump to search
Change all 5.2 to 5.3
Running Heracles 5.3: Add link to Extdata page
 
(4 intermediate revisions by the same user not shown)
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 74: Line 108:


Restart Changes: none
Restart Changes: none
==========================================================================
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
          Note: Converts to NC4 Restarts automatically


</pre>
</pre>
Line 135: Line 116:


* [[Heracles 5.3 User's Guide]]
* [[Heracles 5.3 User's Guide]]
* [[Using the ExtData component]]


* [[Running a Suite of Forecasts]]
* [[Running a Suite of Forecasts]]
Line 147: Line 130:


* [[Media:GEOS5_doc.pdf|GEOS 5 Developer's Guide]] (pdf)
* [[Media:GEOS5_doc.pdf|GEOS 5 Developer's Guide]] (pdf)
<!--
* [[Heracles 5.3 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.3 states sorted by short name | Sorted by short name]]
** [[Heracles 5.3 states sorted by short name | Sorted by short name]]
** [[Heracles 5.3 states sorted by component name | Sorted by component name]]
** [[Heracles 5.3 states sorted by component name | Sorted by component name]]
<!--
<!--
* [[Heracles 5.3 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 166: Line 148:
<!--
<!--
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/h53_tree.mm
   $ tree -d -I CVS -X | sed -f ~/MindMapFiles/mindmap.sedfile > ~/MindMapFiles/h53_tree.mm

Latest revision as of 05:21, 23 August 2016

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


ChangeLog Entry

In src/Applications/GEOSgcm_App/ChangeLog:

==========================================================================
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)
                       Module: GEOSagcm
------------------------------------------------------------------------------
1) Updates to 2-Moment Microphysics
2) Revert back to Single-Moment Microphysics of e5131_fp (Ganymed-4_1),but with fixed bug in PRECIP3 argument list
3) Merge LAND with tag: SM-LDASsa_m3-16_0_p2_CatchCatchCN_for_MERRA3
4) Fix to CO2 Emission Files
5) Merge to incorporate Yury's Heracles-4_3_UNSTABLE-CICE_thermo (zero diff when running DataSeaIce)
6) Changed default for BKGAVE in Regular REPLAY to (2/3)xREPLAY_FREQUENCY (Nominally 4 hours)
7) Fixed averaging interval related to BKGAVE in Regular REPLAY (bug caused -3hr endpoint to be omitted in average)
8) Fixed bug in GWD Mid-Layer GeoPotential Height Calculation
9) Updates to QUICKPLOT
10) Updates to MAPL
11) Updates to GMI
12) Changed ROTATE from TRUE to FALSE for Dump_&_Splash WIND INCREMENTS in DyCorGridComp
13) Updates to fvcore_layout.rc (defaults to so-called "2b3b" case based on H52 Forecast Layout Experiments)
14) Updates to sw_core.F90 and tp_core.F90 associated with fvlayout "2b3b"
15) Changed Defaults to Regular REPLAY Grid Transforms within MKIAU Source Code to BiLinary Interpolaton:
            BKG2ANACNSRV: 0 ( Note: Conservative Transformation creates Non-Wavenumber 1 Winds at Poles )
            ANA2BKGCNSRV: 0 ( Note: Conservative Transformation creates Non-Wavenumber 1 Winds at Poles )
16) NOTE: Lat/Lon version of GEOSagcm no-longer regresses.  Last known version which regresses is Heracles-4_3
          Investigation still in progress to determine cause.

Restart Changes: none


==========================================================================
12Jan2016, Takacs,    CVS Tag: Heracles-5_1 (non-zero diff to Heracles-5_0)
                       Module: GEOSagcm
------------------------------------------------------------------------------
1) Updates to CO emissions
2) Updates to GMIchem_GridComp
3) Updates to TR_GridComp
4) Default to Use SST Cool Layer
5) Changed Defaults for SST and Regular REPLAY Grid Transform parameteres within AGCM.rc:
           INTERPOLATE_SST: 0 or 1 ( Defaults are now model decisions based on grid resolution comparisons )
              BKG2ANACNSRV: 0 or 1 ( Defaults are now model decisions based on grid resolution comparisons )
              ANA2BKGCNSRV: 0 or 1 ( Defaults are now model decisions based on grid resolution comparisons )

Restart Changes: yes
        Additional Imports to: tr_import_rst (Bootstrappable)


==========================================================================
07Dec2015, Takacs,    CVS Tag: Heracles-5_0
                       Module: GEOSagcm
------------------------------------------------------------------------------
1) Updates to 2nd-moment microphysics
2) Updates GMIchem_GridComp to tag: Heracles-UNSTABLE_GMI as of 10Nov2015
3) Update  to tag: mat-HU-FixRRTMGLW-v_1 to fix regression issue in RRTMG
4) Updates to QUICKSTAT to compute Confidence
5) Updates to QUICKPLOT
6) Fixed Reverse Order Argument List error for cloudnew.F90 (wrt: VFALLRN & VFALLSN)
7) Implemented RASPARAM.F90 and CLDPARAM.F90 for clarity. (zero-diff)
8) Updated DUST Optical Tables from v14.2 to v15.3
   Note: This change affects ALL Emission Types: OPS, MERRA2, PIESA, etc.
   The only way to get the original MERRA2 emission files is to run with the MERRA2 Tag.
9) Fixed SS_GridComp to maskout emissions over Great Lakes and Capsian Sea.
10) Changed Default Parameters:  SYNCTQ = 1    (ON)
                                 PRECIPRAD = 1 (ON)
                                 CLDMICRO  = 2MOMENT
11) Changed Single-Moment MicroPhysics behavior. (Note: Default is 2-Moment)

Restart Changes: none

Running Heracles 5.3

  • 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.

Heracles 5.3 Documentation

  • 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.


<mm>flash|500px|parameters startCollapsedToLevel=4</mm>


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