Documentation for GEOS GCM v10: Difference between revisions

Changelog: Update to 10.17
Line 53: Line 53:


= Changelog =
= Changelog =
== [10.17.0] - 2020-11-25 ==
=== Zero-diff to previous release: YES ===
=== Restart Changes: NO ===
Major changes include:
# 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.
# Add dependency to turn on <code>BUILD_SHARED_LIBS</code> for NCEP_Shared.
# Splits the RRTMG k_g tables into separate files.
# Bugfix to change Intel Debug flags for MOM6 and FMS.
# gcm_run.j bugfix for tile_hist running MOM6.
# Update plots and stats to be consistent with recent CVS tags.
# Bugfix for C99 compliance on MacOS.
# Updates to CI and other subrepos.
== [10.16.3] - 2020-11-02 ==
=== Zero-diff to previous release: YES ===
=== Restart Changes: NO ===
Changes include:
# Added fixture section to <code>components.yaml</code>
== [10.16.2] - 2020-10-28 ==
=== Zero-diff to previous release: YES for default catchment, NO for CatchmentCN ===
=== Restart Changes: NO ===
The latest release is a 0-diff change when running the default catchment. However, it is a non-0-diff change when running CatchmentCN.
# Updates to land:
## SurfParams: Introduced separate parameter collections for different land model choices that are being cross-checked against the land model choice.
## Updates to reproduce Fanwei Zeng’s LDASsa Catchment-CN simulations (science-validated, published) using the 'CN_CLM4' option.
# Restructure/Refactor <code>DO_OBIO</code> (see [https://github.com/GEOS-ESM/GEOSgcm_GridComp/issues/362 Issue #362])
# Add Docker authentication for pulls.
# Add logger for NaN detection (at a WARNING level) for QSAT and DQSAT codes.
# Make plots/configure portable when using someone else's build.
# Allow longer job names for PBS/SLURM.
# Update to MAPL.
== [10.16.1] - 2020-10-14 ==
=== Zero-diff to previous release: YES for AGCM, NO for coupled model ===
=== Restart Changes: YES (<code>OLRB06RG</code> and <code>TBRB06RG</code> variables added to <code>irrad_internal</code> restart) ===
Major updates include:
# Add TOA RRTMG Band6 (window region) IR diagnostics.
# Include new diagnostics for the constraints and new plots for them.
# Clean up clumsy logic in GEOS_OpenWaterGridComp.F90 [https://github.com/GEOS-ESM/GEOSgcm_GridComp/issues/356 Issue #356]
## removes the <code>AOIL_COMP_SWITCH</code>
## AOIL now properly works with the coupled model ('''non 0-diff''')
## maintains 0-diff for uncoupled mode
## computations to update the state variables (TW, SW, HW and other internals) are now performed via a call to <code>AOIL_v0</code>.
## <code>AOIL_v0</code> also provides following two options that are turned OFF by default:
##* provide a more gradual decay of diurnal warming as observed in nature: <code>WARM_LAYER_GRAD_DECAY</code>
##* update turbulent heat fluxes after the state variables have been updated: <code>UPDATE_FLUXES_AOIL_SECOND_STEP</code>
# Upgrade to MAPL 2.3 with a number of changes listed [https://github.com/GEOS-ESM/MAPL/releases/tag/v2.3.0 here].
# Fixed regrid_forcing.x and regrid_forcing_esmf.x so they will work with MAPL2.2 and beyond.
# Logging config improvements and bugfixes.
# Fixed a bug in ExtData when extrapolating on a Leap Day.
# Added a deflate and bit shaving option to <code>Regrid_Util.x</code>.
# Fix bug with using coarse grids in History and ExtData.
# Lowers the amount of jobs used during <code>make -jN install</code> in <code>build.csh</code> to mitigate possible segfaults.
# Updated the NCPUs detection in various post scripts to be SLURM-aware.
== [10.16.0] - 2020-09-28 ==
=== Zero-diff to previous release: NO ===
=== Restart Changes: NO ===
The only change in this release is moving back to using <code>int()</code> not <code>nint()</code> in GEOS_Shared/GEOS_Utilities.F90 which may cause crashes if the Debugging flags are on. Nevertheless, this is a non zero-diff change to the gcm.
== [10.15.0] - 2020-09-25 ==
=== Zero-diff to previous release: NO ===
=== Restart Changes: YES for values; NO for entries/structure ===
Major non-0-diff changes include:
# Update to ESMA_env v3.0.0 (NOTE: '''''SLES 11 Support at NCCS is Removed''''')
* ESMA Baselibs 6.0.16
* Use a new Python Stack: GEOSpyD/Min4.8.3_py2.7
* Update compilers and MPI stacks
** NCCS
*** Intel Fortran 19.1.2
*** Intel MPI 19.1.2
** NAS
*** Intel Fortran 2020.2.254 (aka 19.1.2)
*** MPT 2.17 (same as before)
** GMAO Desktop
*** Intel Fortran 19.1.2
*** Open MPI 4.0.4
<ol start="2" style="list-style-type: decimal;">
<li>The GEOSadas-5_27_0 version of GEOS_Shared/GEOS_Utilities.F90 has slightly different code, <code>nint()</code> instead of <code>int()</code>. This brings git up to date.</li>
<li>Bugfix for computations in uwshcu.F90 that involved <code>MAPL_UNDEF</code></li>
<li>Bug fix for GCC 10 with <code>DRHOS0</code></li>
<li>Upgrade to GEOSchem_GridComp v1.4.1</li></ol>
== [10.14.2] - 2020-09-25 ==
=== Zero-diff to previous release: YES ===
=== Restart Changes: NO ===
Changes include:
# Update to FVdycoreCubed_Gridcomp v1.2.5
# Update RRTMGP to master aug2020
# Add logging capability
# Fixes for setup scripts
# Remove Latlon atmosphere in setup
# Updates for coupled model setup
# Add section for AWS SLURM
# Allow SCM to run with 91, 137 and 181 levels
# Restore use of SHARE CHMDIR at NCCS for all levels
# NCL scripts added to generate MERRA2 forcing for SCM
# Remove clock rewind only in replay logic for GuestOcean
# Add melt_potential and fix Orphan Points for MOM6 plug/Guest ocean
# Subroutines called from within OPENWATERCORE of GEOS_OpenWaterGridComp.F90 have been moved GMAO_Shared to be shared across applications/components
# Clean up/simplify AOIL
# Clean up of Saltwater's children
# Genericize NCAR GWD Beres file location
# PRECIPFRAC functionality for Catch and CatchCN
# Updates to allow GEOS to build without MKL
# Run binarytile.x without MPI dur to Intel issues
# Upticks of other subrepo/component versions
== [10.14.1] - 2020-07-23 ==
=== Zero-diff to previous release: YES ===
=== Restart Changes: NO ===
Major changes include:
# Allows EMIPs to work with New Land restart files. These files do not necessarily occur on the same day of the month. The modified code will search for files within a given year-month and start an EMIP member from that date.
# Fixed gcm_regress.j such that it allows to run regression test on coupled model with MOM5 and MOM6 ocean.
# Removed S2S history template with confusing name.
# Adds an fv3_setup and fv3.j script for the FV3 Standalone.
# Allows the JCAP functionality to work again in mkiau gridcomp as that needs the r4 version of ncesp_sp in gmao_transf.
# Modify mpirun flags for Open MPI 4.0.4.
# Updates to plots.
== [10.14.0] - 2020-07-17 ==
=== Zero-diff to previous release: YES - for default 72L-1MOM configuration ===
=== Restart Changes: YES - gwd_import_checkpoint has been added ===
Major changes include:
# Added MOM6 plug
# Added NCAR GWD
# Updated GFDL microphysics
# Updated MOM5
# Run time switch between MOM5 or MOM6
# Updates for JEDI Integration
# Updated FMS
# Sparsed out FVdycore_GridComp and ARIESg3_GridComp dynamical cores. Sparsed out GMAO_pilgrim from GEOSgcm_GridComp.
# Update Aerosol Chemistry BCs to match new vertical levels.
# Additional question in setup scripts for:
## Chosing microphysics option
## Chosing hydrostatic/non-hydrostatic mode
== [10.13.0] - 2020-06-26 ==
=== Zero-diff to previous release: ONLY 72L 1-MOMENT DEFAULT CONFIG ===
=== Restart Changes: NO ===
Only 0-diff for 72-level 1-MOMENT default configuration. Non-0-diff for ALL others. Major changes include:
# Support for increased vertical resolution and updates in FV3 and GFDL. New 71, 91, and 181-level options which have eta distributions similar to the ECMWF 137-level option. New 127-level option is similar to NCEP. Retuned surface mixing results in non-0-diff changes to the 132-level option.
# Updated MPI Settings for running at NCCS.
# New updates from S2S3 tag in CVS.
# Updates to coupled plotting package (coupled_diagnostics)
# Fixed MOM_GEOS5Plug MAPL Timers for RUN2.
# River routing updates.
# SLES12 bugfix reading LAI, GRN, NIRDF, VISDF and NDVI in (LDAS) ensemble mode.
# CatchCN now gets daylength from MAPL sun code abstractly so it works with the new procession including type of orbit.
# Updated to Chemistry v1.3.5.
# Added lines to AGCM.rc.tmpl to run RRTMGP (disabled by default).
== [10.12.5] - 2020-06-05 ==
=== Zero-diff to previous release: YES ===
=== Restart Changes: NO ===
Changes include:
# Uptick the versions of many sub-repos (MAPL,cmake,env,GEOSchem_GridComp,GEOSgcm_GridComp,GEOSgcm_App,GMAO_Shared).
# Bugfix for array bounds in RRTMG LW.
# Rolls back the constraint on gcmpost.script to only operate on pressure-level collections.
# Added ignore_nan option for time_ave.F (off by default).
# Enables correct post proccessing of MAPL monthly collections.
# CICE updates for reading binary grid files.
# MIN_FREEZE_SALINITY added to AGCM.rc in coupled mode.


== [10.12.4] - 2020-05-15 ==
== [10.12.4] - 2020-05-15 ==