GEOS-5 Documentation for Icarus 3.2
This page lists pages with information on setting up and running GEOS-5 Icarus 3.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.
Back to GEOS-5 User's and Developer's Guides
ChangeLog Entry
In src/Applications/GEOSgcm_App/ChangeLog:
==========================================================================
20Feb2018, Takacs, CVS Tag: Icarus-3_2_p9 (non-zero diff to Icarus-3_2_p8)
Module: GEOSagcm
------------------------------------------------------------------------------
1. Set optics tables Chou-Suarez for SW and and RRTMG for LW.
2. Set HEARTBEAT to a minimum of 450 seconds.
3. Updated Cloud Water and Cloud Ice effective Radii.
4. New Methodology for IAU. Default: Traditional P3C6T6_DF
4DIAU: REPLAY_MODE: Exact_4D
CORRECTOR_DURATION: 10800 (3-hours)
Restart Changes: irrad_internal_rst (for RRTMG). Simply Bootstrap.
==========================================================================
19Jan2018, Takacs, CVS Tag: Icarus-3_2_p8 (non-zero diff to Icarus-3_2_p7)
Module: GEOSagcm
------------------------------------------------------------------------------
1. Enhancement to the diffusion directly in the sponge layer.
2. Set optics tables back to Chou-Suarez for both SW and LW.
Restart Changes: solar_internal_rst (Back to Chou-Suarez). Simply Bootstrap.
==========================================================================
08Jan2018, Takacs, CVS Tag: Icarus-3_2_p7 (non-zero diff to Icarus-3_2_p6)
Module: GEOSagcm
------------------------------------------------------------------------------
1. Modified GEOS_MoistGridComp.F90 to have RAS settings behave like x0027_ctl DAS experiments.
No resolution dependency for AGCM.rc file.
Restart Changes: none
==========================================================================
15Dec2017, Takacs, CVS Tag: Icarus-3_2_p6 (non-zero diff to Icarus-3_2_p5)
Module: GEOSagcm
------------------------------------------------------------------------------
1. A bug fix in RRTMG shortwave found by Max that will fix the SW Albedo issues Gary has seen in x0029 (Land & Radiation Consistency)
2. An update in FV3 that allows us to use the non-monotonic advection schemes for momentum and thermodynamic
variables without any degradation in edge effects, plus the truly linear PPM schemes in the sponge layers.
Restart Changes: none
==========================================================================
06Dec2017, Takacs, CVS Tag: Icarus-3_2_p5 (non-zero diff to Icarus-3_2)
Module: GEOSagcm
------------------------------------------------------------------------------
1) Updates to FV3 dynamics. Resolution dependency is automatic.
2) CBL_TPERT = 0 by default. Brings back PBL heights.
3) Revert REPLAY parameters back to version from GEOSadas-5_18_0 (x0029 configuration)
Restart Changes: none
==========================================================================
__Nov2017, Takacs, CVS Tag: Icarus-3_2 (zero-diff to Icarus-3_1 when NOT running Brown Carbon)
Module: GEOSagcm
------------------------------------------------------------------------------
1) Merge with tag: asd+Icarus-3_0_UNSTABLE-a2 to allow option for Brown Carbon
2) Enable IAU_DIGITAL_FILTER as default for DAS and REPLAY modes. (non-zero diff)
3) Changed BKGAVE default to 0 (from 2/3 * CORRECTOR_DURATION). (non-zero diff)
A better approach is to use: IAU_DIGITAL_FILTER: YES
Restart Changes: none
==========================================================================
__Nov2017, Takacs, CVS Tag: Icarus-3_1 (zero-diff to Icarus-3_0 when NOT running NewLand)
Module: GEOSagcm
------------------------------------------------------------------------------
1) Implement Code to enable option for running NewLand
==========================================================================
04Oct2017, Takacs, CVS Tag: Icarus-3_0 (non-zero diff to Icarus-2_0_p1)
Module: GEOSagcm
------------------------------------------------------------------------------
1) Implement R8 version of FV3 VLAB p3 dynamics. Note, current R4 version loses Dry-Mass. R8 version conserves.
2) Updated Single-Moment Physics (MOIST Processes)
3) AGCM now runs RRTMG Shortwave Radiation and Chou-Suarez Longwave Radiation by default (NOTE: cannot use old solar_internal restarts)
4) Implement cubic time-interpolation option for MKIAU in REPLAY (Default: Linear)
5) Updates to MAPL_Base and MAPL_cfio
6) Updates to QuickPlots
7) Implement bugfix to cloudnew.F90 as in Icarus-1_0_p2
8) Changed Dry-Mass value in rs_scale.F90 from 983.24 mb (MERRA-2 value) to 983.05 mb due to use of GMTED topography.
Mean TOPO difference: 1.58436898227561 meters
Note: 983.05 mb is very similar to value based on ERA-Interim data.
9) Modified GEOS_TurbulenceGridComp.F90 with more REAL*8 code to improve Dry-Mass Conservation
10) Due to updated FVCORE, GWD BGSTRESSMAX Default changed from 1.2 to 0.9 for 72-levels (Note: 132-levels probably requires re-tuning).
NOTE: Regular REPLAY to itself FAILS under certain Predictor/Corrector configurations.
(Reason UNKNOWN) P3_C6 and P0_C1 seem to work properly.
Restart Changes: YES
RRTMG requires new solar_internal restart.
Simply delete old restart, and bootstrap new RRTMG restart.
==========================================================================
24Aug2017, Takacs, CVS Tag: Icarus-2_0_p1 (non-zero diff to Icarus-2_0)
Module: GEOSagcm
------------------------------------------------------------------------------
1) Implement bugfix to cloudnew.F90.
A "typo" error was introduced into Icarus-1_0 when incorporating Tag: mjs100__msuarez to inhibit SNOW during thunderstorms.
The impact of the error directly affected cloud-liquid water and low-level optical depths.
2) Changed Dry-Mass value in rs_scale.F90 from 983.24 mb (MERRA-2 value) to 983.05 mb due to use of GMTED topography.
Mean TOPO difference: 1.58436898227561 meters
Note: 983.05 mb is very similar to value based on ERA-Interim data.
Restart Changes: none
==========================================================================
12Jun2017, Takacs, CVS Tag: Icarus-2_0 (non-zero diff to Icarus-1_0_p1)
Module: GEOSagcm
------------------------------------------------------------------------------
1) Updates from E.Nielsen to remove TR dependence on GMI.
2) GMI Updates to Stratospheric ICE fall speeds.
3) Introduce new terminology for Regular REPLAY (REPLAY_PREDICTOR, REPLAY_CORRECTOR, etc.)
4) Implement Anton's 2-Phase GOCART Tag: asd-Icarus-UNSTABLE-a3
5) Modified PHYSICS dry-mass dwdt calculation to reduce roundoff error
6) Implement Ensemble AMIP (EMIP) strategy within gcm_run.j
7) Modified MKIAU to allow creating Increments on BKG grid. Default is: GRIDINC = ANA
Restart Changes: YES
Additional IMPORT Restart: gocart_import_rst (Bootstrappable)
Running Icarus 3.2
- Icarus 3.2 Quick Start: This page describes the minimum steps required to build and run GEOS-5 Icarus 3.2 on NCCS discover and NAS pleiades. You should successfully complete the steps in these instructions before doing anything more complicated.
Icarus 3.2 Documentation
- GEOS 5 Developer's Guide (pdf)
- List of Export/Import/Internal states, generated with
src/GMAO_Shared/MAPL_Base/mapl_vlist.py
- Hierarchical structure: Below is a (partially folded) view of the Icarus 3.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.
<mm>flash|500px|parameters startCollapsedToLevel=4</mm>