GEOS-5 Documentation for Heracles 5.4

This page lists pages with information on setting up and running GEOS-5 Heracles 5.4. 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:

==========================================================================
Nov092016, Takacs,    CVS Tag: Heracles-5_4_p3 (non-zero diff to Heracles-5_4_p2)
                       Module: GEOSagcm
------------------------------------------------------------------------------
1) Added emission factors for sea salt and dust at C720 and finer resolutions
2) A variety of fixes for memory leaks.
3) Update StratChem to tag: Heracles-5_4_p2_JEN_SC
4) Updates to QUICKPLOT

Restart Changes: none


==========================================================================
Oct162016, Takacs,    CVS Tag: Heracles-5_4_p2 (non-zero diff to Heracles-5_4_p1)
                       Module: GEOSagcm
------------------------------------------------------------------------------
1) Implement CallBack method between GOCART and 2-Moment Microphysics (zero-diff for single-moment microphysics)
2) Updates/corrections to GMIChem
3) Removed moving of Large-Scale Precip/Precip_Flux for Chemistry with the Single-Moment Microphysics.
   The 2nd-Momemt Microphysics moves the Large-Scale Precip/Precip_Flux for Chemistry as in Heracles-5_4_p1.
4) 2nd-Moment Microphysics updated to tag: t_H54p1_donifan_0
5) New format for Native Cube nc4 output (cube faces are now ensemble members)
6) Grads Utility (dc.gs) has been updated to read both Old and New Native Cube formats.

Restart Changes: none


==========================================================================
28Sep2016, Takacs,    CVS Tag: Heracles-5_4_p1 (non-zero diff to Heracles-5_4)
                       Module: GEOSagcm
------------------------------------------------------------------------------
1) Update to surfacelayer.F90 to fix incorrect approximation when using increased vertical levels (non-zero diff). 
2) Corrected error in Heracles-5_3 and Heracles-5_4 to properly move 3-D Precip Flux for Aerosol Scavenging
3) New Physics Tunings for improved NPW Skill
4) Added updated 132 Levels for set_eta
5) Modified AGCM and MKIAU for:
     a) Zero-diff when replaying to itself
     b) Implement 4D option
6) Updates to StratChem:  Extention from 35 to 52 species now includes all major CFCs, Halons, HCFCs, 
                          very short-lived bromocarbons, and two transport tracers. 
7) Updates to GMIChem

Restart Changes: none


==========================================================================
08Sep2016, Takacs,    CVS Tag: Heracles-5_4 (non-zero diff to Heracles-5_3)
                       Module: GEOSagcm
------------------------------------------------------------------------------
1) MAJOR update to Single-Moment Microphysics producing improved C360 NWP Skill
2) Change to default fvcore_layout_rc to REMAP using local gmao_cubic on Total Energy
3) Merge with Yuri to provide baseline coupled model tag. (zero-diff to Heracles-5_3)
4) Fix bug for UNDEF treatment within CubeToLatLon.F90 and  MAPL_HorzTransform.F90 (non-zero diff to H53)
5) Updated TURB code for zero-diff rewrite plus added TKE diagnostic
6) Removed unnecesssary RESTART TYPE from AGCM.rc.  Changed logic for CHECKPOINT TYPE.
   a) Use CHECKPOINT_TYPE if it exists
   b) Use Model Default if CHECKPOINT_TYPE does not exist or if CHECKPOINT_TYPE = 'default'
   c) Implement AGCM.rc parameter: DEFAULT_CHECKPOINT_TYPE (pnc4)


Restart Changes: none


==========================================================================
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.4

• Heracles 5.4 Quick Start: This page describes the minimum steps required to build and run GEOS-5 Heracles 5.4 on NCCS discover and NAS pleiades. You should successfully complete the steps in these instructions before doing anything more complicated.

• Heracles 5.4 User's Guide

• Using the ExtData component

• Running a Suite of Forecasts

• Setting up to create an experiment page on GMAO Intranet

• Using the SatSim Gridded Component in Heracles

• Heracles Single Column Model

Heracles 5.4 Documentation

• GEOS 5 Developer's Guide (pdf)
• List of Export/Import/Internal states, generated with src/GMAO_Shared/MAPL_Base/mapl_vlist.py
  • Sorted by short name
  • Sorted by component name

• Using svn with the trac Repository

• GEOS-5 Run-Time Characteristics

• Hierarchical structure: Below is a (partially folded) view of the Heracles 5.4 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