v17.10.0 - Added CatchmentCN-CLM4.5

• Zero-diff vs. v17.9.6.

• Science changes:

  • Added CatchmentCN-CLM4.5.
  • Added bilinear interpolation option for ERA5_LIS forcing.

• Infrastructure:

  • Updated MAPL (v2.14.1; fixes bit shaving error in GEOSldas v17.9.6 when a processor was not assigned any tiles).
  • Bit shaving turned on by default in HISTORY.rc template (except for increments output).
  • Updated ESMA_env (v3.8.0).
  • Updated ESMA_cmake (v3.8.0).
  • Updated GMAO_Shared (v1.5.0).
  • Updated GEOSgcm_GridComp (v1.13.1; added CatchmentCN-CLM4.5, make_bcs refactoring and bug fixes, minor fixes).
  • Updated ldas_setup to facilitate use of Cascade Lake nodes.

• Documentation:

  • Clarified parallel_build and external sub-repositories in README.md.
  • Clarified NUM_SGMT in LDAS.rc template.

• Bug fixes and other minor changes:

  • Fixed vegdyn restart issue when restarting an ensemble run from a single-member run for reduced domains.
  • Minor changes to support weakly-coupled land-atmosphere DAS.
  • Domain decomposition fix (ensure IMS>1).

v17.9.6 - Infrastructure and license updates

IMPORTANT: Running this release on NCCS/Discover requires a workaround.

• Zero-diff vs. v17.9.4.

• Science changes:

  • For GEOS-FP and MERRA-2 forcing, corrected precipitation can be on a different grid than rest of forcing data.

• Infrastructure:

  • Updated MAPL (v2.8.6, support for bit shaving of tile-space binary HISTORY output).
  • Updated ESMA_cmake (v3.5.5).
  • Updated GMAO_Shared (v1.4.6).
  • Updated GEOSgcm_GridComp (v1.12.4, minor change for LADAS coupling).
  • Updated Circle-CI.
  • GitHub script to auto-create tarball (fully mepo'd) upon release.

• Updated license (Apache 2.0).

• Bug fixes and other minor changes:

  • Minor fixes for GNU compiler.
  • Fixed PAR handling in get_GEOSs2s().

• Note: v17.9.6 fixes v17.9.5, which did not compile with GNU and was deleted soon after release.

v17.9.4 - S2S forcing reader, parallel FFT

IMPORTANT: Running this release on NCCS/Discover requires a workaround.

• Zero-diff vs. v17.9.3 for model-only simulations without perturbations using a build with standard optimization.

• Not zero-diff vs. v17.9.3 for simulations with perturbations (including data assimilation) or any simulation using a build with aggressive optimization.

• Science changes:

  • Added S2S/AODAS and S2S/Forecast surface met forcing reader.

• Infrastructure:

  • Parallel FFT on each node using shared memory (non-zero-diff change for perturbations and data assimilation).
  • Refined assignment of tiles to processors (non-zero-diff change with aggressive optimization).
  • By default, limit MKL's freedom to choose algorithms during runtime (MKL_CBWR=AVX2), to ensure 0-diff across architectures.
  • Updated ESMA_env (v3.3.0) --> Baselibs (6.2.4), ESMA_cmake (v3.5.0).
  • Updated GMAO_Shared (v1.4.4).
  • Updated GEOSgcm_GridComp (v1.12.3).

• Documentation:

  • Clarified help text for RESTART option in ldas_setup.

• Bug fixes and other minor changes:

  • Minor fixes to support debugging and non-Intel compilers (GNU).

v17.9.3 - ERA5 forcing reader, infrastructure upgrades, and cleanup

IMPORTANT: Running this release on NCCS/Discover requires a workaround.

• Zero-diff vs. v17.9.2

• Science changes:

  • Added ERA5_LIS surface met forcing reader.

• Infrastructure:

  • Revised interface to SLURM (see sample "batinp" configuration file from "ldas_setup").
  • Added optional "output server" (oserver) nodes (default is none).
  • Land analysis times now controlled with MAPL resource parameters ("LANDASSIM_DT", "LANDASSIM_T0").
  • Updated MAPL (v2.7.0), ESMA_env (v3.2.1) --> Baselibs (6.1.0), ESMA_cmake (v3.4.2).
  • Updated GMAO_Shared (v1.4.2).
  • Updated GEOSgcm_GridComp (v1.12.2):
    • Relocation of mk_restarts and Raster utilities.
    • Bug fix for running Catchment-CN with constant CO2.

• Cleanup and documentation:

  • Major cleanup of met forcing (removed SWnet).
  • Cleanup of land land pert subroutines.
  • Added legal documents ("CONTRIBUTING", "CODE_OF_CONDUCT") per NASA requirements.

• Bug fixes and other minor changes:

  • Updated read_obslog.m utility.
  • Improved GEOSldas exit message.
  • Fixes for non-Intel compilers (GNU, NAG).
  • Updated .gitignore (for mepo).

v17.9.2 - Science-tested version of CatchmentCN (CLM 4.0)

IMPORTANT: Running this release on NCCS/Discover requires a workaround.

• Science changes:

  • CatchCN model parameter and implementation changes for consistency with science-tested, published version of Lee et al. 2018 (doi:10.5194/bg-15-5635-2018).

• Infrastructure:

  • Updated MAPL (v2.4.0), Baselibs (6.0.27), ESMA_env (v3.1.3), ESMA_cmake (v3.3.5).
  • Removed support for “manage_externals” (use only “mepo”).
  • Output of analysis increments for each ensemble member.

• Cleanup and documentation:

  • Added doc/README.ConfigurationFiles.md
  • Added doc/README.OutputSpecs.md
  • Updated README.md

• Bug fixes and other minor changes:

  • Soil temperature “export” variables now consistently in units of Kelvin.
  • Updated LADAS_COUPLING option with coupling to ensemble component of ADAS through ensemble-average surface met forcing.
  • For cube-sphere forcing, added check that forcing grid matches grid associated with tile space.
  • Changed algorithm to calculate ensemble variance.
  • Removed incorrect setting to 0 of non-GEOS flux-type forcing.
  • For simulations in cube-sphere tile space, added entry for LANDPERT_INTERNAL_RESTART_FILE in LDAS.rc.
  • Minor fixes for GNU compiler.

v17.9.1 - Release for SMAP L4_SM Version 5 (patch 1)

IMPORTANT: Running this release on NCCS/Discover requires a workaround.

Bug fix for SMAP L1C Tb fore-minus-aft check.

v17.9.0 - Release for SMAP L4_SM Version 5

Zero-diff vs. v17.9.0-beta.8

---

Cleanup and documentation:

• Updated README.md, CHANGELOG.md, and README.metforcing_and_bcs.md.
• Deleted obsolete subroutines and functions.
• Improved interface for select subroutines related to “tile_coord” utilities.
• Fixed indents (blank space changes).
• Moved code that is only used during LDAS setup and pre-processing into LDAS_App directory.
• Changed variables names that used racially-charged terminology.
• Fixed confusing re-purposing of %i_indg and %j_indg of cube-sphere tiles when mapping between tiles and grids for perturbations and EnKF analysis.

Bug fixes and other minor changes:

• Monthly-average post-processing fixes.
• Fixed check of perturbations time step against start and stop times.
• Fixes for flexible “ens_id_width” field.
• Accommodate peat column in soil_param.dat of NLv4 bcs.
• Revised setup to avoid user error leading to improper cycling of LANDPERT restart files from one job segment to the next.
• Fixed degree-to-radians conversion of EASE tile lat/lon information before use in ESMF.
• Write SMAP L4 “lmc” file also when mwRTM=.true. and LANDASSIM=NO.
• Provide proper fill value in nc4 files created with tile_bin2nc4 utility.

v17.9.0-beta.8 - Pre-release towards SMAP L4_SM Version 5

Zero-diff vs. v17.9.0-beta.7.

---

Bug fixes and other minor changes:

• SLES12 bug fix for reading LAI, GRN, NIRDF, VISDF and NDVI in (LDAS) ensemble mode. Climatology files in ../input directory no longer contain ensemble ID string.
• mepo updates.

v17.9.0-beta.7 - Pre-release towards SMAP L4_SM Version 5

Zero-diff vs. v17.9.0-beta.6 for model-only simulations without perturbations.

Not zero-diff for simulations with perturbations (including data assimilation).

---

Infrastructure:

• Added calculation of ensemble-mean Catchment model diagnostics to LANDASSIM GridComp for output of instantaneous forecast and analysis estimates via HISTORY (“lndfcstana” Collection).

Bug fixes and other minor changes:

• Fixed handling of LANDPERT restart files after cold-start in first job segment.
• Fixed violation of zero-diff (binary identical) results when stopping/restarting at different intervals (removed extra zero-mean adjustment of LANDPERT after reading from restart file and fixed tile2grid operation for cube-sphere tile space).
• Fixed LANDPERT restart file name for cube-sphere.
• Added log message for all ensemble members if LANDPERT is cold-started.
• Removed deflation of LANDPERT checkpoint files.
• Added “.nc4” file name extension for cube-sphere LANDPERT checkpoint files.
• Added log messages for initialization of OBSPERTRSEED.
• Fixed typo in default OBSPERTRSEED restart file name.
• Fixed time stamp of output enspropinputs.nml file.
• Fixed FIRST_ENS_ID for post-processing.
• Added “endhour” for control of loop through job segments in lenkf.j.template to facilitate job segments that are shorter than a full day.
• Added sample entries in “LDAS.rc” for output of CHECKPOINT (restart) files before GEOSldas.x exits (RECORD_FREQUENCY, RECORD_REF_TIME, RECORD_REF_DATE).

v17.9.0-beta.6 - Pre-release towards SMAP L4_SM Version 5

Zero-diff vs. v17.9.0-beta.5 for model-only simulations without perturbations.

Not zero-diff for simulations with perturbations (including data assimilation).

---

Infrastructure:

• Output of L-band Tb via HISTORY (nodata value = MAPL_UNDEF = 1.e15).

Bug fixes:

• Changed timing of application of model prognostics perturbations such that perturbations at the current time step impact the land analysis and HISTORY output at that same time step. Before the fix, ApplyPrognPert was executed too late and the current time step's prognostics perturbations were missed by the land analysis and HISTORY, and only felt at the next time step. Consequently, simulations with perturbations are not zero-diff vs. v17.9.0-beta.5.
• Fixed no-data-value handling in computation of the ensemble average for surface temperature components.

Cleanup and documentation:

• Avoids redundant entries in LDAS.rc.
• Enabled setup for NUM_ENSEMBLE=1 with PERTURBATION=1.
• Improved help and log messages for setup and configuration.
• Option "--runmodel" of "ldas_setup" script is now obsolete.
• "DATAATM" renamed to "METFORCE" in HISTORY.rc.
• Removed default constraint to Haswell nodes.