GEOS-5 Documentation for Heracles 5.1: Difference between revisions

Revision as of 07:57, 2 June 2016

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

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


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

Running Heracles 5.1

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

Heracles 5.1 User's Guide

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.1 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 for Heracles 5.2

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