GEOS-5

Documentation for GEOS GCM v10: Difference between revisions

← Older edit
No edit summary
Add email address
 
(7 intermediate revisions by the same user not shown)
Line 1: Line 1:
__FORCETOC__
__FORCETOC__
This page lists pages with information on setting up and running GEOS GCM version 10.  Earlier and later versions of GEOS 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 GCM version 10.  Earlier and later versions of GEOS may differ in details that, while minor, will require different steps for building and running, so ''caveat utilitor''.  
If you have any issues or questions, please email the GMAO SI Team at siteam_AT_gmao.gsfc.nasa.gov


'''Back to [[GEOS User's and Developer's Guides]]'''
'''Back to [[GEOS User's and Developer's Guides]]'''
----  
----  


<!--
= Running GEOS GCM =
To create this mediawiki changelog, I ran the CHANGELOG.md from GEOSgcm through pandoc with:


pandoc -f gfm -t mediawiki CHANGELOG.md -o CHANGELOG.wiki
* [[GEOS GCM Quick Start]]: This page describes the minimum steps required to build and run GEOS GCM v10 on NCCS discover and NAS pleiades. You should successfully complete the steps in these instructions before doing anything more complicated.


-->
* [[Regridding Restarts for GEOS GCM]]


* [[Using the ExtData component]]


= Changelog =
* [[Running a Suite of Forecasts]]


== [10.12.4] - 2020-05-15 ==
* [[Setting up to create an experiment page on GMAO Intranet]]


=== Zero-diff to previous release: YES ===
* [[Using the SatSim Gridded Component in Jason]]


=== Restart Changes: NO ===
* [[GEOS GCM Single Column Model]]


Major changes are:
= GEOS GCM Documentation =


# Brings RRTMGP code up to date with recent Pincus Master changes as of 3 May 2020
* [[Media:GEOS5_doc.pdf|GEOS 5 Developer's Guide]] (pdf)
# Add ability to run setup scripts in another's install directory
* List of Export/Import/Internal states, generated with <code>src/Shared/@MAPL/MAPL_Base/mapl_vlist.py</code>
# Support for new surface parameter resource file for land
** [[Jason 3.0 states sorted by short name | Sorted by short name]]
# Fixes issues with the scm_setup
** [[Jason 3.0 states sorted by component name | Sorted by component name]]
# Update CircleCI to use Baselibs 6.0.12
<!--
# Use different ALLREDUCE algorithm for Intel MPI
Created by:
# Change Intel MPI GATHERV algorithm so GEOSgcm does not lock up on skylakes at checkpoint
$ ./GMAO_Shared/MAPL_Base/mapl_vlist.py --sort comp --format wiki /home/mathomp4/Models/Jason-3_0/GEOSodas/src/GEOSgcs_GridComp/ > /home/mathomp4/MindMapFiles/Jason-3_0/j30_states_sort_by_comp.txt
# Add a commented out setenv for the FOR_IGNORE_EXCEPTIONS in MPT
# Add option to symlink GEOSgcm.x in experiment directory
# FSEGMENT bug fix in gcm_forecast.setup


== [10.12.3] - 2020-04-21 ==
$ ./GMAO_Shared/MAPL_Base/mapl_vlist.py --sort short --format wiki /home/mathomp4/Models/Jason-3_0/GEOSodas/src/GEOSgcs_GridComp/ > /home/mathomp4/MindMapFiles/Jason-3_0/j30_states_sort_by_short.txt
-->


=== Zero-diff to previous release: YES ===
* [[GEOS-5 Run-Time Characteristics]]


=== Restart Changes: NO ===
* Hierarchical structure: Below is a (partially folded) view of the Jason 3.0 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.


Major changes are:
<mm>[[J30_tree.mm|flash|500px|parameters startCollapsedToLevel=4]]</mm>


* Update to MAPL 2.1 which includes both fixes from [https://github.com/GEOS-ESM/MAPL/releases/tag/v2.1.0 MAPL v2.1.0] and [https://github.com/GEOS-ESM/MAPL/releases/tag/v2.1.1 MAPL v2.1.1]
<!--
** With this is included updating to latest releases of [https://github.com/GEOS-ESM/ESMA_env/releases ESMA_env] and [https://github.com/GEOS-ESM/ESMA_cmake/blob/master/CHANGELOG.md ESMA_cmake] needed by MAPL 2.1
** Add monthly mean features
** Add optional equation of time correction to solar position used to calculate solar zenith angle.


== [10.12.2] - 2020-04-16 ==
-->


=== Zero-diff to previous release: YES ===


=== Restart Changes: NO except moist_import has an additional field: FRACI ===
<!--
To create this mediawiki changelog, I ran the CHANGELOG.md from GEOSgcm through pandoc with:


Major changes are:
pandoc -f gfm -t mediawiki CHANGELOG.md -o CHANGELOG.wiki


# Added connectivity from MOIST to CHEM for 2 fields (RI and RL).
-->
# Updates to the obio component which was in the CVS Icarus-2.0 tag.
# Bugfix for coupled mode renaming TSKINI to TSKINICE.
# Bugfix for DTDT_moist which was initially set to temperature but never updated to provide tendency.
# Compute the lightning flash rate (LFR) online following the approach used by GEOSCHEMchem_GridComp. The LFR is calculated in MOIST and then made available to other components as a new export field (LFR_GCC).
# Modified the mk_Restarts script to run on SLES-12.
# Update RRTMGP to Pincus 2020-Feb-12.
# New Surface parameter resource file (GEOSsurface_GridComp/Shared/GEOS_SurfaceGridComp.rc) to avoid having to add new parameters into AGCM.rc.tmpl and prepare for further science development.
# Correcting the following issues with the single column model: (1) GF imports from DYN were not filled; (2) scm_setup incompletely adjusted for L132; (3) SST file for cfmip_s11 case was incorrect.
# Allows regrid.pl to run on SLES-12
# Enabled compilation of convert_aerosols.x as R8


== [10.12.1] - 2020-03-27 ==
= Changelog =


=== Zero-diff to previous release: YES ===
<span id="section"></span>
== [10.22.3] - 2022-06-08 ==


=== Restart Changes: NO except moist_internal has an additional 3 fields: NGRAUPEL, NRAIN, NSNOW ===
<span id="zero-diff-to-previous-release-yes"></span>
=== Zero-diff to Previous Release: YES ===


Major changes are:
<span id="restart-changes-no"></span>
=== Restart Changes: NO ===


# Broader support for various computing environments including SLES12. Adds a new question to gcm_setup (and other setup scripts) that asks a user what type of processor to run on. It then uses the &quot;default&quot; number of cores per those processors to better figure out how to handle the IOserver nodes.
Zero-Diff Changes: * Update CMake in ADAS-only subdirs by @mathomp4 in [https://github.com/GEOS-ESM/GMAO_Shared/pull/262 #262] * Change restart name <code>geocachem_internal_rst</code> to <code>achem_internal_rst</code> in <code>regrid.pl</code> by @weiyuan-jiang in [https://github.com/GEOS-ESM/GMAO_Shared/pull/264 #264] * Fix Emissions Handling: Use copy not link by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/325 #325] * Use correct EXPID when cloning an experiment by @sdrabenh in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/329 #329] * New Files added to support ExtData2G by @bena-nasa in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/590 #590] * Upticks to [https://github.com/GEOS-ESM/MAPL/releases/tag/v2.21.3 MAPL v2.21.3] and [https://github.com/GEOS-ESM/ESMA_cmake/releases/tag/v3.16.0 CMAKE v3.16.0]
# Changes that enable MAPL2 GEOS to work with MPT at NCCS.
# Changed REPLAY_Shutoff alarm from NON-STICKY to STICKY, and used it in GAAS to stop updates in forecasts during REPLAY mode.
# Updates to moist and GOCART using 2MOMENT microphysics and MG3. These are 0-diff when running the default 1MOMENT microphysics.
# Modified gcmpost.script to only operate on pressure-level collections.
# Fixes issues where systems do not have either ImageMagick or F2Py. If F2Py is not found, then F2Py targets are not built.
# Changes to GMAO_hermes:
#* Split off the independent sections of module m_topo_remap used by FV core into shared_topo_remap
#* write_eta.F90 added to prepare for a config file which eventually will replace m_set_eta module
#* Add option to build HERMES_LIGHT


== [10.12.0] - 2020-03-09 ==
<span id="section-1"></span>
== [10.22.2] - 2022-05-03 ==


=== Zero-diff to previous release: NO ===
<span id="zero-diff-to-previous-release-yes-except-for-4diau-replays"></span>
=== Zero-diff to Previous Release: YES except for 4DIAU Replays ===


<span id="restart-changes-no-1"></span>
=== Restart Changes: NO ===
=== Restart Changes: NO ===


Major changes are:
Major Zero-Diff Changes: * Hotfix to [https://github.com/GEOS-ESM/GOCART/releases/tag/v2.0.7 GOCART] and [https://github.com/GEOS-ESM/GEOSchem_GridComp/releases/tag/v1.9.2 GEOSchem_GridComp] to allow proper functioning and regression of 4D-IAU. * Hotfix to [https://github.com/GEOS-ESM/GOCART/releases/tag/v2.0.6 GOCART] using non-default klid. * Emissions handling now uses experiment RC directory by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/320 #320] * Set collection’s <code>monthly</code> attribute by default for most collections by @sdrabenh in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/316 #316] [https://github.com/GEOS-ESM/GMAO_Shared/pull/259 #259] * Removed connectivities from MOIST to CHEM that are no longer needed by @mmanyin in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/572 #572] * Defined replay predictor duration by @lltakacs in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/581 #581] * Initialize arrays in mkiau GC by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/574 #574] * Add fstats customized for screen-level Q and T with “land only” option by @saraqzhang in [https://github.com/GEOS-ESM/GMAO_Shared/pull/246 #246] * Clean up Optics in <code>AGCM.rc.tmpl</code> by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/319 #319] * Update tags in <code>regrid.pl</code> by @mathomp4 in [https://github.com/GEOS-ESM/GMAO_Shared/pull/257 #257] * Default to 72x36 for c12 mom6 by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/314 #314] * Updates for Spack Support, Round 2 by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/568 #568] [https://github.com/GEOS-ESM/GEOSgcm_App/pull/312 #312] * Update CI to use v1 orb and job by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/578 #578] * Minor CMake change for mod file by @mathomp4 in [https://github.com/GEOS-ESM/GMAO_Shared/pull/258 #258] * Upticks in [https://github.com/GEOS-ESM/MAPL/releases/tag/v2.20.0 MAPL] [https://github.com/GEOS-ESM/GEOS_OceanGridComp/releases/tag/v1.1.0 GEOS_OceanGridComp] [https://github.com/GEOS-ESM/MOM6/releases/tag/geos%2Fv2.0.3 MOM6] [https://github.com/GEOS-ESM/CICE/releases/tag/geos%2Fv0.0.1 CICE]
 
# Fixed &quot;zero-diff&quot; issue related to GF evaporation vs total rain, fixed GF cloud-mass-flux scaling issue.
# Move ShallowCu contribution to mass flux and add scale-dependent stochastics to convection.


== [10.11.0] - 2020-03-04 ==
<span id="section-2"></span>
== [10.22.1] - 2022-03-18 ==


=== Zero-diff to previous release: NO ===
<span id="zero-diff-to-previous-release-yes-1"></span>
=== Zero-diff to Previous Release: YES ===


<span id="restart-changes-no-2"></span>
=== Restart Changes: NO ===
=== Restart Changes: NO ===


Major changes are:
Major Zero-Diff Changes: * <code>tskinice</code> real fix by @rtodling in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/547 #547] [https://github.com/GEOS-ESM/GEOSgcm_App/pull/297 #297] * Update geosit history by @rtodling in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/301 #301] * Add option to read ocean ''data'' using <code>ExtData</code> by @sanAkel in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/562 #562] * Support for ocean datasets using ExtData by @sanAkel in [https://github.com/GEOS-ESM/GMAO_Shared/pull/245 #245] * Gather memory and detailed timing information for coupled model by @sanAkel in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/289 #289] * Reynolds ONLY SST and Ice Concentration with a land-sea mask from @rcullath by @sanAkel in [https://github.com/GEOS-ESM/GMAO_Shared/pull/239 #239] * Remove Ocean Grid Comp by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/551 #551] [https://github.com/GEOS-ESM/GEOSgcm/pull/379 #379] * For sea ice development: add CICE6 and SIS2 sea ice models by @sanAkel in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/558 #558] [https://github.com/GEOS-ESM/GEOSgcm/pull/385 #385] * Run History in predictor by @bena-nasa in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/546 #546] * Updates for using cubed sphere observed precip files by @lltakacs in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/559 #559] * Profiling with pflogger by @tclune in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/307 #307] * <code>chckhist.new</code> update to fix plotting for OPS HISTORY.rc, minor 3CH bugfix by @lltakacs in [https://github.com/GEOS-ESM/GMAO_Shared/pull/252 #252] * Updates to support Spack by @mathomp4 in several repositories. * Upticks in MAPL, ESMA_cmake, ESMA_env, and GEOSchem_GridComp.


# RRTMG_SW: Updates RRTMG_SW in GEOS to be equivalent to RRTMG_SW v4.10. This fix increases the heating rates near the stratospause region and is a non zero-diff change.
<span id="section-3"></span>
# RAS_NO_NEG: Provides an optional flag that ensures RAS results are non-negative. This is an important fix for chemical species that was extremely useful in the Icarus but did not make it into Jason. The fix is &quot;off&quot; by default and therefore zero-diff.
== [10.22.0] - 2022-03-15 ==
# Plots:


* Enable additional upper levels for forecast stats plots.
<span id="zero-diff-to-previous-release-no"></span>
* Add QITOT &amp; QLTOT to horizontal plots.
=== Zero-diff to Previous Release: NO ===
* Add aerosols to time series plots.


Other updates:
<span id="restart-changes-yes"></span>
=== Restart Changes: YES ===


* Remove #PBS pragmas at NCCS to use #SBATCH.
Summary of changes for the refactored GOCART-2G:
* Brought the chem setup scripts in line with gcm_setup.
* Bug fixes for gcm_run and gcm_forecast scripts.


== [10.10.0] - 2020-02-20 ==
* This is the first release of GEOSgcm that includes GOCART-2G, a refactoring of the GOCART component that adopts the ESMF for every child component and refactors the multi-instantiation mechanism. GOCART-2G only includes aerosols; other trace gases are not included by design.
* This release also includes new science, including the inclusion of secondary organic aerosols (SOAs) and Brown Carbon. In this implementation, Brown Carbon is comprise of that portion of Organic Carbon emitted by biomass burning, having absorptive properties.
* This release also introduces the notion of a “Process Library” which replaces what used to be found under Chem_Shared; it also eliminates any dependency on Chem_Base. The @GOCART repository is shared with NOAA and has been implemented in the UFS.
* Several new restarts (achem,cabc,cabr,caoc,du,ni,ss,su) have been added since the gridded components of GOCART-2G have been split out accordingly.
* GOCART-2G required changes in many other sub-repositories. Users are encouraged to look through those individually for a detailed list of changes.


=== Zero-diff to previous release: NO ===
<span id="section-4"></span>
== [10.21.1] - 2022-02-14 ==
 
<span id="zero-diff-to-previous-release-yes-2"></span>
=== Zero-diff to Previous Release: YES ===


<span id="restart-changes-no-3"></span>
=== Restart Changes: NO ===
=== Restart Changes: NO ===


This release is equivalent to the [https://github.com/NOAA-GFDL/FMS/releases/tag/2019.01.01 NOAA 2019.01.01 Release] but with the addition of GEOS constants controlled by <code>-DMAPL_MODE</code>. Additional changes allow building with CMake.
Major Zero-Diff Changes: 1. Add CLDXXSW diagnostics and many cosmetic changes to Solar GC by @dr0cloud in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/510 #510] 2. Add additional radiation RRTMG tau and water path diagnostics by @dr0cloud in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/519 #519] 3. Simple fix to prevent negative tauaer in RRTMG LW by @dr0cloud in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/521 #521] 4. Add RRTMGP as a fork in GEOS by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/528 #528] 5. Update RRTMGP file locations and half gpoints by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/294 #294] 6. Cleanup of Catchment model constants by @gmao-rreichle in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/525 #525] 7. Removed redundant code: DQS calc, QC constraint, RA calc by @gmao-rreichle in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/518 #518] 8. Fix <code>mk_GEOSldasRestart</code> for <code>catchcnclm45</code> by @weiyuan-jiang in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/516 #516] 9. <code>make_bcs</code> clarification of options by @biljanaorescanin in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/517 #517] 10. Bug fix for <code>RUNSRF</code> units in Catchment by @gmao-rreichle in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/535 #535] 11. Cleanup of <code>gndtmp[_cn]()</code> by @gmao-jkolassa in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/536 #536] 12. New peat hydrology (PEATCLSM) by @biljanaorescanin in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/524 #524] 13. Add <code>LDAS_INCR</code> to <code>AGCM.rc.tmpl</code> for land-atmos coupled das by @saraqzhang in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/288 #288] 14. Fixes for C12 MOM6 by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/285 #] 15. Updates for handling CS ocean by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/287 #287] 16. Update for NAS Runs by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/291 #291] 17. Compress CircleCI Artifacts by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/513 #513] 18. Use circleci-tools orb for CI by @mathomp4 in [https://github.com/GEOS-ESM/GMAO_Shared/pull/242 #242]


== [10.9.0] - 2020-02-13 ==
<span id="section-5"></span>
== [10.21.0] - 2021-12-21 ==


=== Zero-diff to previous release: NO ===
<span id="zero-diff-to-previous-release-no-1"></span>
=== Zero-diff to Previous Release: NO ===


=== Restart Changes: NO ===
<span id="restart-changes-yes-see-below"></span>
=== Restart Changes: YES (see below) ===


This release is equivalent in physics to v10.8.0 but now uses [https://github.com/GEOS-ESM/MAPL/releases/tag/v2.0.0 MAPL 2.0]. The release is non-zero-diff due to the use of ESMF regridding for History and ExtData.
Major Non-Zero-Diff Changes: 1. Changed the default config to use new orbit parameters by @sdrabenh in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/277 #277] 2. Refactored RRTMG long-wave and short-wave radiation by @dr0cloud in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/492 #492] 3. Adding SHOC+EDMF updates by @narnold1 in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/479 #479]. All restarts and variables within remain 0-diff except for the following: 1. moist_import * added: EDMF_FRC, HL2, HL3, HLQT, QT2, QT3, W2, W3, WHL, WQT 2. moist_internal * added: PDF_A 3. turb_import * added: PHIS, SH, WTHV2 4. turb_internal * added: QT2, QT3 * removed: BRUNTSHOC, CLD, DQDT_SHC, DQIDT_SHC, DQLDT_SHC, DTDT_SHC, LSHOC, SHEARSHOC, TKEBUOY, TKEDISS, TKESHEAR, TKETRANS, WTHV2 * changed: TKH “lev” coordinate to “edge” coordinate


Also, this version of GEOSgcm now uses the new PFIO IO server to handle History and ExtData file access and writing. By default, these IO servers run on the same resources (i.e., nodes) as the application. However, <code>gcm_setup</code> and <code>gcm_run.j</code> have been altered so that, by default, at high-resolution (C180+) the IO servers are on separate nodes for performance and memory reasons.
<span id="section-6"></span>
== [10.20.0] - 2021-12-17 ==


== [10.8.0] - 2020-02-06 ==
<span id="zero-diff-to-previous-release-no-2"></span>
=== Zero-diff to Previous Release: NO ===


=== Zero-diff to previous release: NO ===
<span id="restart-changes-yes-for-tr"></span>
=== Restart Changes: YES for TR ===


=== Restart Changes: NO (only if AOIL_COMP_SWITCH=ON) ===
Major Non-Zero-Diff Changes:


Recoded atmosphere-ocean interface layer (AOIL). Provides an option to exercise old/new versions of the AOIL.
# Uptick to [https://github.com/GEOS-ESM/GEOSchem_GridComp/releases/tag/v1.7.0 GEOSchem_GridComp v1.7.0]
#* Wet deposition for CO, CO2 and CH4 is disabled, while a bug-fix is developed.
#* GMI and TR have cleaner units handling.
# make_bcs fixes issues with “old land” choices by @smahanam in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/438 #438]
#* Old land BCS files have the same science but won’t be binary-equivalent due to bug fixes (e.g., “Mali bug”)
# Adds code to Satsim to choose subcolumns based on horizontal resolution by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/459 #459]
#* This is zero-diff for resolutions C720 and coarser but not for higher resolutions
# Uptick to [https://github.com/GEOS-ESM/ESMA_env/releases/tag/v3.8.0 ESMA_env v3.8.0] to use Intel 2021.3 which helps alleviate issues with LDAS amd NAS.
# Uptick to [https://github.com/GEOS-ESM/ESMA_cmake/releases/tag/v3.8.0 ESMA_cmake v3.8.0] to change default vectorization flag for Intel Fortran.


# Old version (AOIL_COMP_SWITCH = ON): Default. Using the old interface is still non-zero diff to x0039, however, shown to be statistically insignificant in terms of forecast skill scores. Restarts with old interface can be used as is.
Major Zero-Diff Changes:
# New version (AOIL_COMP_SWITCH = OFF): If the new interface is turned on, then the user must provide additional fields in the internal state. Contact Santha Akella for a utility to do that.


== [10.7.0] - 2020-02-04 ==
# Updated <code>regrid.pl</code> for GOCART-2G by @bena-nasa in [https://github.com/GEOS-ESM/GMAO_Shared/pull/231 #231]
# Plot Updates from L. Takacs by @sdrabenh in [https://github.com/GEOS-ESM/GMAO_Shared/pull/235 #235]
#* Added supports to plot aerosols from GOCART-2G.
#* Three-Corner-Hat (3CH) analysis tools were added.
#* Enhancements and bugfixes to quickplot and quickstat utilities.
# Lightning module has been re-located and revamped. [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/451 #451] [https://github.com/GEOS-ESM/GMAO_Shared/pull/212 #212] [https://github.com/GEOS-ESM/GEOSchem_GridComp/pull/141 #141]
# HEMCO config files for GOCART and GMI have been updated for v2.2 [https://github.com/GEOS-ESM/GEOSchem_GridComp/releases/tag/v1.7.0 GEOSchem_GridComp v1.7.0]
# Uptick to [https://github.com/GEOS-ESM/MAPL/releases/tag/v2.14.0 MAPL v2.14.0]
# Refactoring of <code>interp_restart</code> code necessitated an uptick to [https://github.com/GEOS-ESM/GFDL_atmos_cubed_sphere/releases/tag/geos%2Fv1.3.0 fvdycore geos/v1.3.0]
# Regridding fix and <code>read_topo</code> fix code necessitated an uptick to [https://github.com/GEOS-ESM/FVdycoreCubed_GridComp/releases/tag/v1.4.1 FVdycoreCubed_GridComp v1.4.1]


=== Zero-diff to previous release: NO ===
<span id="section-7"></span>
== [10.19.6] - 2021-12-09 ==


=== Zero-diff to CVS tag Jason-3_5_aoil ===
<span id="zero-diff-to-previous-release-yes-3"></span>
=== Zero-diff to previous release: YES ===


<span id="restart-changes-no-4"></span>
=== Restart Changes: NO ===
=== Restart Changes: NO ===


# Correction to RRTMG Shortwave 'layreffr' variable to reduce stratospheric cold bias.
Major 0-diff changes:
# Stats plots updates to produce stratospheric forecast statistics up to 1mb.
# Correction to gcm_run.j &amp; gcm_forecast.tmpl related to REPLAY with GAAS aod files.


== [10.6.0] - 2020-01-31 ==
# 5deg ocean (MOM6) configuration by @sanAkel in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/488 #488]
# Fixed missing verify status of iDUAL_OCEAN in GEOS_OceanGridComp.F90 by @sanAkel in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/491 #491]
# Cleaned up CircleCI by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/493 #493]
# Make big 5-d buffer in Moist optional by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/496 #496]
# The <code>idcheck.pl</code> script was updated for changes in SemperPy by @gmao-jstassi in [https://github.com/GEOS-ESM/GMAO_Shared/pull/233 #233]
# Update <code>regrid.pl</code> for Ocean Model Questions by @mathomp4 in [https://github.com/GEOS-ESM/GMAO_Shared/pull/222 #222]
# Added <code>HISTORY_GEOSIT.rc.tmpl</code> by @rtodling in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/273 #273]
# Uptick to MAPL v2.13.0 [https://github.com/GEOS-ESM/MAPL/compare/v2.12.1...v2.13.0 full list of changes]


=== Zero-diff to previous release: NO ===
<span id="section-8"></span>
== [10.19.5] - 2021-11-30 ==
 
<span id="zero-diff-to-previous-release-yes-except-for-comparing-some-history-output"></span>
=== Zero-diff to previous release: YES (except for comparing some HISTORY output) ===


<span id="restart-changes-no-5"></span>
=== Restart Changes: NO ===
=== Restart Changes: NO ===


# Atmospheric constituents (aersols, co, co2, etc) are now transported through moist/GF. This is equivalent to the way transport is handled in f525land_fpp/f525_fp.
Possible History changes:
# Added exports for nitrate tendency and other fluxes related to GF convection.
# Added nitrate tendency to history templates.
# Upgraded to GEOSchem_GridComp to v1.1.0.
# Set the default k_split = 2.
# Fixed gcm_convert.j to work consistent with how gcm_setup and gcm_run.j interact.
 
== [10.5.0] - 2020-01-24 ==


=== Zero-diff to previous release: YES (but user must setup experiment differently) ===
# Bug fix for MAPL wherein non-default duration in HISTORY.rc was not being correctly handled. For example, if a collection has a duration of 24 hours and a frequency of 12 hours, MAPL now correctly writes a file with ''two'' timesteps in it. Before, MAPL was handling this incorrectly. Note that the ''data'' is still the same as 10.19.4, but now is contained within one file.


=== Restart Changes: NO ===
Major 0-diff changes:


<ol>
# Fix mom5 mom6 for das by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/270 #270]
<li><p>Hotfixed a bug to enable regridding of catchement restarts from MERRA2</p></li>
# Allow gcm_setup to run anywhere by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/261 #261]
<li><p>REPLAY updates:</p>
# <code>WSUB</code> fix in gmichem_setup by @mmanyin in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/263 #263]
<p>The REPLAY algorithm within the GEOSagcm has been modified to enable a 4DIAU methodology consistent with that used in DAS mode. Prior to this release, REPLAY could only incorporate one analysis increment within the CORRECTOR_DURATION window (nominally 6-hours). The 4DIAU update allows for multiple analysis increments to be used within the CORRECTOR window. The number of increments that wiil be used is determined by the settings of the REPLAY_FILE_FREQUENCY (in nnnnnn seconds format) and the REPLAY_FILE_REFERENCE_TIME (in HHMMSS format). Based on these two settings, the code will determine how many analysis increments will properly fit within the CORRECTOR window. Note: the previous setting of PREDICTOR_DURATION is no longer needed since the code computes the required length automatically.</p>
# Make runtime and setup variable consistent for GCM by @rtodling in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/265 #265]
<p>The updated algorthm allows for 2 types of REPLAY:</p>
# Add code to install source tarfile by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/262 #262]
<ol>
# Replace <code>_RETURN(_SUCCESS)</code> by @weiyuan-jiang in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/484 #484]
<li><p>Exact (Uses Archived Increment Files)</p>
# Add error checking in mk_restarts executables by @weiyuan-jiang in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/467 #467]
<p>Exact REPLAYs identically reproduce (bit-for-bit) a previous GEOS DAS experiment by simply using the archived IAU forcing from the DAS experiment. For these cases, only the CORRECTOR step is employed and is, therefore, as efficient as a stand-alone model run.</p></li>
# Support update for MOM6 by @sanAkel in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/468 #468]
<li><p>Regular (Uses Archived Analysis/Assimilation Files)</p>
# Add logic to allow guest oceans to be stubbed by @tclune in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/474 #474]
<p>Regular REPLAYs are used to mimic the original IAU methodology, i.e., both the PREDICTOR and the CORRECTOR steps are employed. The key difference being that the Analysis is based on archived datasets. These Analyses may be from the GEOS DAS system, or from any other source that is written using the appropriate GEOS DAS ana.eta data format.</p></li></ol>
# Add ability to get timing from MOM6 modules by @sanAkel in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/477 #477]
# Add in support of quarter degree MOM6 to ADAS by @rtodling in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/478 #478]
# Updated <code>pyrob</code> to work with GEOS-IT files by @mathomp4 in [https://github.com/GEOS-ESM/GMAO_Shared/pull/224 #224]
# Add Cascade knob to <code>g5fcst_stats.pl</code> and <code>regrid.pl</code>; revised <code>dyn_blob</code>; make sure <code>echorc.x</code> exits with success code when applicable; by @rtodling in [https://github.com/GEOS-ESM/GMAO_Shared/pull/226 #226]
# Add OpenMP support for fvdycore by @mathomp4 in [https://github.com/GEOS-ESM/GFDL_atmos_cubed_sphere/pull/44 #44]
# ESMA_env: Update to Baselibs 6.2.8 needed for MAPL and move to use MPT 2.25 at NAS. [https://github.com/GEOS-ESM/ESMA_env/compare/v3.4.0...v3.6.0 full list of changes]
# ESMA_cmake: Add ability to create source tarball after install, various cleanup and fixes. [https://github.com/GEOS-ESM/ESMA_cmake/compare/v3.6.2...v3.7.2 full list of changes]
# MAPL: Requires gFTL 1.5.1 (Baselibs 6.2.8), added option to flip vertical orientation of checkpoints, various 0-diff bug fixes for compilers, refactored code. [https://github.com/GEOS-ESM/MAPL/compare/v2.8.6...v2.12.1 full list of changes]


<p>For more detailed information, please see the comments within the AGCM.rc.tmpl file.</p></li></ol>
<span id="section-9"></span>
== [10.19.4] - 2021-10-07 ==


== [10.4.0] - 2020-01-13 ==
<span id="zero-diff-to-previous-release-yes-for-default-agcm-yes-for-ogcm-for-single-moment-mp"></span>
=== Zero-diff to previous release: YES for default AGCM, YES for OGCM for single moment MP ===


=== Zero-diff to previous release: YES (with defaults and without regridding) ===
<span id="restart-changes-no-6"></span>
=== Restart Changes: NO ===


=== Restart Changes: YES (land regridding) ===
Major 0-diff Changes: 1. Restructuring under GEOSocean_GridComp by @yvikhlya in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/448 #448] 2. Updates to support two versions of Catchment-CN: Catchment-CN.4.0 and Catchment-CN.4.5 by @gmao-jkolassa in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/368 #368] 3. Compile time choice of CN model by @weiyuan-jiang in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/370 #370] 4. Runtime choice for clm4.0 and clm4.5 by @weiyuan-jiang in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/373 #373] 5. mk_GEOSldasRestart can now take restart hour and restart name by @weiyuan-jiang in [https://github.com/GEOS-ESM/GEOSgcm_GridComp/pull/449 #449] 6. Fixes to enable mepo variant styles by @tclune in [https://github.com/GEOS-ESM/GEOSgcm/pull/334 #334] 7. Updates needed for Cascade Lake at NCCS by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm/pull/335 #335] 8. Updates and corrections for the trajectory file created for JEDI. Variables for proper diurnal layer, TS, and CO2 have been added by @rtodling in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/257 #257] 9. Null out WSUB_NATURE for 1MOM and GFDL physics by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/251 #251] 10. Cleanup gcm_run and sync forecast scripts by @sdrabenh in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/256 #256] 11. Fixes for SCM Setup on macOS by @mathomp4 in [https://github.com/GEOS-ESM/GEOSgcm_App/pull/253 #253] 12. Updated suite of PRs for GEOSadas by @mathomp4 in [https://github.com/GEOS-ESM/GMAO_Shared/releases/tag/v1.4.10 v1.4.10] 13. Bug fix for CICE4 segfault by @mathomp4 in [https://github.com/GEOS-ESM/GMAO_Shared/pull/215 #215] 14. Add pyrob_CF script by @mathomp4 in [https://github.com/GEOS-ESM/GMAO_Shared/pull/208 #208]


* Non-zero-diff updates for:
<span id="section-10"></span>
*# Regridding land restarts
== [10.19.3] - 2021-07-21 ==
*# Running Chou-Suarez longwave radiation.


# Update FV3 to latest version v1.0.9 which fixed UH25 diagnostic to build in both R4 and R8.
<span id="zero-diff-to-previous-release-mostly"></span>
# Land Updates:
=== Zero-diff to previous release: MOSTLY ===
## Clarified LONG_NAME of &quot;snow depth&quot; variable.
## Added wemin wemout options.
## Add PEATMAP data processing (disabled by default).
## GEOSsurface_GridComp changed values of pi to MAPL_PI.
## Added 8 more climatological (fPAR, VISDF, NIRDF stats for CATCHCN) data files and new clsm/country_and _state_code.data file.
## Extra column on soil_param.* files.
# Non-zero-diif bug fix in Chou-Suarez for erroneous cloud contamination in OLR-OLRNA (aerosol forcing).
# Fixed MAPL bug with vector regridding of winds in CTM.
# Workaround fix building FMS on macOS.


== [10.3.6] - 2020-01-02 ==
<span id="restart-changes-no-7"></span>
=== Restart Changes: NO ===


=== Zero-diff to previous release: YES ===
Potential Non-0-diff Change:


=== Restart Changes: NO ===
# Upgrade to MAPL v2.8.0. For the MERRA2 GOCART Emissions, all testing shows it is zero-diff. But for the Ops GOCART Emissions, it there are very small roundoff differences. The results are non-zero-diff due to a bug fix (to a race condition) in this version of MAPL on how grids are handled.


# Compute decomposition in MKIAU GridComp
Major 0-diff Changes: 1. Detect MERRA2OX date violation during setup. 2. Make species consistent with emissions choice. 3. Only allow Rome nodes at NAS if built on Rome. 5. Updates for MVAPICH2, enable multigroup by default. 6. Bugfix for correct day when running EMIPs. 7. Update ldas increment alarm setting in CatchGC. 8. Updates to plots package. 9. Update to fvdycore v1.1.7.
# Use esma_set_this in GCs
# Allows GEOS-Chem (v12.4.0) chemistry to be setup and run &quot;out of the box&quot;.
# INTERNAL and IMPORT restarts for GEOS-Chem are now in AGCM.rc.tmpl.
# GEOS-Chem timestep is set to be 2 x HEARTBEAT by default.
# Enforces GOCART_DT==HEARTBEAT_DT so all species work correctly.
# Bug fix for comments using GNU compilers with Ninja.


<span id="section-11"></span>
== [10.19.2] - 2021-06-11 ==


== [10.3.5] - 2019-11-07 ==
<span id="zero-diff-to-previous-release-yes-4"></span>
 
=== Zero-diff to previous release: YES ===
=== Zero-diff to previous release: YES ===


<span id="restart-changes-no-8"></span>
=== Restart Changes: NO ===
=== Restart Changes: NO ===


# Enable reading netCDF increments during EXACT replay.
Changes include:
# Fixed issues affecting the MOIST aerosol diagnostics:
 
## incorrect mapping of tracer names to diagnostics
# Upgrade to Baselibs 6.2.4 and cmake v3.5.0.
## sign of the diagnostics by not allowing negative values.
# Update parallel_build to use GMAO_Shared main if develop.
# New approach for increment diagnostics discussed in GEOSchem_GridComp v1.0.3.
# Created a new grid comp <code>GEOS_SeaiceGridComp</code> as a top level container component serving sea ice sub-components to <code>OGCM</code>. This new structure mirrors the existing <code>GuestOcean/MOMPlug</code> relationship for the ocean model hierarchy.
# OXIT and OXIM replaced with MTRI%PCHEM::OXIM and TRI%PCHEM::OXIT in most HISTORY files. OX increments due to moist and turblence are now computed using BundleIncrementMod.F90 and their names have been changed.
# Bug fix that makes sure that diagnostics <code>CNV_MFC</code> still works when the UW shallow convection code is disabled.
# Implemented increments to land surface variables in the ADAS.
# Add changes consistent with what is in GEOSadas 5.28.
# Fixed GUST for AMIP vs no-inc REPLAY difference in HISTORY.
# Addition of variables for analysis in two RC files and correction in <code>IAU</code> <code>reftime</code> consistent with GEOSadas.
# Removed shallow.F90 which is no longer used.
# Fixes for <code>IOSERVER</code> on Rome.
# Updated <code>gcm_regress.j</code> to be able to test both agcm and coupled models.
# Remove references to <code>gcm_stats.j</code> in setup.


== [10.3.4] - 2019-10-01 ==
<span id="section-12"></span>
== [10.19.1] - 2021-05-25 ==


<span id="zero-diff-to-previous-release-yes-5"></span>
=== Zero-diff to previous release: YES ===
=== Zero-diff to previous release: YES ===


<span id="restart-changes-no-9"></span>
=== Restart Changes: NO ===
=== Restart Changes: NO ===


# Fields out of the MTR bundle came in the “wrong” order and affected the Henry’s law constants. Hotfix to fetch field by name instead of by index.
<span id="history-changes-yes"></span>
# Fixed triangular pdf option in SHUW.
=== History Changes: YES ===
# Update chemistry to v1.0.2 to run GMI and Stratchem. Updated the StratChem and GMIchem setup scripts to better match gcm_setup.
# Hotfix in <code>fv_tracer2d.F90</code> to compare to ksplt instead of nsplt.
# <code>FVdycoreCubed_GridComp</code> moved to separate repository.
# FMS moved to separate repository and renamed <code>GFDL_fms</code> to fms
# <code>getco2.F90</code> moved to <code>@GMAO_Shared</code>.
# Adapted <code>GuestOcean_GridComp</code> to select DATASEA, MOM5 or MOM6 at runtime.
# Changes to enable LDAS to start using the develop branch:
## ensemble ID width for LDAS
## added co2 file for CatchCN support
## bug fix that only affects New Land when snow impurity model is active
# Updates from S2S-3 CVS tag:
## Includes dual ocean code
## Update to precip correction and additional coupled diagnostics
# MERRA2_EMISSIONS_DIRECTORY path bugfix for <code>gcm_run.j</code> and <code>gcm_regress.j</code>
# Updates from CVS <code>GEOSadas-5_25_2</code> tag.
# Updated plots.
# Enhancements to <code>scm_setup</code> script.
 
== [10.3.3] - 2019-10-02 ==
 
=== Zero-diff to previous release: NO ===


=== Restart Changes: NO ===
Major changes include:


# Move to GMAO_Shared 1.0.4 to merge more updates from CVS for plots
# Upgrade to MAPL v2.7.0 which changes how programs set up command line options.
# Updates for Travis CI
# Update to FVdycoreCubed_GridComp v1.2.15 and GEOSgcm_App v1.5.1 for compatibility with MAPL v2.7.0.
# Enable GEOSgcm to output the configuration values in <code>GEOS_SurfaceGridComp.rc</code>.
# Fixes a bug in the export of <code>SSKINW</code> (an internal state of Openwater) that was being filled incorrectly leading to <code>MAPL_UNDEF</code>. Now there are actual values.
# Merged changes present in GEOSadas-5_27_1_p3 that never made it into the GIT repo: revised stochastic perturbation tendency exports.
# A bug fix to prevent a seg-fault during the calculation of the GEOS-Chem lightning flash rate due to an array size mismatch.
# Add ability to write out energy components to file.
# Update gitignore for mepo updates.
# Follow MAPL’s change to add a new <code>MAPL_CapOptions</code> constructor.


== [10.3.2 / Jason-3_2] - 2019-08-02 ==
<span id="section-13"></span>
== [10.19.0] - 2021-05-14 ==


<span id="zero-diff-to-previous-release-no-3"></span>
=== Zero-diff to previous release: NO ===
=== Zero-diff to previous release: NO ===


<span id="restart-changes-no-10"></span>
=== Restart Changes: NO ===
=== Restart Changes: NO ===


# Changes in FV3 related to Horizontal Advection choices. (from Bill: JU_20190722_WMP)
<span id="history-changes-yes-1"></span>
# Changes in FV3 dddmp (from 0.1 to 0.2, to improve stability)
=== History Changes: YES ===
# Changes in MOIST related to ICE-FALL. (from Bill: JU_20190722_WMP)
# Updates to <code>GEOS_OpenWaterGridComp.F90</code> and <code>GEOS_DataSeaGridComp.F90</code> to modify the original Coupled/Merged System to include Santha’s reformulated ice/melt. (from Santha: sakella-GEOSadas-5_25_0_DV_in_MIZ_SSTunderIceFix)
# Many updates related to CMAKE for upcoming GIT repository.
# The addition of ERA5 to QUICKPLOT.
# Modified STATS for NPO, SPO, and XPO regions. Modified Montage plots.
 
Restart Changes: None.
 
== [10.3.1 / Jason-3_1] - 2019-06-13 ==


=== Zero-diff to previous release: NO ===
Major Non-0-diff changes include: 1. Updates the DEFAULT Land BCs of GEOSgcm to be Icarus-NLv3. Also applies a fix to GEOS_SurfaceGridComp.rc to correctly implement it.


=== Restart Changes: NO ===
Major 0-diff changes include: 1. Updates <code>GMAO_psas</code> to work with MAPL2. 2. Rename <code>LANL_cice</code> to <code>CICE4</code> that is located at <code>LANL_Shared/</code> 3. Remove <code>BULK_SST</code> alias for <code>TS_FOUND</code> in HISTORies used in model (only) simulations. 4. Updates to use Python2 and Python3 at same time. 5. Fixed the <code>-wemin</code> and <code>-wemout</code> options in <code>regrid.pl</code> so that they will accept integer values. 6. Bugfix to detect if saltwater splitting is needed in more files. 7. Add <code>IOSERVER</code> code into <code>gcm_forecast.tmpl</code>. 8. Updates needed for <code>GEOSadas</code> to work with MAPL2. 9. Add GEOS-Chem and HEMCO as separate external repositories. 10. GMI is now set to import RI and RL only when running Cloud-J. This is a work-around for a CTM issue. 11. Uptick of MAPL and FMS repositories.


=== Model Changes ===
<span id="section-14"></span>
 
== [10.18.0] - 2021-04-15 ==
# Updates to <code>GuestOcean_GridComp.F90</code> to re-sync OCEAN clock with ATMOS clock when running Regular REPLAY together with DataOcean. (non-zero diff)
# Introduced code in MAPL_CFIO for HISTORY which corresponds to the “fix_undef” utility used in MERRA-2 post-processing. This creates consistency between horizontally transformed and vertically interpolated quantities and the target output level (i.e., values below surface are UNDEF).
# MKIAU has been modified to allow for REPLAYing to different vertical resolution. Results are zero-diff to previous versions if vertical resolution is the same.
# Updates to mk_restarts for Land/Catch. Zero-diff when regrid.pl points to standard (old-land) Icarus/Jason boundary area.
 
== [10.3.0 / Jason-3_0] - 2019-05-03 ==


<span id="zero-diff-to-previous-release-no-4"></span>
=== Zero-diff to previous release: NO ===
=== Zero-diff to previous release: NO ===


=== Restart Changes: NO (with caveats) ===
<span id="restart-changes-yes-1"></span>
=== Restart Changes: YES ===


Due to changes in import states and diagnostics, these restarts have changed but are passive to the prognostic restarts:
<span id="history-changes-yes-2"></span>
=== History Changes: YES ===


* irrad_internal_rst
Major Non-0-diff changes include: 1. Modified PCHEM interpolation that fixes the problem of negative PCHEM tracers. 2. A bug fix to atmOcnIntlayer consistent with what was applied to GEOS-FP GEOS-5.27.1 (02/2021) which mitigates anomalous spikes in <code>TSKINWTR</code> and related fields when the sea ice fraction departs 100%. 3. Changed scaling and cleaned up Henry’s law code in ConvPar_GF_GEOS5 (bug fix, non-zero diff for GOCART). 4. Update to use the 2020 NRL Solar file.
* surf_import_rst
* tr_internal_rst
* turb_import_rst


=== Model Changes ===
Major 0-diff changes include: 1. Fix DUAL_OCEAN options in coupled model to only work with MOM5 (It does not and can not work with MOM6). 2. Added diagnostic output for NH3, NH4A convective scavenging to GEOS_MoistGridComp used for GOCART evaluation. 3. Revive OceanBioGeoChem. 4. Fixed CMake bugs for DAS build only libraries. 5. Upticks of FVdycoreCubed_GridComp, fvdycore, and cmake repos.


# Zero-Diff update to FV3 dynamics to allow FV3+ADV option
<span id="section-15"></span>
# Updates from Mike Manyin to his tag: Jason-2_2_MEM_2
== [10.17.6] - 2021-04-06 ==
# This tag primarily is a Merge between Jason-2_2 and Andrea Molod’s coupled tag. This produces a non-zero diff to Jason-2_2 due to a modified surface layer interface.


== [Jason-2_2] - 2019-04-25 ==
<span id="zero-diff-to-previous-release-yes-6"></span>
=== Zero-diff to previous release: YES ===


=== Zero-diff to previous release: YES (in default mode) ===
<span id="zero-diff-to-regridding-yes"></span>
=== Zero-diff to regridding: YES ===


=== Restart Changes: NO (with caveats) ===
<span id="restart-changes-no-11"></span>
=== Restart Changes: NO ===


There was a long_name change in TR restart
<span id="history-changes-no"></span>
=== History Changes: NO ===


=== Model Changes ===
Major changes include:


# StratChem updated to tag: Jason-2_0_MEM_2, as well as updates to GEOS-Chem and HEMCO from Mike Manyin
# Upgrade to ESMA_env v3.2.0 whose main change is updating to ESMF 8.1.0, which is needed for MAPL development. All testing has shown it zero-diff to GEOSgcm with ESMF 8.0.1. Tests were run from C12 to C720 as well as Replay and MOM6. However, ESMF notes that there are [https://github.com/esmf-org/esmf/releases/tag/ESMF_8_1_0 changes in some regridding situations which ''could'' produce non-zero-diff results].
# CARMA updated to tag: prc+asd-AeroChem-Icarus-3_3_p2+a1-v7 from Pete Colarco (with minor mods in <code>DustEmissionMod.F90</code> because of an interface differences)
# GIT related updates.


== [Jason-2_1] - 2019-04-17 ==
<span id="section-16"></span>
== [10.17.5] - 2021-04-06 ==


=== Zero-diff to previous release: YES (in default mode) ===
<span id="zero-diff-to-previous-release-yes-for-hydrostatic-no-for-nonhydrostatic"></span>
=== Zero-diff to previous release: YES for hydrostatic, NO for nonhydrostatic ===


=== Restart Changes: YES ===
<span id="zero-diff-to-regridding-yes-1"></span>
=== Zero-diff to regridding: YES ===


* <code>turb_import_rst</code>: Simply Bootstrap.
<span id="restart-changes-no-12"></span>
* <code>surf_import_rst</code>: Simply Bootstrap.
=== Restart Changes: NO ===
* <code>irrad_internal_rst</code> (passive, for clear-sky diagnostics only): Simply Bootstrap


=== Model Changes ===
<span id="history-changes-no-1"></span>
=== History Changes: NO ===


# Retuning when using NewLand.
Major changes include:
# Addition of Optional RRTMPG (off by Default).
# Modifications for New RRTMG diagnostics.
# Updates for regrid.pl and related code.
# StratChem updated to tag: Jason-2_0_MEM_1
# GIT related updates.


== [Jason-2_0] - 2019-03-04 ==
# parallel_build.csh now accepts a <code>-hydrostatic</code> or <code>-nonhydrostatic</code> argument during building. If no argument is provided the model will build hydrostatically as before. Therefore, setup scripts were modified depending on what -DHYDROSTATIC option was supplied to CMake. If -DHYDROSTATIC=ON then it will assume the user wants to use hydrostatic dynamics options and vice versa.
# Fixed decomposition regression for nonhydrostatic model.
# Updates from ADAS 5.27 folded into git GMAO_Shared v1.3.9. This brings the GEOSadas code closer to the current GEOSgcm.
# Upticks in MOM6, MAPL, env and other repositiories.


=== Zero-diff to previous release: NO ===
<span id="section-17"></span>
== [10.17.4] - 2021-03-17 ==


=== Restart Changes: YES ===
<span id="zero-diff-to-previous-release-yes-7"></span>
=== Zero-diff to previous release: YES ===


* <code>solar_internal_rst</code> (for RRTMG). Simply Bootstrap.
<span id="zero-diff-to-regridding-no-for-agcm_import_rst"></span>
=== Zero-diff to regridding: NO for agcm_import_rst ===


=== Model Changes ===
<span id="restart-changes-no-13"></span>
=== Restart Changes: NO ===


# This is a MAJOR update to include updated moist processes based on the tag: merge_JDB7p1_retuned
<span id="history-changes-no-2"></span>
=== History Changes: NO ===


* It uses RRTMG for BOTH Shortwave and Longwave radiation.
Major changes include:
* It uses the GF Convection Scheme, as well as the UW Shallow Cumulus scheme.
* It uses dynamics tunings based on the DYAMOND experiments.


<ol start="2" style="list-style-type: decimal;">
# Moved GOCART legacy to be sourced from separate GOCART repository.
<li>Option included for running Stochastic Physics.</li>
# Update to MOM6 <code>geos/v2.0.0</code> and update to FMS <code>geos/2019.01.02+noaff.6</code>
<li>2nd-Moment Cloud MicroPhysics updated to tag: b_Jason_2_0_donifan</li></ol>
# Bug fix for regrid.pl which can cause non-0-diff regridding for agcm_import_rst.
# Fixed MOM6 diagnostics to use correct netcdf reference year.
# Fix bug in gustiness calculations.
# Fixed a bug in rotation angle for surface ocean stress.
# DSO’s for mom5 and mom6.
# <code>GAAS</code> Replay fix.
# Add <code>MOM.res.nc</code> to the list of restarts that are checked in regression testing.
# Remove <code>OCEAN_PRELOAD</code> since it is not needed with the DSO.
# Change path names to support “automatic” MERRA-2 Regular Replay at NAS.
# Remove <code>CMIP_1977_1982</code> directory in <code>GEOS_Util/pre/NSIDC-OSTIA_SST-ICE_blend</code>.
# Update <code>binarytile.x</code> for river routing.
# Bug fix for edge level arrays out-of-bounds in <code>Lighting_mod</code>.
# Plot updates for stats.


== [Jason-1_1] - 2019-01-23 ==
<span id="section-18"></span>
== [10.17.3] - 2021-02-12 ==


=== Zero-diff to previous release: NO ===
<span id="zero-diff-to-previous-release-yes-8"></span>
=== Zero-diff to previous release: YES ===


=== Restart Changes: YES ===
<span id="restart-changes-no-14"></span>
=== Restart Changes: NO ===


* GOCART IMPORT was modified by adding LWI and FRACI to be non-skip
<span id="history-changes-no-3"></span>
* TR IMPORT was modified by removing ALL but CLDTT (from RAD), since TR is run after SURF RUN(1,2)
=== History Changes: NO ===
* Note: When TR adopts a 2-phase approach, additional IMPORT variables from SURF will need to be included.


=== Model Changes ===
Major changes include:


# An error was found related to GOCART and TR regarding the TR and GOCART IMPORT restarts. This error was introduced going from Icarus-1_0_p1 to Icarus-2_0 with the splitting of GOCART into RUN1 and RUN2 methods. Essentially, the ordering in PHYSICS is: SURF,CHEM,TURB RUN1, followd by SURF,TURB,CHEM RUN2. Emissions are computed in CHEM RUN1 based on LWI locations. However, LWI is not computed until SURF RUN2. Therefore, LWI is required on the GOCART IMPORT. But this variable was labeled as RESTART_SKIP. The TR IMPORT did contain LWI, thus when TR was Enabled, GOCART saw the proper LWI. But when TR was Disabled, LWI was no longer available for GOCART, and resulted in non-zero differences. The quick solution was to label LWI as non-skip on the GOCART IMPORT restart.
# Performance modification for surface rc file in run methods.
# An error was found related to the TH_for_CHEM within the SYNC-TQ sequence. The error was fixed, but experiments showed negligible impact due to its second-order influence.
# Relocation of mk_restarts and Raster.
# Modifications to the STATS plotting package to include Mean-Square-Error decompostion.
# Bugfix for running Catchment-CN with constant CO2.
# Fixed land BCs in coupled mode
# Added optional PCHEM species file with prod/loss of strat water vapor
# Added support for the new Rome nodes at NAS named like <code>r201c2t1n4</code>
# Plots and stats updates.
# Eliminated references to MAPL_COMM - these are no longer used and will be deleted in future releases of MAPL.
# Upgrade to MAPL v2.6.0


== [Jason-1_0_BETA] – 2018-09-17 ==
<span id="section-19"></span>
== [10.17.2] - 2021-01-29 ==


=== Zero-diff to previous release: NO ===
<span id="zero-diff-to-previous-release-yes-9"></span>
=== Zero-diff to previous release: YES ===


=== Restart Changes: YES ===
<span id="restart-changes-no-15"></span>
=== Restart Changes: NO ===


* <code>saltwater_internal</code> ==&gt; <code>openwater_internal</code> &amp; <code>seaicethermo_internal</code>
<span id="history-changes-no-4"></span>
=== History Changes: NO ===


=== Model Changes ===
Major changes include: 1. Upgrade to MAPL 2.5.0 2. Updates to plots and stats package. 3. Updated PBS Batch handling at NAS. 4. Addded <code>CODE_OF_CONDUCT.md</code>


# Saltwater split =&gt; openwater and seaicethermo. This means <code>saltwater_internal</code> is now two files: <code>openwater_internal</code> and <code>seaicethermo_internal</code>. <code>saltwater_import</code> remains. Regridding utility (<code>regrid.pl</code>) will always produce the split ocean with this tag. You can, however, provide the single <code>saltwater_internal</code> as input.
<span id="section-20"></span>
# Sponge Layer fix in FV3 to include damping between top model layer and bottom of sponge.
== [10.17.1] - 2021-01-12 ==
# Regridding in MAPL now done in a new abstract/OO paradigm. This leads to the new grid definitions in AGCM.rc
# New HISTORY.rc grid_label definitions. This HISTORY is designated as VERSION: 1. Older HISTORY files (using resolution attribute) will still work provided VERSION = 0.
# QUICKPLOT updates to produce automated “closeness” plots.


== Previous Versions ==
<span id="zero-diff-to-previous-release-yes-10"></span>
=== Zero-diff to previous release: YES ===


For previous changes please see [[:File:ChangeLog-PreJason.txt|ChangeLog-PreJason.txt]]
<span id="restart-changes-no-16"></span>
=== Restart Changes: NO ===


== Running GEOS GCM ==
<span id="history-changes-yes---roundoff-differences-in-tsoil1-and-tsoil2"></span>
=== History Changes: YES - Roundoff differences in <code>TSOIL1</code> and <code>TSOIL2</code> ===


* [[GEOS GCM Quick Start]]: This page describes the minimum steps required to build and run GEOS GCM v10 on NCCS discover and NAS pleiades.  You should successfully complete the steps in these instructions before doing anything more complicated.
Major changes include:


* [[GEOS GCM User's Guide]]
# Soil temperatures export variables (TP’s) are now in units of Kelvin throughout the Catch and CatchCN. Note: this has introduced roundoff differences in <code>TSOIL1</code> and <code>TSOIL2</code> output.
# New MOM6 configuration (OM4), and a bug fix in MOM6_Plug.
# Update default coupled model surf collection with a few addition fields.
# Fix <code>saltwater_internal</code> splitting to work with in AMIP and EMIP mode.
# Add ASSERTs to RRTMG to test input sanity.
# Adds a <code>-partition</code> option to <code>mk_restarts</code> so that there can be a <code>-partition</code> option in <code>regrid.pl</code>.
# Fix <code>gcm_convert.j</code> which was broken.
# Added flag to <code>regrid_forcing_esmf.x</code> to force a 0 to 1 range when regridding files that should use fractions.
# Update flags for <code>zonal.f</code> to match CVS and fixed a bug in <code>res/zonal.gs</code> for <code>zonal.x</code> location.
# Updates to ignores CI if non-essential files are updated (only).
# Use CONFIGURE_DEPENDS flag to check if any globbed files changed when re-running cmake.
# Allow use of aggressive flags with GEOS.


* [[Regridding Restarts for GEOS GCM]]
<span id="section-21"></span>
== [10.17.0] - 2020-11-25 ==


* [[Using the ExtData component]]
<span id="zero-diff-to-previous-release-yes-11"></span>
=== Zero-diff to previous release: YES ===


* [[Running a Suite of Forecasts]]
<span id="restart-changes-no-17"></span>
=== Restart Changes: NO ===


* [[Setting up to create an experiment page on GMAO Intranet]]
Major changes include: 1. The way the model is build has changed. Manage externals is no longer supported. Mepo is now the default and replacement manager for multiple repositories. 2. Add dependency to turn on <code>BUILD_SHARED_LIBS</code> for NCEP_Shared. 3. Splits the RRTMG k_g tables into separate files. 4. Bugfix to change Intel Debug flags for MOM6 and FMS. 5. gcm_run.j bugfix for tile_hist running MOM6. 6. Update plots and stats to be consistent with recent CVS tags. 7. Bugfix for C99 compliance on MacOS. 8. Updates to CI and other subrepos.


* [[Using the SatSim Gridded Component in Jason]]
<span id="previous-versions"></span>


* [[GEOS GCM Single Column Model]]


== GEOS GCM Documentation ==
== Previous Versions ==


* [[Media:GEOS5_doc.pdf|GEOS 5 Developer's Guide]] (pdf)
For previous changes please see the [https://github.com/GEOS-ESM/GEOSgcm/blob/main/CHANGELOG.md CHANGELOG.md] on the GitHub repository
* List of Export/Import/Internal states, generated with <code>src/GMAO_Shared/MAPL_Base/mapl_vlist.py</code>
** [[Jason 3.0 states sorted by short name | Sorted by short name]]
** [[Jason 3.0 states sorted by component name | Sorted by component name]]
<!--
Created by:
$ ./GMAO_Shared/MAPL_Base/mapl_vlist.py --sort comp --format wiki /home/mathomp4/Models/Jason-3_0/GEOSodas/src/GEOSgcs_GridComp/ > /home/mathomp4/MindMapFiles/Jason-3_0/j30_states_sort_by_comp.txt
 
$ ./GMAO_Shared/MAPL_Base/mapl_vlist.py --sort short --format wiki /home/mathomp4/Models/Jason-3_0/GEOSodas/src/GEOSgcs_GridComp/ > /home/mathomp4/MindMapFiles/Jason-3_0/j30_states_sort_by_short.txt
-->
 
* [[GEOS-5 Run-Time Characteristics]]
 
* Hierarchical structure: Below is a (partially folded) view of the Jason 3.0 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>[[J30_tree.mm|flash|500px|parameters startCollapsedToLevel=4]]</mm>
 
<!--
 
-->


----  
----  
'''Back to [[GEOS User's and Developer's Guides]]'''
'''Back to [[GEOS User's and Developer's Guides]]'''
Retrieved from "https://geos5.org/wiki/index.php?title=Documentation_for_GEOS_GCM_v10"