SA_MESH_1.5/SA_MESH_1.5.7

MESH 1.5.7

Bug-fixes:

• Resolves an error with newer GNU/gfortran versions where the end of the header in r2c-format files is not found when seeking the file.
• Fixed the labels of FSNET and FLOUT (previously FSSTAR and FLSTAR). These were labelled FSOUT and FLOUT but are calculated as the net radiation, and not as the outgoing radiation.
• Fixed the label of the CMAI variable. CMAS still exists as a canopy-based parameter input for CLASS but CMAI is representative of the prognostic (i.e., state) variable, and this change makes the variable consistent with CLASS documentation.
• Fixed indexing and initializing errors of I/O variables and throughout some routines.

Features:

• Added TBAS as an output variable.
• Added checks in HDS to ensure its input dependencies are active.

Minor changes:

• Removed GGEO as an I/O-variable. GGEO is a constant (i.e., boundary) condition for CLASS used in TMCALC (and equivalent code in ICEBAL), and is not a prognostic state or diagnostic output variable. The I/O variable was not used and does not impact assigning GGEO using GGEOFLAG and MESH_ggeo.ini.

Breaking changes:

• The CMAS, FSOUT and FLOUT labels, names and columns throughout all output files are now labelled CMAI, FSNET and FLNET, respectively. The values of these outputs themselves have not changed. The updated labels are now representative of those values, which were incorrectly labelled in previous releases. A variable list for MESH outputs is maintained on the MESH Wiki, here: https://mesh-model.atlassian.net/wiki/spaces/USER/pages/6390056/Variable+List

Full Changelog: SA_MESH_1.5/SA_MESH_1.5.6...SA_MESH_1.5/SA_MESH_1.5.7

Pre-compiled binaries for Windows notes

• sa_mesh_157.exe: NetCDF 4.7.4, NetCDF-Fortran 4.5.3
• ms-mpi_sa_mesh_157.exe: NetCDF 4.7.4, NetCDF-Fortran 4.5.3, MS-MPI 10.1.1-10 (https://www.microsoft.com/en-us/download/details.aspx?id=100305)

SA_MESH_1.5/SA_MESH_1.5.6

MESH 1.5.6

This release a modified version (v2) of the Hysteretic Depressional Storage (HDS) model to simulate prairie fill and spill mechanism.

The original HDS (v1) was based on the equations listed in Ahmed et al. (2023). This version of HDS (v2) is revised based on the equations presented by Clark and Shook (2022), which is cleaner and more robust than the one proposed in HDS (v1).

See README.md here: https://github.com/CH-Earth/HDS/blob/main/README.md

Pilot: https://zenodo.org/records/17958184
Integration detail: https://mesh-model.atlassian.net/wiki/spaces/DEV/pages/198705175/Hysteretic+Depressional+Storage+HDS

Full Changelog: SA_MESH_1.5/SA_MESH_1.5.5...SA_MESH_1.5/SA_MESH_1.5.6

Pre-compiled binaries for Windows notes

• sa_mesh_156.exe: NetCDF 4.7.4, NetCDF-Fortran 4.5.3
• ms-mpi_sa_mesh_156.exe: NetCDF 4.7.4, NetCDF-Fortran 4.5.3, MS-MPI 10.1.1-10 (https://www.microsoft.com/en-us/download/details.aspx?id=100305)

SA_MESH_1.5/SA_MESH_1.5.5

MESH 1.5.5

Bug-fixes:

• Restored support for ROTLATLONG and rotated_latitude_longitude projections for grid-based domains using EnSim Hydrologic/GreenKenue r2c or NetCDF format configuration files.

Full Changelog: SA_MESH_1.5/SA_MESH_1.5.4...SA_MESH_1.5/SA_MESH_1.5.5

Pre-compiled binaries for Windows notes

• sa_mesh_155.exe: NetCDF 4.7.4, NetCDF-Fortran 4.5.3
• ms-mpi_sa_mesh_155.exe: NetCDF 4.7.4, NetCDF-Fortran 4.5.3, MS-MPI 10.1.1-10 (https://www.microsoft.com/en-us/download/details.aspx?id=100305)

SA_MESH_1.5/SA_MESH_1.5.4

MESH 1.5.4

Updates to AUTOCALIBRATIONFLAG (SIMSTATS):

• The routines for calculating KGE, RMSE and MAE have been updated, but should not have any impact on the calculated results.
• The calculation of time-to-peak TPD has been updated, where previously it may have returned an incorrect result.
• The TPD output has been removed, and its column shifted in Metrics_Out.txt (also impacting the positions of the KGE and NegKGE columns in Metrics_Out.txt, see below). TPD for simulated daily flows is now labelled TDPS. The calculation of TDP has also been added for observed daily streamflow, TDPO.
• Added new functions to calculate Center of Mass (TtCoM) and Spring Pulse Onset Date (SPOD) of simulated and observed daily flow (TCOMS, TCOMO, SPODS, SPODO).
• The individual modules for calc_abserr, calc_drms and KGE are no longer used; these files are inactive in makefile and will eventually be removed.

Breaking changes:

• Changed bias to return as a percentage PBIAS, also changing the label from BIAS to PBIAS in Metrics_Out.txt and MonteCarlo.txt.
• Changed the polarity for PBIAS (switching -ve and +ve value). The absolute PBIAS, AbsPBIAS, remains unchanged.
• Changed the order of columns in Metrics_Out.txt impacting KGE and NegKGE (moved up by one column) with the removal of the TPD column (columns for TDPS and TDPO have been added, following NegKGE).

Full Changelog: SA_MESH_1.5/SA_MESH_1.5.3.1...SA_MESH_1.5/SA_MESH_1.5.4

Pre-compiled binaries for Windows notes

• sa_mesh_154.exe: NetCDF 4.7.4, NetCDF-Fortran 4.5.3
• ms-mpi_sa_mesh_154.exe: NetCDF 4.7.4, NetCDF-Fortran 4.5.3, MS-MPI 10.1.1-10 (https://www.microsoft.com/en-us/download/details.aspx?id=100305)

SA_MESH_1.5/SA_MESH_1.5.3.1

MESH 1.5.3.1

Bug-fixes:

• Restores compatibility for non-NetCDF forcing file formats from MESH 1.5.3

Full Changelog: SA_MESH_1.5/SA_MESH_1.5.3...SA_MESH_1.5/SA_MESH_1.5.3.1

Pre-compiled binaries for Windows notes

• sa_mesh_1531.exe: NetCDF 4.7.4, NetCDF-Fortran 4.5.3
• ms-mpi_sa_mesh_1531.exe: NetCDF 4.7.4, NetCDF-Fortran 4.5.3, MS-MPI 10.1.1-10 (https://www.microsoft.com/en-us/download/details.aspx?id=100305)

SA_MESH_1.5/SA_MESH_1.5.3

MESH 1.5.3

Changes in CLASS

• GRALB will use the user-provided values from canopy type 5 (urban) for SAND -3 (rock) instead of hard-coded values. Set the values in parameter files to zero to revert to the previous behaviour.
• APREP will use user-provided values for ZPLS and ZPLG regardless of the state of IWF. Set the values in parameter files to zero to revert the calculations to use the hard-coded values, particularly for the calculations for vegetated canopies.

Changes for NetCDF files

• Adds support for timestamps including T for time dimension (e.g., YYYYMMDDTHH:MM:SS)
• Adds FORCINGLIST to read a list of incremental forcing files from the specified file (ending with .txt), similar to event files in WATFLOOD. The option only supports files in NetCDF format.

This release does not contain any pre-release number.

Full Changelog: SA_MESH_1.5/SA_MESH_1.5.2...SA_MESH_1.5/SA_MESH_1.5.3

Pre-compiled binaries for Windows notes

sa_mesh_153.exe: NetCDF 4.7.4, NetCDF-Fortran 4.5.3
ms-mpi_sa_mesh_153.exe: NetCDF 4.7.4, NetCDF-Fortran 4.5.3, MS-MPI 10.1.1-10 (https://www.microsoft.com/en-us/download/details.aspx?id=100305)

SA_MESH_1.5/SA_MESH_1.5.2

MESH 1.5.2 (r1861 pre-release update 2)

This release adds the pad_outlets option to SHDFILEFLAG. Also see the MESH 1.5.1 release notes here.

SHDFILEFLAG <format> pad_outlets

The pad_outlets option will add an artificial outlet to the ends of channel networks read from the drainage database. This can allow streamflow to be output for the last cell or subbasin in a channel segment when no 'dummy' outlet was appended during the process of creating the drainage database file (e.g., if not created using GreenKenue).

Full Changelog: SA_MESH_1.5/SA_MESH_1.5.1...SA_MESH_1.5/SA_MESH_1.5.2

Pre-compiled binaries for Windows notes

sa_mesh_152.exe: NetCDF 4.7.4, NetCDF-Fortran 4.5.3
ms-mpi_sa_mesh_152.exe: NetCDF 4.7.4, NetCDF-Fortran 4.5.3, MS-MPI 10.1.1-10 (https://www.microsoft.com/en-us/download/details.aspx?id=100305)

SA_MESH_1.5/SA_MESH_1.5.1

MESH 1.5.1 (r1861 pre-release)

This release contains changes completed during the Global Water Futures research program, with a particular focus on CLASS for multi-decadal simulations under future climate and land-use changes, but also includes many changes to MESH overall.

Versioning:

MESH 1.5.1 is the first MESH version released since the MESH code repository has been moved to GitHub. The minor version has been incremented to reset the release versioning. The release number in MESH 1.4 versions used to correspond to the tagged commit from the Subversion changelog. Because commits are tracked differently in Git, the release number is now incremented only with new releases, and no longer indicative of the number of individual commits to the code made between releases, and will no longer correspond to the ID of a particular commit. The specific commit corresponding to the MESH 1.5 version is contained in the metadata of the release itself.

Significant changes:

• Updated PBSM and added snow-related changes ported from CLASS 3.6.2. Added more CLASS diagnostic outputs.
• Fixed the units of snow sublimation when included in total evapotranspiration losses.
• Added support for subbasin/vector/HRU-based outputs, parameter file and initial state override files in NetCDF format; added soil states to the initial state override file in both r2c and NetCDF formats. Fixed errors reading character-type fields from NetCDF files.
• Added a column for station names in Metrics_Out.txt and of stations and reservoir labels to column headers in CSV basin-output files.
• Fixed inline limit of 999999 daily time-steps related to streamflow, inflow and reservoir input in RTE.
• Fixed mismatched precision in DZTR when compiled with the double target for WF_ROUTE and RTE. Added DZTR resume states (using the temporary txt-format file) when using NetCDF resume files.
• Reactivated SUBBASINFLAG using the "ACLASS" approach, extended to exclude inactive cells or subbasins in WF_ROUTE and RTE.
• Changed RESUMEFLAG auto to try to resume from regular resume files if the auto_resume.ini file is not found.
• Fixed writing missing frames of partial hours, days, months and/or years when the simulation ends in the middle of an hour/day/month/year.
• Merged latest MOUNTAINMESH updates, which removes delta_elevmax as an input, adds skyviewfactor as an input, removes idecl as an option, and adds iconsmm as an option. The options of other flags have also changed or have been updated.

Other changes:

• Minor bug-fixes and style updates.

Known issues:

• This code contains unoptimized changes and will run slower than past releases. A future incremental release will address this.
• A column is added in Metrics_Out.txt to accommodate adding the station name, and may require updating other configuration files and/or scripts (e.g., for calibration or post-processing).
• Resume files in NetCDF format created with MESH 1.4.1860 with DZTR active will be missing the DZTR resume file (in temporary txt-format, zone_storage_states.txt). The file can be created by re-running MESH 1.4.1860 with SAVERESUMEFLAG 5 or by creating new resume files with MESH 1.5.1 with SAVERESUMEFLAG nc.
• MOUNTAINMESH updates and options are still being documented.

Considerations:

• Updates to the CLASS physics may result in slight differences in numerical outputs.

Full Changelog: SA_MESH_1.4/SA_MESH_1.4.1860...SA_MESH_1.5/SA_MESH_1.5.1

Pre-compiled binaries for Windows notes

sa_mesh_151.exe: NetCDF 4.7.4, NetCDF-Fortran 4.5.3
ms-mpi_sa_mesh_151.exe: NetCDF 4.7.4, NetCDF-Fortran 4.5.3, MS-MPI 10.1.1-10 (https://www.microsoft.com/en-us/download/details.aspx?id=100305)

MESH 1.4.1860 (r1860)

MESH 1.4.1860 (r1860)

This release contains optimizations regarding how internal variables and fields are managed and stored, and related to the handling or inputs and outputs (I/O), as well as for improvements for more descriptive and consistent messaging and error handling throughout.

Other changes:

• Added support for the scale_factor, add_offset, valid_max and valid_min attributes for variables read from netCDF files.
• Reactivated the internal LQWSSOL and FZWSSOL variables to handle when tiles within a grid have different values for DZWAT/DZSOLHYD, as before.
• Activated LQWSICE to contribute to STGW, as well as the TICE variable. Added columns for the LQWSICE and TICE variables to the basin-average water and energy balance output files, respectively.
• Re-issued the use of DRAINSOL as only water from the bottom of the soil column and distinguished RCHG as the water that enters any active baseflow/aquifer and LKG as water that is released from lower zone storage to match documentation. The revised terms now match how 'wf_lzs' is described in the WATFLOOD manual. Total runoff no longer considers DRAINSOL; only OVRFLW, SUBFLW and LKG. The labels for these columns have been revised in the basin-average water balance output file.
• Added pbsm_fraction_threshold as an internal parameter to disable the redistribution of snow to tiles with a grid-fraction less than the specified value.

Bug-fixes:

• Bug-fixes to remove implicit allocations throughout.
• Bug-fix in 'WFILL' for the case when soil profiles are greater than 10.0 m in depth.
• Fixed an issue where mal-formed gridded domains that do not contain the minimum 2-by-2 dimension originally enforced by the EnSim/Green Kenue software would be interpreted as a vector-/subbasin-based domain, which would result in certain properties, such as the derivation of latitudes and longitudes from the EnSim grid specification, not being calculated.
• Bug-fix in PBSM to use the proper tile-fraction within a grid instead of the FARE parameter from 'MESH_parameters_CLASS.ini'.
• Added Subl from PBSM to the general ET parameter to account for the missing water balance term.
• Bug-fix where if the 'MESH_ggeo.ini' file is used, it might use a file unit already used by another open file.

Known issues or limitations:

• This version of the code will print "1858" to screen.
• This version contains in-progress optimizations for inputs and outputs (I/O) and is known to run slower than previous versions.
• Subl is added to ET using incorrect units .

Full Changelog: https://github.com/MESH-Model/MESH-Dev/commits/SA_MESH_1.4/SA_MESH_1.4.1860

Pre-compiled binaries for Windows notes

• sa_mesh_r1860.exe: NetCDF 4.7.4, NetCDF-Fortran 4.6.1
• ms-mpi_sa_mesh_r1860.exe: NetCDF 4.7.4, NetCDF-Fortran 4.6.1, MS-MPI 10.1.1-10 (https://www.microsoft.com/en-us/download/details.aspx?id=100305)