v18.1.0 - Improved variable names and descriptions (MERRA-21C)

• 0-diff vs. GEOSldas v18.0.3 except for data assimilation in cube-sphere tile space (PR #41).

• Uses GEOSldas_GridComp v1.1.0.

• Minor changes:

  • More optimal distribution of tiles on processors for cubed-sphere tile space (PR #41).

• GEOSgcm_GridComp v2.6.3:

  • Changed exports and LONG_NAMES for land water and energy balances (GEOSgcm_GridComp PR #957).
  • Added land constants as HISTORY export variables (GEOSgcm_GridComp PR #970).
  • Removed filling of WET1 (a.k.a. GWETTOP) with 1s over non-land (GEOSgcm_GridComp PR #974).
  • Fixed conversion of minimal CAPAC to RUNOFF (catchment.F90) (GEOSgcm_GridComp PR #991).
  • Removed double-counting of snow heat correction term (StieglitzSnow.F90) (GEOSgcm_GridComp PR #946).
  • Fixed bug in optional input arg "conserve_ice10_tzero" (StieglitzSnow.F90) (GEOSgcm_GridComp PR #1025).
  • Additional cleanup of Stieglitz snow code (GEOSgcm_GridComp PR #813).
  • Improved routing outlets to ocean in make_bcs package (GEOSgcm_GridComp PR #827).
  • Fixed bad HWSDv1.21 data in Argentina "peatland" in make_bcs package (GEOSgcm_GridComp PR #944).
  • Enabled EASE M01 option in make_bcs package (GEOSgcm_GridComp PR #914).
  • Added c1120 resolution in make_bcs package (GEOSgcm_GridComp PR #961).

• Utilities:

  • GMAO_Shared v1.9.9 (PR #781).
  • GEOS_Util v2.1.3 (PR #783).
    • GEOS-IT and c1120 options for remap_restarts package (GEOS_Util PR #94, GEOS_Util PR #96)

• Infrastructure:

  • ESMA_env v4.29.1, Baselibs v8.7.0 (PR #781).
    • Update to Intel MPI 2021.13.
  • ESMA_cmake v3.52.0 (PR #781).
  • MAPL v2.50.1 (PR #781).
  • ecbuild v1.4.0 (PR #781).

• Bug fixes:

  • Do not increment CO2_YEAR when it is a no-data-value. For Catchment simulations, exclude CatchCN-specific resource variables from LDAS.rc (PR #51).
  • Bug fix and improved efficiency in matlab script for generation of mwRTM_param (PR #46).
  • Changed EXPDIR to absolute path for POSTPROC_HIST>0 option to work (PR #42).
  • Support HISTORY output of ASNOW alone from ENSAVG Gridcomp (PR #49).

• Documentation:

  • Updates and corrections (PR #776).

• Removed:

  • Removed restart options F and G (PR #40).

v18.0.3 - Bug fix in update_type=13

• 0-diff vs. GEOSldas v18.0.2.

• Uses GEOSldas_GridComp v1.0.2.

• Bug fix:

  • Fixed state increment array referencing in update_type=13 (GEOSldas_GridComp PR #26).

• Infrastructure:

  • Fixed CI for LDAS workflow (PR #768, GEOSldas_GridComp PR #34).

• Other minor changes:

  • Moved external @GEOSgcm_GridComp repository to GEOSldas/src/Components/ for consistency with directory structure of GEOSgcm and GEOSadas (GEOSldas_GridComp PR #27, GEOSldas_GridComp PR #30).
  • Changed lenkf.j.template to python string (GEOSldas_GridComp PR #16).

v18.0.2 - Bug fix in ldas_setup

• 0-diff vs. v18.0.1.

• Bug fix:

  • In ldas_setup, fixed submission of job for remapping of restarts by pointing to GEOSldas_GridComp v1.0.1.

v18.0.1 - Revised repository structure

• 0-diff vs. v18.0.0.

• Essentially identical to v18.0.0 except for revised repository structure after split into two repositories: GEOSldas and GEOSldas_GridComp (PR #748, PR #750).

• Minor changes:

  • Support for running "sbatch [FULL_PATH/]lenkf.j" from any directory (PR #745).

v18.0.0 - MODIS snow cover fraction and ASCAT soil moisture assimilation

• 0-diff vs. v17.13.1 except for MAPL bug fix (PR #734). Simulations with data assimilation are not 0-diff between SLES12 vs. SLES15 on NCCS/Discover (PR #693).

• Notes:

  • Release uses original GEOSldas repository structure. Next release is expected to use a revised repository structure.

• Science changes:

  • Added MODIS snow cover fraction assimilation (PR #512).
  • Added ASCAT soil moisture assimilation (PR #656, PR #703, PR #723, PR #729).
    • New update_type=13 for ASCAT soil moisture and SMAP brightness temperature assimilation (PR #703).
    • New update_type=13 replaces update_type=[1,2], which has been disabled.
    • Requires ASCAT mask file (PR #723, PR #729).
  • Disabled CatchmentCNCLM45 model option (LSM_CHOICE=3) (PR #707, GEOSgcm_GridComp PR #900).
  • Added support for GEOS-IT surface met forcing (PR #688).
  • Added CATCHMENT_SPINUP mode (PR #647, GEOSgcm_GridComp PR #751).

• GEOSgcm_GridComp v2.5.2:

  • Improved MODIS-based snow albedo (v2) in make_bcs package (GEOSgcm_GridComp PR #687).
  • Major source code cleanup:
    • Stieglitz snow model (GEOSgcm_GridComp PR #834).
    • make_bcs package (GEOSgcm_GridComp PR #763, GEOSgcm_GridComp PR #786, GEOSgcm_GridComp PR #846).
    • coeffsib (GEOSgcm_GridComp PR #845).
  • Fixed CDCR2 long_name (GEOSgcm_GridComp PR #818).
  • Optional checks of snow states after application of LDAS increments (GEOSgcm_GridComp PR #834).
  • Refined check for allowable bcs versions for CatchCN (GEOSgcm_GridComp PR #882).
  • Fixed treatment of atmospheric CO2 input file for CatchCN (PR #663, GEOSgcm_GridComp PR #771).
  • Fixed bug when reading vegetation type ity from restart (GEOSgcm_GridComp PR #757).
  • Fixed bug to correct vegetation fraction assessment in GetIds_carbon (getids.F90) for CatchCN (GEOSgcm_GridComp PR #770).

• Interface:

  • Use boundary conditions inputs in revised directory layout and naming convention (PR #680).

• Utilities:

  • GMAO_Shared v1.9.7 (PR #725).
  • GEOS_Util v2.0.7 (PR #725).
    • Sparse checkout of GEOS_Util (PR #711).
    • Improved remap_restarts package (GEOS_Util PR #43, GEOS_Util PR #43, GEOS_Util PR #53)
  • Added NCEP_Shared v1.3.0 (PR #656).

• Infrastructure:

  • Updated for NCCS/Discover hardware:
    • Added support for SLES15/Milan nodes (PR #693).
    • Removed support for Haswell nodes (PR #681).
  • Support for running GEOSldas at the NASA Advanced Supercomputing (NAS) facility (PR #706).
  • Allow experiment setup from another user's build (PR #733, PR #740).
  • ESMA_env v4.23.0, Baselibs v7.16.0 (PR #681).
  • ESMA_cmake v3.41.0 (PR #725).
  • MAPL v2.44.1 (PR #734).
  • CircleCI Orb v2 (PR #694).
  • Replaced FLAP with fArgParse (PR #669).
  • Updated versions of GitHub Actions (PR #739).

• Documentation:

  • Updates and corrections (PR #728).

• Bug fixes and other minor changes:

  • Fixed bug that degraded simulation when writing (MAPL-binary) instantaneous output with bit shaving (PR #734).
  • Removed requirement for mwRTM parameter input files (PR #685).
  • Support for reading corrected precipitation from aggregated daily netcdf files (PR #718).
  • Updated generate_catchincr_hist.py and sample documents for coupled land-atmosphere data assimilation (PR #698).
  • Bug fix to avoid NaN for ens std-dev in debug mode (PR #679).
  • Implementation changes for FFT used in perturbations (PR #679).
  • Some cleanup of unused variables (PR #679).
  • Updated met forcing path when coupled with ADAS (PR #682).
  • Added more export variable definitions to tile_bin2nc4.F90 (PR #676).
  • Fixed LONG_NAME for longwave radiation variables (PR #674, GEOSgcm_GridComp PR #764).
  • Fixed bug in matlab reader MAPL_ReadForcing_fullfile.m (PR #665).
  • Renamed GEOSldas_GridComp/Shared to GEOSldas_GridComp/LDAS_Shared (PR #714).

v17.13.1 - Bug fix: Remapping of restarts

• 0-diff vs. v17.13.0.

• Infrastructure:

  • GEOS_Util v2.0.1 (PR #657, PR #658).

• Bug fixes:

  • Fixed error in remapping of restarts with GEOSldas (GEOSgcm_Util PR#23).

v17.13.0 - L-band radiative transfer model options (Mironov, SMAP L2 rough reflectivity), support for ensemble stdv output

• 0-diff vs. v17.12.0 except:

  • Not 0-diff for diagnostic (HISTORY) output when bit shaving is applied (PR #629).
  • Not 0-diff for simulations with CatchCN when using RESTART: 2 (PR #629).

• Science changes:

  • Added options to microwave radiative transfer model: Mironov soil dielectric mixing model, SMAP L2_SM_P rough reflectivity parameters (PR #644).
  • Support for ensemble standard deviation output via HISTORY for selected variables (PR #635).

• GEOSgcm_GridComp:

  • Updated to v2.1.1.
    • Restructured Raster/makebcs and mk_restarts utilities: updated input paths, revised output directory tree (PR #615, PR #634, GEOSgcm_GridComp PR#694, GEOSgcm_GridComp PR#718, GEOSgcm_GridComp PR#729).
    • CatchmentCNCLM45 restart bug fixes (new optional restart variables) (GEOSgcm_GridComp PR#657)
  • Cleaned up CatchCN restart routines (PR #629).

• Utilities:

  • Updated GMAO_Shared to v1.9.0 (PR #646).
  • Added GEOS_Util repo v2.0.0 (PR #623, PR #646).
  • Added matlab utilities for EASEv2 grid (PR #622, PR #640).

• Infrastructure:

  • ESMA_env v4.9.1 (PR #646).
  • ESMA_cmake v3.28.0 (PR #618, PR #646).
  • Updated MAPL to v2.39.1 (PR #629, PR #646).

• Documentation:

  • Improved documentation for input of heterogenous perturbations standard deviation from file (PR #628).

• Bug fixes and other minor changes:

  • Fixed perturbations when root processor is not assigned any tiles (PR #642).
  • Added custom messages to Github label enforcers (PR #616).
  • Set unlimited stack size in ldas_setup (PR #620).
  • Cleaned up variable name (pert_grid) in perturbation and assimilation subroutines (PR #637).

v17.12.0 - CatchCN ensemble simulations, MODIS-based snow albedo, new and improved utilities

• Not zero-diff vs. v17.11.1 for simulations with data assimilation in EASE-grid tile space. Simulations in EASE-grid tile space without data assimilation are zero-diff except for roundoff differences in “tilegrids” and “tilecoord” parameters (ll_lat, ll_lon, ur_lat, ur_lon, dlon, dlat, area). Zero-diff for simulations in cube-sphere tile space with and without data assimilation.

• Science changes:

  • Support for MODIS-based snow albedo (GEOSgcm_GridComp PR#618).
  • Support for CatchCN ensemble simulations (PR #584, GEOSgcm_GridComp PR#645).

• Utilities:

  • Re-mapping of restart files (PR #551, GMAO_Shared PR#238, GEOSgcm_GridComp PR#571 and PR#658):
    • New GMAO_Shared utility remap_restarts.py, including fixes to re-mapping of CatchCN restart variables (not fixed for regrid.pl).
    • Deprecated perl script regrid.pl.
    • New GEOSldas utility process_rst.py (replaces process_rst.csh).
    • Re-mapping of LDASsa-formatted binary restarts is no longer supported.
    • Trivial non-zero diff changes (presence/absence) in optional restart fields (TSURF, WW, FR, CQ, CH).
    • Major cleanup of Catch[CN]-related routines for processing restarts in GEOSldas and GEOSgcm_GridComp.
    • Updated ldas_setup to python3.
  • Further cleanup and reorganization of EASE grid utilities and make_bcs (PR #586, GEOSgcm_GridComp PR#601 and PR#634):
    • Unified source code for EASEv1 and EASEv2 utilities, which causes roundoff differences.
  • Reorganized and added utilities in LDAS_App (PR #569):
    • Added matlab routines for generation of Tb scaling parameters, mwRTM parameters, and climatology files.
    • Added LADAS-related utilities and sample config files, incl. option for ensemble forcing of LDAS coupled to deterministic simulation in Hybrid4DEnVar.
    • Added script for rewinding existing GEOSldas run (PR #606).

• Interface:

  • Increased character length of string variables to avoid truncation of input file paths/names (PR #574).
  • Changed ensemble member identifier string in HISTORY.rc to “_e[XXXX]” (PR #584).
  • Restored GEOSldas “debug” mode (PR #587, PR #589, and PR #591).

• Infrastructure:

  • Updated environment, CMake, ecbuild, and MAPL (PR #604):
    • ESMA_env v4.8.0
    • ESMA_cmake v3.21.0
    • ecbuild v1.3.0
    • MAPL 2.33.0
  • GMAO_Shared v1.6.3
  • GEOSgcm_GridComp v1.17.2

• Documentation:

  • Added README_LDAS_App (PR #569)

• Bug fixes and other minor changes:

  • Fixed units labels of several CatchCNCLM45 restart variables (GEOSgcm_GridComp PR#660)

v17.11.1 - Bug fix: PEATCLSM_WATERLEVEL output

• Zero-diff vs. v17.11.0 (except revised exports PEATCLSM_WATERLEVEL, PEATCLSM_FSWCHANGE).

• Infrastructure:

  • Updated environment, CMake, and MAPL (PR #543):
    • ESMA_env v3.13.0
    • ESMA_cmake v3.12.0
    • MAPL 2.19.0
  • GMAO_Shared v1.5.5
  • GEOSgcm_GridComp v1.15.5 (make_bcs and CatchCN cleanup PR #576)
  • Updated Circle-CI (PR #543).

• Bug fixes and other minor changes:

  • Corrected exports for water table depth and free-standing water change over peat (PR #556, GEOSgcm_GridComp PR #593).

v17.11.0 - Added PEATCLSM and SMAP L2-based mwRTM parameters

• Zero-diff vs. v17.10.0 (except for double vs. single precision differences of lat/lon coordinates and metadata in HISTORY output).

• Science changes:

  • Catchment model with revised hydrology for peatlands (PEATCLSM) (PR #524, PR #515):
    • PEATCLSM hydrology is used for tiles with porosity>=PEATCLSM_POROS_THRESHOLD (default: 0.90 m3/m3) (Bechtold et al. 2019, doi:10.1029/2018MS001574).
    • In "NLv5" boundary conditions (bcs), peat tiles are identified through hybridization of PEATMAP and HWSD ancillary data and have porosity=0.93 m3/m3.
    • Standard Catchment hydrology is used for all tiles when using earlier bcs versions, which have a maximum porosity of 0.80 m3/m3 (De Lannoy et al. 2015, doi:10.1002/2014MS000330).
  • Modified EnKF update_type 10: for PEATCLSM peat tiles, "catdef" is included in EnKF State (PR #529).
  • Option to use climatological L-band microwave radiative transfer model (mwRTM) parameters derived from the SMAP L2 passive soil moisture retrievals (PR #521).
  • Option to use ensemble of surface meteorological forcing data (PR #453).
  • New export variables (WATERTABLED, FSWCHANGE, MWRTM_VEGOPACITY).

• Interface change (PR #521):

  • Change in ldas_setup resource parameters:
    • BCS_PATH --> (BCS_PATH, BCS_RESOLUTION)
    • MWRTM_FILE --> MWRTM_PATH
    • Requires new or modified ldas_setup configuration (“exeinp”) files.
  • mwRTM parameter input file(s) must be provided in subdirectory “./[BCS_RESOLUTION]” and must be named "mwRTM_param.nc4" and (if present) "vegopacity.bin".

• Infrastructure:

  • Updated environment, CMake, ecbuild, and MAPL (PR #537):
    • ESMA_env v3.11.0
    • ESMA_cmake v3.10.0
    • ecbuild v1.2.0
    • MAPL 2.18.0
  • GMAO_Shared v1.5.1
  • GEOSgcm_GridComp v1.15.1
  • Updated Circle-CI (PR #503).
  • Made GEOSldas infrastructure more similar to that of GEOSgcm (PR #501).

• Documentation:

  • Updated README.md, README.MetForcing_and_BCS.md, README.OutputSpecs.md, GEOSldas_HIST.rc, GEOSldas_LDAS.rc.
  • Cleanup of Catchment model constants (PR #525, PR #517).

• Bug fixes and other minor changes:

  • Output L-band Tb in single-member simulation without perturbations and without data assimilation (SMAP Nature Run) (PR #505).
  • Added utility script to compress bit-shaved nc4 output (PR #526).
  • Removed EXPDSC and EXPSRC from GEOSldas_HIST.rc template (PR #506).
  • Dummy GEOSldas version info in CMake (PR #516).
  • Set MAPL_ENABLE_BOOTSTRAP to YES by default (PR #523).
  • Avoid conflicts of ldas_setup with user environment (PR #518).