WRF-Hydro® v5.4.0

Version 5.4.0 of the Community WRF-Hydro® Modeling System source code is consistent with the NOAA National Water Model (NWM) v3.1 code in operations and includes the following changes, additions, and fixes:

---

WRF-Hydro® v5.4.0 Release Notes

Please note that starting with WRF-Hydro v5.4, CMake is the preferred build system. The legacy configure/compile scripts are still present, but should be considered deprecated and will not be supported in future releases.

WRF-Hydro model documentation has been migrated from individual Word and PDF files to an online documentation system that will be hosted alongside the model code in the GitHub repository. Please see the docs/ directory for more details and view the documentation on the web at:

https://wrf-hydro.readthedocs.io/en/latest

For specific updates, reference the PRs listed in the following sections:

Model Improvements

• PR#756: Add initial support for gage-assisted diversions in channel
  routing, which requires a new optional Diversion netCDF parameter file.
  This also adds a C compiler dependency
• PR#725: lake_option added to &hydro_namelist to override lake physics
  options (or turn off lakes completely). Reservoir options have been moved
  to a new, separate &reservoir_nlist namelist
• PR#743: liquid water fraction (or snow) added as optional forcing input variables
  Forcing variables names can now be supplied as namelist inputs
• PR#782: documentation converted to readthedocs, also PR#786, PR#785,
  PR#774, PR#789, PR#795, PR#796, PR#792, PR#799, PR#798, PR#791, PR#799,
  PR#798, PR#797, PR#805, PR#804, PR#809, PR#810

Bugfixes:

• PR#803, PR#808: lake_option bugfixes
• PR#813: Finding NetCDF fix for new Derecho environment
• PR#811: Adding routing diversion Makefiles
• PR#785: Support Fedora MPI environmental variables for NetCDF
• PR#752: LSM accumulations not reset if RSTRT_SWC equals no reset
• PR#729: Crocus glacier arrays changed to optional from allocatable
• Bugfixes: CMake nudging parallel build

General cleanup and misc.

• PR#802: increment version numbers
• PR#794: input namelists and parametere tables
• PR#790: PR template updates
• PR#764: adding deprecation warning to configure build, CMake preferred
• PR#739: general CMake improvements, tabs to spaces
• PR#720: header info from files removed
• PR#724: redundant return statements removed
• PR#723: MPI case style fixed
• PR#733: .F -> .F90 file renaming
• PR#717: Added citation file

WRF-Hydro® v5.3.0

Version 5.3.0 of the Community WRF-Hydro® source code is consistent with the NOAA National Water Model (NWM) v3.0 code in operations plus the following additions and fixes:

New features:

• Added impervious runoff scheme
• New new nexp spatial parameter
• Added option for Crocus snowpack/glacier model (see additional licensing terms)
• New channel option to bypass channel solver and output inflows
• New spatial snow parameters

Model physics fixes/updates:

• Array boundary fixes in channel routing
• Improved performance of nudging routines
• Correct minimum slope limit
• Corrected a situation where NaNs could be introduced in Muskingum-Cunge solver
• Moved SWE max limit to MPTABLE parameter
• Fixed energy NaNs over large snowpacks
• Miscellaneous RFC Reservoir fixes
• Moved overland roughness calculation outside of time-dependent disaggregation
• Improvements of Xinanjiang soil moisture scheme
• Added ‘scrape’ to domain edge so water doesn’t accumulate non-physically

Updated coupling infrastructure:

• Updated WRF coupling
• Updated NUOPC Cap coupling

Code-level updates that do not affect model physics:

• Removed unnecessary, harmless error messages
• Updated makefile targets to include debug, install, and test
• Removed dependency on Dask from automated tests
• Update other dependencies in testing to newest versions

WRF-Hydro® v5.2.0

Version 5.2.0 of the Community WRF-Hydro® source code is consistent with the NOAA National Water Model (NWM) v2.1 code in operations plus the following additions and fixes:

• Added snow-related vars to retrospective output configuration
• Added SFCFRNOFF output flag tied to overland runoff switch
• Support GNU Fortran (gfortran) version 10.x and 11.x
• Added missing crop and soil NoahMP namelist options
• Removed deprecated namelist options for Reach-Lakes configuration
• Fixed issues with using gridded domains with very small dimensions
• Added ISLAKE mask flag to relevant NoahMP code
• Updated NUOPC cap component with improved MPI support and to read and write restarts
• Updated default channel parameters for gridded configuration
• Performance improvements to channel network initialization
• Added global title attribute to all output netCDF files
• Updated namelist templates

WRF-Hydro® v5.2.0

This is a pre-release of the WRF-Hydro® Modeling System version 5.2.0. This version corresponds to version 2.1 of the National Water Model. Once release assets are finalized (not included with this pre-release), a final release will be published with links to updated official documentation.

NOTE: This is a pre-release and not yet officially supported by the WRF-Hydro team. Please stand by for a final release soon!

WRF-Hydro® v5.1.2

Version 5.1.2 of the Community WRF-Hydro® modeling system is a bug-fix release that corrects several small but critical errors in version 5.1.1:

• Water class value for output masking is now set to the appropriate water class code instead of being hard-coded to "16". (Addresses issue #455)

• WRF-Hydro can now be linked to versions of netCDF newer than v4.6 without crashing. (Addresses issue #382)

Beyond these fixes, no additional answer-changing modifications are present, nor are different configuration or input forcing files required from version 5.1.1.

WRF-Hydro® v5.1.1

Version 5.1.1 of the Community WRF-Hydro® source code is consistent with the NOAA National Water Model (NWM) v2.0 code in operations plus the following additions and fixes:

• Lakes in the NCAR reach configuration:
  • When running the NCAR Reach configuration, Lakes will now work as expected (similarly to the NWM configuration).
• Compound channel:
  • In order to represent a simplification of the behavior of a flood wave when it exceeds the channel bank, a compound channel formulation was added to the NWM code.
  • The compound channel formulation is currently only functional in the NWM configuration.
• RSURF_EXP parameter exposed in MPTABLE.TBL:
  • The previously hard coded soil shape function exponent parameter in Noah-MP was added to the MPTABLE.TBL parameter table as RSURF_EXP and spatial soil parameter file as rsurfexp.
  • The parameter RSURF_EXP controls the shape of the rsurf resistance curve as it relates to soil moisture: lower rsurfexp will result in higher resistance for a given soil moisture and hence less soil evaporation, higher rsurfexp will result in lower resistance and more soil evaporation.
  • For backwards compatibility with older versions of WRF-Hydro, users specifying a spatial soil parameter file (in namelist.hrldas -> noahlsm_offline -> spatial_filename) will need to update this file. The file can be updated, for example, by the following NCO command where the existing file is named "soil_properties.nc": ncap2 -O -s "rsurfexp=slope*0.0+5.0" soil_properties.nc soil_properties.nc
• BATS albedo parameters were exposed in MPTABLE.TBL
• The maximum snow water equivalent was changed to 5000mm
• Bug fix to snow liquid water movement
• Broader usage of the netCDF4/HDF5 format:
  • NetCDF3 outputs were converted to NetCDF4 and the compile time option for large file support was removed.
• Enhanced testing (additional model configurations and tests)
• Output: additional direct and diffuse snow albedo variables and minor updates to output file metadata
• Makefiles no longer generate intermediate preprocessed source files, which eases debugging (line numbers displayed will now match actual line numbers in the source code), and permits compilation on case-insensitive file systems (such as those used with macOS)
• Bugfix to reservoir physics:
  • The uniform lake surface area was set to be consistent with the vertical wall assumption.
  • Qlateral inputs were “zeroed out” for reach-based methods PR #161
• Bugfix - soil moisture check:
  • The smc smcmax check threshold was reduced from 10-6 to 10-5 due to some conflicts still triggering at the lower threshold. PR #111
  • • Bugfix - runoff mapping:
      Surface runoff that was mapped through groundwater (GW) buckets in non-UDMP configurations now behaves as pass-through only PR #306

WRF-Hydro v5.1.1-beta

This is a beta release of WRF-Hydro v5.1.1 to support the upcoming training.

WRF-Hydro v5.0.3

This minor release contains several user relevant bug fixes to WRF-Hydro detailed below.

Bug fixes

• Gridded routing lake inflows were not preserved in restarts, therefore solution to the level-pool scheme on intial timestep after model restart had slightly different initial conditions. This was fixed by preserving last timestep lake inflows in the restart files.
• The lake level-pool scheme had a number of internal bugs fixed, which should improve lake level and outflow behavior.
• Hard-coded values for minutes and seconds in output metadata were removed to allow for correct sub-hourly outputs

WRF-Hydro v5.0.2

This release only includes additional testing upgrades to v5.0. No changes have been made to the model code.

NOTE This release, and all previous releases on this branch, DO NOT pass perfect restarts for Gridded due to a number of issues with the lake code. Additionally, NWM channel-only is not functional for any releases on this branch

NOTE The domain was updated on 2018-09-18 to fix incorrect namelist settings for aggfactrt and dxrt related to issue #174

NOTE The domain was updated on 2018-10-18 to re-do spinup. There may have been issues with the original restarts in this domain, but not certain.

WRF-Hydro v5.0.1

This release is a minor release that only includes updates to model testing modules. No changes have been made to the WRF-Hydro source code.