v20.2.0 - Default tile-space HISTORY output to nc4; bug fixes

• 0-diff vs. GEOSldas v20.1.0 except:

  • Not 0-diff for lat/lon fields in "1d" nc4 output owing to roundoff differences between files directly generated with MAPL [new default] and files generated with tile_bin2nc4 [discontinued].
  • Not 0-diff for ASCAT and CYGNSS data assimilation.

• Uses GEOSldas_GridComp v3.2.0.

• New features:

  • Changed default format of tile-space HISTORY output to nc4 (GEOSldas_GridComp PR #144).
  • Added reader for surface meteorological forcing from S2S-3 (GEOSldas_GridComp PR #138).

• Minor changes:

  • Cleaned up ldas_setup; split out ldas.py and setup_utils.py; restored ntasks-per-node option (GEOSldas_GridComp PR #107).
  • Enable remapping of landice restarts from ldas_setup (GEOSldas_GridComp PR #146).
  • Added matlab reader for binary mwRTM vegopacity file (GEOSldas_GridComp PR #142).
  • Commented out static QC mask in CYGNSS obs reader (GEOSldas_GridComp PR #151).
  • Update GEOSlandassim_GridComp/io_hdf5.F90 to allow for use with HDF5 1.14 (GEOSldas_GridComp PR #139).

• GEOSgcm_GridComp v2.8.0:

  • Added "make_topo" scripts to "make_bcs" for generation of topography files used by AGCM (GEOSgcm_GridComp PR #1054).
  • Updated introductory comments in GEOS_SurfaceGridComp.rc (GEOSgcm_GridComp PR #1133).

• Bug fixes:

  • Fixed bug in ASCAT EUMET soil moisture obs reader; bumped max_obs limit (GEOSldas_GridComp PR #148, GEOSldas_GridComp PR #151).
  • Provide default "zoom" value for remap_restarts yaml file (GEOSldas_GridComp PR #137).
  • Fixed Restart=1 when the domain is not global (GEOSldas_GridComp PR #107).

• Utilities:

  • GMAO_Shared v2.1.4 (PR #836).
  • GEOS_Util v2.1.10 (PR #836).

• Infrastructure:

  • ESMA_cmake v3.64.0 (PR #836).
  • ESMA_env v5.13.0, Baselibs v8.18.0 (PR #836).
  • MAPL v2.63.1 (PR #836, PR #839, PR #842).

v20.1.0 - ObsFcstAna postprocessing tool and 2d output for EASE

• 0-diff vs. GEOSldas v20.0.0.

• Uses GEOSldas_GridComp v3.1.0.

• New features:

  • Python package for post-processing ObsFcstAna output into data assimilation diagnostics (PR #87, PR #111).
  • Support for 2d output from EASE tile space and 2d output on EASE grid:
    • Switched EASE grid handling to new MAPL EASE Grid Factory (PR #115).
    • Revised pre-processing of HISTORY template (PR #118).
  • Support for tile space of stretched cube-sphere grids (PR #109).

• Minor changes:

  • Revised experiment setup for coupled land-atm DAS (PR #102).
  • Updated defaults in LDASsa_DEFAULT_inputs_*.nml files (PR #104).
  • Specify only "ntasks_model" in SLURM resource request (PR #106).
  • Added optional SLURM "constraint" (PR #112).

• GEOSgcm_GridComp v2.7.5:

  • Optional numerical derivatives for Monin-Obukhov exchange coefficients over land in offline mode (GEOSgcm_GridComp PR #999).
  • Fixed treatment of freezing rain in Catchment[CN] (GEOSgcm_GridComp PR #1111).
  • Use MAPL EASE Grid Factory (GEOSgcm_GridComp PR #1112).

• Bug fixes:

  • UDUNITS error (PR #101, PR #123).

• Utilities:

  • GEOS_Util v2.1.9 (PR #822).

• Infrastructure:

  • MAPL v2.57.0: EASE Grid Factory (PR #819, PR #821).

v20.0.0 - Added landice simulation

• 0-diff vs. GEOSldas v19.0.0.

• Uses GEOSldas_GridComp v3.0.0.

• Science changes:

  • Added functionality to simulate landice tiles (PR #18).
  • Added model-based QC of (MODIS) snow cover area fraction observations using layer-1 soil temperature (PR #96).

• Minor changes:

  • Added default settings and command line args for coupled land-atm DAS (PR #94).
  • Added functionality to read nc4-formatted tile file (PR #18).

• GEOSgcm_GridComp v2.7.4:

  • Use nc4-formatted tile file when remapping (GEOSgcm_GridComp PR #1087, GEOSgcm_GridComp PR #1094).
  • Adjust tile file for coupled atm-ocean model (GEOSgcm_GridComp PR #1075).

• Utilities:

  • GMAO_Shared v2.1.1 (PR #809, PR #812).
  • GMAO_perllib v1.1.0 (PR #809, PR #812).
  • GEOS_Util v2.1.8 (PR #705).
  • NCEP_Shared v1.4.0 (PR #812).

• Infrastructure:

  • ESMA_env v4.38.0, Baselibs v7.33.0 (PR #812).
  • ESMA_cmake v3.62.1 (PR #812).
    • Added BUILD_INFO.rc file.
    • Updated parallel build and CI workflows.
  • MAPL v2.56.0 (PR #809, PR #812).

v19.0.0 - Multi-sensor soil moisture and snow cover assimilation, M21C met forcing

• 0-diff vs. GEOSldas v18.1.0 for Intel with standard optimization and no bit shaving. Otherwise, there are roundoff differences in diagnostic output (PR #796).

• Uses GEOSldas_GridComp v2.0.0.

• Science changes:

  • New update_type for joint 3d soil moisture and 1d snow analysis (Tb+sfmc+sfds+SCF obs) (GEOSldas_GridComp PR #68).
  • Updated subroutine read_obs_sm_ASCAT_EUMET() to work with both original and revised file name templates (GEOSldas_GridComp PR #69).
  • Added CYGNSS soil moisture reader (GEOSldas_GridComp PR #76).
  • Added M21C surface met forcing (GEOSldas_GridComp PR #77, PR #794).

• Minor changes:

  • Revised variable names (SHORT_NAME) and descriptions (LONG_NAME) to match M21C file specs (GEOSldas_GridComp PR #72).
  • Updated subroutines read_obs_sm_ASCAT_EUMET(), read_obs_SMAP_halforbit_Tb(), read_obs_SMOS() and read_obs_MODIS_SCF() with hardcoded time ranges for when observations are available and should be read (GEOSldas_GridComp PR #73).
  • Renamed tilecoord%pfaf to %pfaf_index; added matlab tile file reader (GEOSldas_GridComp PR #78).
  • Improved setup of coupled land/atm DAS (incl. changed nomenclature of met forcing files: "Nx+-" --> "bkg.lfo_*") (GEOSldas_GridComp PR #81).

• GEOSgcm_GridComp v2.7.2:

  • Updated LONG_NAME attributes to match M21C file specs; conservative regridding of (obs) PRECIP_FILE inputs (GEOSgcm_GridComp PR #1032).
  • Fixed mean land elevation; v13 bcs (GEOSgcm_GridComp PR #1049). Not 0-diff for make_bcs!
  • Turned off GOSWIM via N_constit=0 (GEOSgcm_GridComp PR #1050).

• Utilities:

  • GEOS_Util v2.1.6 (PR #796).

• Infrastructure:

  • ESMA_env v4.36.0, Baselibs v7.32.0 (PR #796).
    • Removed SLES12 for NCCS.
    • Moved to GEOSpyD 24.11.3 Python 3.12.
  • ESMA_cmake v3.57.0 (PR #796).
  • MAPL v2.54.2 (PR #796).

• Removed:

  • Removed support for SLES12 operating system at NCCS (GEOSldas_GridComp PR #83).

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).