GEOS-5 Documentation for Icarus 3.4: Difference between revisions

 
Icarus 3.4 Documentation: Updates for 3_4
 
(One intermediate revision 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 Icarus 3.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''.  
This page lists pages with information on setting up and running GEOS-5 Icarus 3.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]]'''
'''Back to [[GEOS-5 User's and Developer's Guides]]'''
Line 9: Line 9:


<pre>
<pre>
==========================================================================
13Jul2018, Takacs,    CVS Tag: Icarus-3_4_ESMF7 (zero-diff to Icarus-3_4)
                      Module: GEOSagcm
------------------------------------------------------------------------------
1) Modifications needed for use of ESMF7
2) Mods for RRTMG Longwave to enable zero-diff partitioning
Restart Changes: none
==========================================================================
13Jul2018, Takacs,    CVS Tag: Icarus-3_4 (zero-diff to Icarus-3_3_p3)
                      Module: GEOSagcm
------------------------------------------------------------------------------
1) Updates to StratChem using tag: Icarus-3_2_p9_MEM_MERGE_3
                              and  Icarus-3_2_p9_MEM_MERGE_3-r1
2) Updates using tags: GEOSldas_m4-17_UNSTABLE
                      32_GOSWIM_BUG_FIX
                      b_LANDUPD-change
3) Updates to regrid.pl (and supporting code) to ALLOW split ocean restarts
4) Updates for Icarus-3_3_p3 (i.e., sync with GEOSadas-5_21_2)
Restart Changes: none (for standard model)
==========================================================================
==========================================================================
13Jul2018, Takacs,    CVS Tag: Icarus-3_3_p3 (zero-diff to GEOSadas-5_21_2)
13Jul2018, Takacs,    CVS Tag: Icarus-3_3_p3 (zero-diff to GEOSadas-5_21_2)
Line 149: Line 172:
                 RRTMG requires new solar_internal restart.
                 RRTMG requires new solar_internal restart.
                 Simply delete old restart, and bootstrap new RRTMG 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)
</pre>
</pre>


== Running Icarus 3.3 ==
== Running Icarus 3.4 ==


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


* [[Icarus 3.3 User's Guide]]
* [[Icarus 3.4 User's Guide]]


* [[Regridding Restarts for Icarus 3.3]]
* [[Regridding Restarts for Icarus 3.4]]


* [[Using the ExtData component]]
* [[Using the ExtData component]]
Line 200: Line 192:
* [[Icarus Single Column Model]]
* [[Icarus Single Column Model]]


== Icarus 3.3 Documentation ==
== Icarus 3.4 Documentation ==


* [[Media:GEOS5_doc.pdf|GEOS 5 Developer's Guide]] (pdf)
* [[Media:GEOS5_doc.pdf|GEOS 5 Developer's Guide]] (pdf)
* 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>
** [[Icarus 3.3 states sorted by short name | Sorted by short name]]
** [[Icarus 3.4 states sorted by short name | Sorted by short name]]
** [[Icarus 3.3 states sorted by component name | Sorted by component name]]
** [[Icarus 3.4 states sorted by component name | Sorted by component name]]
<!--
<!--
Created by:
Created by:
  $ ./GMAO_Shared/MAPL_Base/mapl_vlist.py --sort comp --format wiki /home/mathomp4/Models/Icarus-3_3_p2/GEOSagcm/src/GEOSgcs_GridComp/ > /home/mathomp4/MindMapFiles/Icarus-3_3_p2/i33_states_sort_by_comp.txt
  $ ./GMAO_Shared/MAPL_Base/mapl_vlist.py --sort comp --format wiki /home/mathomp4/Models/Icarus-3_4/GEOSagcm/src/GEOSgcs_GridComp/ > /home/mathomp4/MindMapFiles/Icarus-3_4/i34_states_sort_by_comp.txt


  $ ./GMAO_Shared/MAPL_Base/mapl_vlist.py --sort short --format wiki /home/mathomp4/Models/Icarus-3_3_p2/GEOSagcm/src/GEOSgcs_GridComp/ > /home/mathomp4/MindMapFiles/Icarus-3_3_p2/i33_states_sort_by_short.txt
  $ ./GMAO_Shared/MAPL_Base/mapl_vlist.py --sort short --format wiki /home/mathomp4/Models/Icarus-3_4/GEOSagcm/src/GEOSgcs_GridComp/ > /home/mathomp4/MindMapFiles/Icarus-3_4/i34_states_sort_by_short.txt
-->
-->


Line 217: Line 209:
* [[GEOS-5 Run-Time Characteristics]]
* [[GEOS-5 Run-Time Characteristics]]


* Hierarchical structure: Below is a (partially folded) view of the Icarus 3.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.
* Hierarchical structure: Below is a (partially folded) view of the Icarus 3.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.


<!--
<!--
Line 223: Line 215:
GEOSgcs (or agcm or ogcm) and ran:
GEOSgcs (or agcm or ogcm) and ran:


   $ tree -d -I CVS -X | sed -f ~/MindMapFiles/mindmap.sedfile > ~/MindMapFiles/Icarus-3_3_p2/i33_tree.mm
   $ tree -d -I CVS -X | sed -f ~/MindMapFiles/mindmap.sedfile > ~/MindMapFiles/Icarus-3_4/i34_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 229: Line 221:
-->
-->


<mm>[[i33_tree.mm|flash|500px|parameters startCollapsedToLevel=4]]</mm>
<mm>[[i34_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]]'''