v.4.12.0 Release Notes

Target Beta Release: 15 Sept 2023 

New Features

Improved Terrain Data Management

As of v4.12, terrain data is now managed such that there is only one copy of the terrain, and terrain-derived rasters, per terrain-projection combination. In previous versions, a copy of the terrain data, and terrain-derived rasters, was made for every basin model regardless of whether the terrain and projection were the same. This caused excessive project size on disk, most notably when many copies of the basin model were made, as is the case in forecasting.

The terrain and terrain-derived files are now located in <project directory>/terrain/<terrain name>/<projection index> location, unless an external reference is made. Pre-v4.12 projects will be automatically migrated, which moves the terrain file from <project directory>/terrain/<terrain name>.elevation.tif to the new terrain directory. Additionally, terrain-derived rasters are moved to the new terrain directory from the <project directory>/gis/<basin name> folder.

The <project directory>/terrain directory of an HEC-HMS project is managed by HEC-HMS. Manually manipulating the contents of this directory could corrupt the project and result in data loss or render the project unopenable.

As part of the terrain data management improvements, there is now an option to copy terrain data when using Project | Save As to create a copy of the project. If the copy terrain data option is selected, a copy of the terrain files will be made in the new project location. If the copy terrain data option is not selected, a reference will be made to the terrain files in the original project location.

This feature was funded by the Corps Water Management System (CWMS) National Implementation Program. Initial code and implementation was done by Tom Brauer. Testing was done by Matt Fleming, Mike Bartles, and Tom Brauer. 

Improved Terrain Data Management when using CWMS/HEC-RTS

In previous versions of HEC-HMS, when extracting a "forecast" project from a "base" project within an CWMS/HEC-RTS watershed, all terrain data and terrain-derived data sets (e.g., flow direction, flow accumulation, etc.) were copied to the "forecast" project. Now, the "forecast" project will instead reference the "base" project's terrain data. This improvement will shorten the amount of time necessary to extract a new "forecast" project as well as save disk space.

This feature was funded by the Corps Water Management System (CWMS) National Implementation Program. Initial code and implementation was done by Mike Bartles and Tom Brauer. Testing was done by Matt Fleming, Mike Bartles, and Tom Brauer. 

Storm Temporal Pattern and Area Reduction Function Sampling

In v4.11, the ability to sample non-numeric parameters was added in the form of sampling precipitation gridsets. This concept has been extended in v4.12 to allow sampling of a hypothetical storm's storm pattern and area reduction function in the Uncertainty Analysis. A Parameter Value Samples paired data must be created that lists storm patterns or area reduction functions. The paired data must then be referenced as an Uncertainty Analysis parameter.

The image below shows the "Storm Patterns" Parameter Value Samples paired data selected in the Uncertainty Analysis component editor.

The image below shows the resulting hydrographs from randomly sampling the storm pattern.

This feature was funded by the USACE Flood & Coastal R&D Hypothetical Storms work unit. Initial code implementation was done by Thomas Brauer and Natasha Sokolovskaya. Testing was done by Greg Karlovits.

A tutorial and guide demonstrating the usage of depth-area reduction sampling within HEC-HMS can be found here: Sampling Depth-Area Reduction Curves for a Hypothetical Storm.

Ensemble Analysis Compatibility with Sediment Time-Series

In v4.11, the Ensemble Analysis compute type was created. In v4.12, the time-series types that are compatible with the Ensemble Analysis have been extended to include sediment load, sediment volume, and bulk flow. Total time-series are available for selection as well as individual grade time-series types.

This enhancement was funded by the SET program, and selected due to user feedback from a USACE CWMS wildfire workshop. Initial code implementation was done by Josh Willis. Testing was done by Dr. Jay Pak and Josh Willis. 

Several tutorial and guides demonstrating the usage of the Ensemble Analysis within HEC-HMS can be found here: Using the Ensemble Analysis.

Ensemble Analysis Viewer

A Ensemble Analysis Viewer has been added to allow users to view ensembles computed in HEC-HMS and perform metric computes on the ensemble time series. The ensemble viewer can compute metrics as a "Single Summary Time Series", "Single Value for each Ensemble", or a Single Value Summary. The viewer can be accessed through the Tools | Ensemble Viewer. More information on the viewer is described here: Ensemble Viewer Users Guide.

This feature was funded by the FIRO program. Initial code implementation and documentation were done by David Ho. Review and testing were completed by Josh Willis and Tom Brauer.

Linear Deficit and Constant Loss Method

The Linear Deficit and Constant loss method is a modification of the initial constant loss method. This method accounts for changes in infiltration capacity (or potential infiltration rate) as a function of cumulative infiltration and can be applied as an event-based or continuous model. This new loss method will compute excess runoff even when the soil is not saturated if the precipitation intensity is large enough. More information can be found in the HEC-HMS Technical Reference Manual, Linear Deficit and Constant Model.

This feature was funded by the HH&C General Investigation Hydrologic Studies program. Algorithm development was completed by Dr. Gerhard Schoener, SSCAFCA Senior Hydrologist, code implementation was completed by Paul Ely, and documentation and testing were completed by Gerhard Schoener, Sara Rassa, Matt Fleming Natasha Sokolovskaya, and Tamara Massong.

A tutorial and guide demonstrating the usage of the Linear and Constant loss method within HEC-HMS can be found here: Applying the Linear Deficit and Constant Loss Method.

Uncertainty Analysis method: Specified Values - Random (Same Index)

This new Uncertainty Analysis method combines the sampling methods of the Random and Specified Values methods. With this method, the sample index order will be random, based on the starting seed value, and all parameters using this sampling method will use the same index.

The original Specified Values method has been renamed to Specified Values - Random (Independently Random).

This feature was funded by the FEMA Future of Flood Risk Data initiative. Initial code implementation was completed by Daniel Black. Documentation and testing were completed by Daniel Black and Greg Karlovits.

Solar Shading Coefficient Time Series and Spatial Results

Incoming shortwave (a.k.a. solar) radiation at a location can be reduced due to the surrounding terrain. These effects can lead to snow melting slower within shaded areas. While solar shading was included within previous versions of HEC-HMS, users can now visualize the computed solar shading coefficient as a subbasin-average time series or as a spatial result (e.g., at each grid cell) when using either the Gridded Hybrid or Gridded Energy Budget snow methods, as shown below.

This feature was funded by the USACE Arid Regions R&D work unit. Initial code implementation was completed by Mike Bartles. Documentation and testing were completed by Mike Bartles and Avital Breverman.

Simple Surface Initial Conditions Options

For the Simple Surface method, the initial state can now be defined both by the percent of the maximum storage that is filled, as well as by a depth of water.

This feature was funded by the FEMA Future of Flood Risk Data initiative. Initial code implementation was completed by Lauren Coe and Paul Ely. Documentation and testing were completed by Greg Karlovits.

Simple Canopy Initial Conditions Options

For the Simple Canopy method, the initial state can now be defined both by the percent of the maximum storage that is filled, as well as by a depth of water.

This feature was funded by the FEMA Future of Flood Risk Data initiative. Initial code implementation was completed by Lauren Coe and Paul Ely. Documentation was completed by Lauren Coe and testing was completed by Greg Karlovits.

Import Reach Routing Parameterizations from a Shapefile

GIS import tools were added to read-in reach routing attributes from shapefiles and automate the parameterization of Muskingum, Muskingum-Cunge, Normal Depth, and Kinematic Wave routing methods. If applicable, eight-point cross-sections are also automatically created from attribute information in the shapefile and used to parameterize the routing method. This feature was funded by Maricopa County. Initial code implementation was completed by Josh Willis. Documentation and testing were completed by Josh Willis.

A tutorial and guide demonstrating the parameterization of several reach routing methods via shapefile attributes can be found here: Applying the Maricopa County Parameter Estimation Tools.

Extend Results Output Interval to Include Weekly, Monthly, and Yearly Options

In previous versions of HEC-HMS, the results output interval could only be extended up to 24 hours within the output control dialog associated with the simulation. The output interval has now been extended to include weekly, monthly, and yearly output options.

Code implementation was completed by Josh Willis. Documentation and testing were completed by Josh Willis.

Hypothetical Storm Precipitation-Frequency Grid Selection Enabled with Area-Dependent Pattern Storm

In previous versions of HEC-HMS, if the Hypothetical Storm method chosen was the Area-Dependent Pattern, only the user-specified Point Depth option was available for precipitation. Now, users have the option of selecting the Precipitation-Frequency Grid precipitation method when using the Area-Dependent Pattern method. When using a precipitation-frequency grid, a computation point is specified and the average precipitation point depth upstream of the computation point is automatically calculated and applied during a simulation run.

This feature was funded by the Flood Control District of Maricopa County, AZ. Initial code implementation was completed by Josh Willis. Documentation and testing were completed by Matt Fleming, Greg Karlovits, and Josh Willis.

Additional State Initialization Options in Gridded Temperature Index Snow Method

Previously, the user could choose between "Parameter Grids" or "Default Values" for the initialization of Snow Water Equivalent, Cold Content, Liquid Water Content, Cold Content ATI and Meltrate ATI and a single initialization method was chosen for all five of the state variables. This update allows the user to choose a different initialization method for each of the state variables and a new option for a user-defined "Constant Value" is now available. This feature was funded by the Corps Water Management System (CWMS) National Implementation Program. Initial code and implementation were done by Lauren Coe and Tom Brauer. Documentation and testing were done by Lauren Coe.

MetSim Precipitation Method

This new meteorologic method, as implemented within HEC-HMS, follows that which is described in Bohn, et al (2019). This method interpolates sub-daily precipitation depths from an input daily precipitation accumulation grid through the use of an isosceles triangle shaped temporal distribution, which allows for more effective usage of daily meteorological boundary conditions when combined with sub-daily computational time steps. An example application of this method is shown in the following image. In this image, the input daily precipitation data (blue hyetograph) was disaggregated to an hourly time step (red hyetograph):

A tutorial demonstrating the usage of the MetSim Precipitation Method within HEC-HMS can be found here: Using the New MetSim Precipitation and Temperature Methods.

This feature was funded by the USACE Mississippi River Geomorphology & Potamology (MRGP) and General Investigations (GI) programs. Initial code implementation was completed by Mike Bartles, Dan Hamill, and Tom Brauer. Documentation and testing were completed by Mike Bartles, Dan Hamill, Paul Ely, and Tom Brauer.

MetSim Temperature Method

This new meteorologic method, as implemented within HEC-HMS, follows that which is described in Bohn, et al (2013). This method interpolates sub-daily air temperatures from input daily minimum and maximum air temperature grids through the use of a spline polynomial, as shown in the following image. In this image, the input daily minimum (black thermograph) and maximum (green thermograph) air temperature data was disaggregated to an hourly time step (blue thermograph). For comparison, the daily average air temperature (red thermograph) is also shown:

A tutorial demonstrating the usage of the MetSim Temperature Method within HEC-HMS can be found here: Using the New MetSim Precipitation and Temperature Methods.

This feature was funded by the USACE MRGP and GI programs. Initial code implementation was completed by Mike Bartles, Dan Hamill, and Tom Brauer. Documentation and testing were completed by Mike Bartles, Dan Hamill, Paul Ely, and Tom Brauer.

Transform Method Global Editor Improvements

Individual Clark Unit Hydrograph and User-Specified S-Graph sub-methods may now be selected from both the Transform Global Editor and Change Method Global Editor. Previously, these selections had to be made one at a time for each subbasin element via the component editor.

This feature was funded by Maricopa County. Initial code implementation and documentation were completed by Natasha Sokolovskaya. Review and Testing were completed by Tom Brauer and Josh Willis.

Generalized Interoperability of Meteorologic and Basin Model Methods

In previous versions, a very limited number of lumped Meteorologic methods were allowed to be used with gridded Basin methods. For example, the Specified Hyetograph precipitation method was allowed to work with the ModClark transform method. However, other lumped meteorologic methods, like the Frequency Storm meteorologic method, was not allowed to be used with any gridded basin method. Now, nearly all Meteorologic methods are allowed to be used with nearly all Basin methods. Specific combinations of methods that are now allowed for use include (but aren't limited to):

• HMR52 Storm (meteorologic) and ModClark transform (basin)
• Frequency Storm (meteorologic) and Gridded Temperature Index snow (basin)
• Specified Thermograph (meteorologic) and Gridded Energy Budget snow (basin).

This feature was funded by the HH&C Science and Engineering Technology (SET) program. Initial code implementation was completed by Paul Ely. Testing was completed by Mike Bartles, Daniel Black, Avital Breverman, Lauren Coe, Melissa Mika, Natasha Sokolovskaya, and Josh Willis. Review was done by Tom Brauer. 

Snow Covered Area Time Series

A new Snow Covered Area time series was added to the list of results that are available when one or more subbasin elements utilize a valid snow method. This time series represents the portion (in percent) of each subbasin element(s) that is covered by a snow depth greater than 0. This time series can be accessed via the Results menu. An example of the new time series is shown in the following figure:

This feature was funded by the USACE Arid Regions R&D work unit. Initial code implementation was completed by Mike Bartles. Documentation and testing were completed by Mike Bartles and Tom Brauer.

Double-click for Tabular Cell Edit

When editing a data entry table, a double-click is now required to begin cell editing. In previous versions only a single-click was required to begin editing for cells that used a combo box or spinner box cell editor. This change in behavior was made to facilitate multiple cell selection with the mouse. In previous versions keyboard combinations had to be used to select multiple cells, e.g. Ctrl + Shift + Down and Ctrl + Shift + End.

This feature was funded by the HH&C Science and Engineering Technology (SET) program. Initial code implementation was completed by Tom Brauer. Testing and review were completed by Mike Bartles and Natasha Sokolovskaya.

ModClark Transform Variable Parameter Method

Variable Time of Concentration (Tc) and Watershed Storage Coefficient (R) relationships can now be utilized within the ModClark transform method. The Component Editor, when using the Variable Parameter method, is shown below.

This feature was funded by the FEMA Future of Flood Risk Data initiative. Initial code implementation for this feature was completed by Paul Ely. Documentation was completed by Mike Bartles. Testing and review were completed by Greg Karlovits and Tom Brauer.

Additional discussion regarding this method, including means by which Variable Tc and R relationships can be estimated for ungaged locations in California, can be found here: Bartles and Meyersohn (2023). A tutorial demonstrating the usage of Variable Tc and R relationships can be found here: Applying the Variable Clark Unit Hydrograph Method.

2D Diffusion Wave Transform Enhancements

Both the HEC-RAS and HEC-HMS teams make continual improvements to the shared 2D Solver, and this release contains the latest rollup of fixes and improvements. These changes were made to improve computational speed, stability, and accuracy of the 2D results. As such, you may notice subtle changes in hydraulic results, most notably to stage hydrographs. Please see the latest HEC-RAS v6.5 release notes for further details.

Initial code implementation and documentation for this feature were performed by Alejandro Sanchez, Nick Van, and Mike Bartles. Testing was completed by Nick Van and Mike Bartles.

These changes to the shared 2D Solver may lead to subtle changes in computed hydraulic results (most notably to stage hydrographs) when compared to previous versions.

Paste from Clipboard

Additional capability has been added to support paste from clipboard. Based on the program setting for decimal separator, HEC-HMS will attempt to remove non-decimal separator characters from the pasted string. For example:

• If the decimal separator is set to period "1,234.56" would become "1234.56" after pasting
• If the decimal separator is set to comma "1.234,56" would become "1234,56" after pasting
• If the decimal separator is set to comma "1 234,56" would become "1234,56" after pasting
• If the decimal separator is set to period " 1234.56" would become "1234.56" after pasting.

This feature was funded by the HH&C Science and Engineering Technology (SET) program. Initial code implementation and documentation for this feature were performed by Tom Brauer. Testing and review were done by Melissa Mika, Natasha Sokolovskaya, and Josh Willis.

Bugs Fixed

The following bugs were present in previous versions and have been fixed within version 4.12.

Editable Combo Box for Dynamic Surface Method 

The combo box for the Dynamic Surface Global Editor was not editable by the user and the user could not switch from one method to the next. Dynamic Surface was added in v4.11. The issue has been fixed in v4.12-beta.1.

Occasional Aborted Computes when using the Energy Budget Snow Method

Simulations that used the Banded or Gridded Energy Budget Snow method would occasionally fail with a "WARNING 15303: Aborted run" message. This was only encountered when computing relatively long simulations (e.g., months to years) while also using a small results buffer length (e.g., 5000). This issue was introduced in v4.11-beta.14 and fixed in v4.12-beta.1.

Repetitive Warning Messages when using the Specified Barograph Atmospheric Pressure Method

Simulations that used the Specified Barograph Atmospheric Pressure method would produce repetitive "WARNING 12050: Unrecognized parameter in meteorologic model 'XYZ' messages". This issue was introduced in v4.11-beta.14 and fixed in v4.12-beta.1.

Incorrect Energy Budget Snow Computations during Cooling Periods following Melting

Inappropriate surface heat conduction equations were being used in the Energy Budget Snow method during cooling periods following melting when liquid water was present in the snowpack. This issue was introduced in v4.11-beta.1 and fixed in v4.12-beta.1.

This correction will change computed results during cooling periods following melting when liquid water is present in the snowpack.

Incorrect Computation of Refreezing Depth in Energy Budget Snow Method

Refreezing depth was incorrectly computed in the Energy Budget Snow method. This bug was introduced in v4.11-beta.1 and fixed in v4.12 beta.2. 

This correction will change computed results in the Energy Budget Snow method.

Changes to Hybrid Snow Parameters Not Saved

Changes to Hybrid Snow parameters were not saved if the values were within a certain tolerance. The value and precision are compared to check for parameter changes. This issue was introduced in v4.11-beta.1 and fixed in v4.12-beta.1.

Aborted Compute in Reservoir Routing using Reservoir Volume Reduction

Sediment may be deposited above the spillway crest causing the compute to abort in certain cases. Changes were made to reduce the number of cases where the routing will fail. Additional work will need to be done to distribute deposited sediment when deposition is above the spillway crest elevation.

Broad-Crested Spillway Direction Reverted to Main when Saved

When using a Broad-Crested Spillway, the program would revert the Direction to Main when the save button was pressed. Users were unable to set a Broad-Crested Spillway as an auxiliary spillway. This issue was introduced in v4.11-beta.8 and fixed in the final release of v4.12.

MSDPM Debris Yield Produces Zero Sediment

Total precipitation for a debris yield event was set to zero preventing MSDPM from computing sediment yield. This error was introduced in v4.11- beta 14 and fixed in v4.12-beta 1.

Wrong Precipitation Units in Debris Yield Methods

If the meteorology model used US Customary units, the precipitation values passed to the debris yield methods were not correct. This was fixed in v4.12-beta 1.

Calculated debris yield was incorrect for any simulation using a meteorology model with US Customary units.

Pool Storage Below Lowest Value in Elevation-Storage Table

When using Rule-Based Operations routing, if the lowest elevation in an Elevation-Discharge table for a General Outlet is below the lowest elevation in the Elevation-Storage table an error may occur during the routing calculations. HMS was modified to require that the lowest elevation in an Elevation-Discharge table is not below the lowest elevation in the Elevation-Storage table. This requirement was added in v4.12-beta 1.

GIS | Compute | Create Grid Cell File Failed to Create a *.mod File

The GIS | Compute | Create Grid Cell File option fails to create a mod file. At the conclusion of the Create Grid Cell File wizard, the dialog closes and no mod file is created. This issue was introduced in v4.11 as part of a UI enhancement and fixed in v4.12-beta.1.

Errors When Importing a 2D Mesh Created in HEC-RAS v6.3.1

When importing 2D meshes created in HEC-RAS v6.3.1 (and newer versions), an "Error 17958: Unknown member name in compound dataset: 'Composite LC'" was thrown. This has been rectified such that 2D meshes containing a "Composite LC" attribute no longer cause errors when importing. This issue was introduced with the release of HEC-RAS v6.3.1 and fixed in HEC-HMS v4.12-beta.1.

Unspecified Error when Trying to Copy Subbasin with 2D Wave Transform

Subbasin with 2D Diffusion Wave transform should not be copied. Error message was added to prevent copying such subbasin to a clipboard.

Subbasin Characteristics Compute Failure with Undefined No-Data Value in Terrain Raster

When a basin model's linked terrain file contained an undefined no-data value, subbasin characteristics computations failed. This issue was likely introduced with the release of v4.7 and fixed in v4.12-beta.1.

Expression Calculator Compute Failure with Reach Characteristics

The expression calculator failed to compute a value when the expression was composed of reach characteristics. This issue was introduced in v4.10 and fixed in v4.12-beta.1.

HEC-HMS.cmd Launcher Failed to Launch with a Space in the Path

HEC-HMS.cmd failed to launch when the HEC-HMS distribution package was placed in a path that included spaces. This issue was introduced in v4.11 and fixed in v4.12-beta.1.

Gridded Precipitation Records Not Found when using more than One HEC-MetVue Alternative in an HEC-RTS/CAVI Forecast

When more than one HEC-MetVue alternative was used within a forecast created through HEC-RTS/CAVI, gridded precipitation records could not be found for the 2nd and all subsequent HEC-HMS alternatives. This issue was introduced in v4.9 and fixed in v4.12-beta.1.

Missing Spatial Results Records when Exported to DSS, GeoTIFF, or ASCII

When spatial results were exported to disk as either DSS, GeoTIFF, or ASCII grids, records would occasionally be missing. This issue was introduced in v4.11 and fixed in v4.12-beta.1.

Combined Inflows for Elements with no Upstream Connections

For most elements, combined inflows remained in the results tab when all upstream connections for the element had been removed. This issue was introduced prior to v4.4 and fixed in v4.12-beta.1.

Occasional Erroneous Air Temperature Spatial Results

Occasionally, erroneous air temperature spatial results were written to the HDF output file when using the Gridded Temperature Index, Gridded Hybrid, or Gridded Energy Budget snow methods. This issue was introduced in v4.11 and fixed in v4.12-beta.2.

X/Y Coordinate Units System for Gridded Precipitation Transposition

HEC-HMS v4.11 introduced gridded precipitation transposition. User-specified coordinates are provided that determine the transposition distances in both the X and Y directions. In v4.11 the X/Y coordinates were assumed to be in the projected units of the gridded precipitation data, regardless of the unit system of the meteorologic model, basin model, or the projected map units of the basin model. This assumption caused issues in the meteorologic model framework, most notably when viewing results or when changing the unit system of the meteorologic model. As of v4.12 the X/Y coordinates are assumed to be in the unit system of the meteorologic model, i.e., if the meteorologic model uses the Metric unit system, the X/Y coordinates should be specified in meters and if the meteorologic model uses the U.S. Customary unit system, the coordinates should be specified in feet, regardless of the projected units of the gridded precipitation data, the unit system of the basin model, or the projected map units of the basin model.

This modification will cause computed results to change for any case where the unit system of the projected units of the gridded precipitation data differed from the unit system of the meteorologic model. Users of the gridded precipitation transposition option in v4.11 should inspect their project to see if this condition exists when updating to v4.12. The migration path is to manually convert coordinate values from meters to feet or vice versa.

Sediment Compute Error when Direct Runoff Time-series is Unselected

Previously, when sediment is enabled within a basin model and the direct runoff time-series output was deselected from the simulation output control dialog, the simulation was aborted during compute with no meaningful error given. Now, if sediment is enabled, the direct runoff time-series becomes a required time-series and is unable to be deselected by the user. This issue was introduced in a previous release version and fixed in v4.12-beta.2.

Unavailable Sediment Time-Series Results not Greyed out in ResultsTree

Logic was previously added to HEC-HMS that greyed out time-series results nodes located in the results tree. However, this logic was not added for sediment results. Now, sediment time-series results nodes are correctly shown in a lighter grey font when they are unavailable for viewing. This issue was introduced in a previous release version and fixed in v4.12-beta.2.

Projects with many External Time-Series Gages Load Slowly

When projects contain many time series gages (e.g., > 100), the linked external HEC-DSS files which contained the time series were repeatedly queried to build a catalog of the records contained in each file. This issue is now rectified by using a cache of DSS catalogs.

This fix will result in drastically shortened project load times when using many external time series gages.

This issue was likely introduced in a previous release version and fixed in v4.12-beta.3.

Export INST-VAL Spatial Results for a Single Time Step

In v4.11, when exporting a single time step of INST-VAL spatial results (e.g., snow water equivalent) to HEC-DSS, GeoTIFF, or ASCII, no file would be generated. This issue is now fixed and spatial results will be exported for the correct time step. This issue was introduced in v4.11 and fixed in v4.12-beta.3.

Account for Undefined Sediment Grain Size Distributions

In v4.11, when computing sediment/erosion, an exception could be triggered if an undefined grain size distribution was encountered. The issue is now fixed and both total sediment load and total sediment volume will be correctly written to disk. Grade loads are properly ignored in this scenario. The issue was introduced in v4.11 and fixed in v4.12-beta.3.

Interpolated Precipitation for Lumped Subbasins is Zero or Undefined when Recomputed 

Precipitation was initially interpolated for a lumped subbasin, but precipitation was zero or undefined in subsequent runs. This issue was fixed in v4.12-beta.4.

None Discretization Incorrectly Reported as Invalid

In a compute where the basin model has both gridded and non-gridded methods and the meteorologic model has exclusively non-gridded methods, an error message 48000 could incorrectly be thrown indicating that the discretization file doesn't exist for the non-gridded subbasin. This was introduced in v4.7 and fixed in v4.12-beta.4.

Adding a precipitation gage to a project is automatically added to existing inverse distance met models

In previous versions, the action of adding a precipitation gage to an HEC-HMS project would automatically add the gage to any existing inverse distance meteorologic models in the project. The default behavior has now been changed so that the user has to explicitly toggle any added gages from "No" to "Yes" within the inverse distance component editor "Use Gage" column for them to be included. This default behavior was changed in v4.12-beta.4.

Add ATI-Meltrate coefficient to Paired Data Snowmelt selection

The ATI-Meltrate coefficient was not a selectable parameter for the Paired Data Parameter Value table and now is available. This issue was fixed within v4.12 beta.4.

Inconsistent saving and displaying output results for Uncertainty Analysis

When closing an HMS project that uses the Uncertainty Analysis compute with any timeseries results saved, after reopening the project and rerunning, the timeseries results are removed. This issue is now resolved in v4.12 beta.4.

Debris flow produces zero sediment when using ModClark transform

HMS was not finding the precipitation time-series for a subbasin using ModClark transform when searching for debris flow events. This was fixed in v4.12-beta.4.

Failure for Watershed Explorer to refresh after new Paired Data added

If Paired Data did not previously exist in a project, the Watershed Explorer would fail to refresh after added new Paired Data to the project. The Paired Data would display in the Watershed Explorer after closing and re-opening the project in HEC-HMS. This issue was introduced in v4.10 and fixed in v4.12-beta.4.

Empty Groundmelt Rate column in Global Editor

The Groundmelt Rate column in the Global Editor was not displaying the stored value upon first open of the Global Editor or when values were first entered into the Global editor. The issue was introduced in v4.12-beta 3 and fixed within v4.12-beta 5.

Incorrect unit system when using energy grids

When using grids to initialize the snowpack energy content state variable within the Energy Balance snow method, the correct unit system was not being recognized. This issue was introduced in v4.11 and fixed within v4.12-beta.5.

Enable first value fill in File References table

The Global File References table was added in v4.9. When initially implemented, the table did not allow tabular fill using the Repeat first value table fill option from the right-click Fill menu. The table functionality has been updated so that repeat first value fill is now enabled.

Right-click fill option does not work for table cells with spinner box

In tabular editors, the right-click fill, repeat first value option did not work in table cells that used a spinner box editor. This issue was introduced in v4.7 and fixed in v4.12-beta.5

Missing flow when forecast time is at beginning of simulation

If the forecast time is the same as the simulation start time, the initial outflow was undefined resulting in erroneous values in the outflow time series. This issue was fixed in v4.12-beta.5.

Undefined error when deleting a basin from met model manager

Removed undefined error message when a basin that is a part of a meteorological model is deleted in v.4.12-beta.5.

Missing precipitation time-series results after computing a depth-area or frequency analysis

Fixed an error where precipitation time-series results nodes were greyed out (missing) after computing a depth-area analysis or a frequency analysis. This only occurred for gridded subbasin elements. This issue was introduced in v4.11 and fixed within v4.12-beta.5.

• https://discourse.hecdev.net/t/hms-4-11-frequency-analysis-not-showing-precip/3201

Optimization of Hybrid Snow Parameters Fails

There were two issues with optimization of Hybrid Snow parameters. First, the optimizer could not find the temperature grids. Second, the optimization would stop after one iteration and the parameters were the same as the initial values. These issues were fixed in v4.12-beta.6.

Unable to save manual time-series data and paired data when using comma separator

Manually entered time-series data would revert to missing when using comma as the decimal separator. This issue was introduced in v4.10 and fixed in v.4.12-beta.6.

Simulation compute error with Depth-Area Analysis and Constant Monthly baseflow

In previous versions, an ERROR 10000 would occur when computing a Depth-Area Analysis tied to a basin model that used the Constant Monthly baseflow method. A fix was made to allow the simulation to successfully compute to completion. This issue was introduced in v4.10 or prior and was fixed in v4.12-beta.6.

Incorrect domain for HRRR dataset in Automated Forecast

The domain specification for the HRRR data source was incorrect and allowed the HRRR data source to be selected for areas outside of the HRRR domain in some cases. This issue has been present since the initial implementation of the Automated Forecast in v4.9 and has been fixed in v4.12-beta.6.

Automated Forecast failure when empty dataset is encountered

When a dataset was retrieved that included no valid data the Automated Forecast would fail abruptly after retrieving the data. This is a previously unencountered condition that showed up in RTMA precipitation data. The code has been modified to proceed without the missing data. This issue has been present since the initial implementation of the Automated Forecast in v4.9 and has been fixed in v4.12-beta.6.

Generic Error in Uncertainty Parameter when Renaming Paired Data

Renaming paired data sometimes caused a generic error (ERROR 10000) in models that also had an uncertainty compute. The error has been present since 4.11 and was fixed in 4.12-beta.6.

User adjustments to the Hypothetical Storm Area-Dependent Pattern table were not tracked

When the user adjusted entries to the Hypothetical Storm Area-Dependent Pattern table by modifying either the area column or the pattern column, the changes were not tracked by the meteorologic model. During a regular, unforced simulation compute, any open results plots or tables would not correctly update based on the new user entries. This issue has likely been present since the initial implementation of the Hypothetical Storm Area-Dependent Pattern option in v4.4.0 and has been fixed in v4.12-beta.6.

Changes to the snow method were not being updated in the Uncertainty Analysis parameter options

Switching between lumped and gridded snow methods occasionally caused errors in models that also had an uncertainty compute. This issue was fixed in 4.12-beta.6.

Closing and Reopening HEC-HMS User Interface in CAVI/HEC-WAT Results in Incorrect Behavior

In previous versions, when the HEC-HMS user interface was opened and then subsequently closed through CAVI/HEC-WAT, incorrect behaviors were exhibited. These behaviors included the inability to display results from the map, interactively select/edit elements through the Edit menu, and reopen the currently selected Basin Model, amongst others. This issue has been rectified and the user interface behaves as expected when closing and reopening HEC-HMS. This issue was fixed in v4.12 beta.6.

Gridded storm optimization results mismatch with objective and variable evaluation values

For gridded storm optimization with an Optimization Trial compute, objective evaluation values (i.e. peak flow) and variable evaluation values (i.e. x and y locations) were sometimes written to DSS at incorrect indices causing a mismatch between storm location and peak flow results for an evaluation. This error was introduced in v4.11 and fixed in v4.12 beta.6.

Ensemble compute stalls after deletion or rename of a basin element

In v4.11, if a given time-series was selected in the ensemble analysis output control dialog and then the corresponding element was deleted or renamed in the basin model, any subsequent computes of the ensemble analysis could stall. Now, if a basin model element is deleted or renamed and it is tied to an ensemble analysis, any related and previously selected time-series results in the ensemble analysis output control dialog are automatically removed. This compute error was introduced in v4.11 and fixed in v4.12 beta.6.

Unable to edit the members of a copied ensemble analysis

In v4.11, if an ensemble analysis was copied, any subsequent changes to the ensemble members (i.e. addition or removal) of the copied analysis would not properly save in some scenarios. This error was introduced in v4.11 and fixed in v4.12 beta.6.

Copying snowmelt state initialization grids returns error

Copying snowmelt state initialization grids returns ERROR 10000. The issue was introduced in v4.12-beta 3 and fixed within v4.12-beta 6.

Reservoir Editor Panel not refreshing

In v4.11, the Reservoir Editor Panel was not refreshing when a new routing method was selected from the drop down. The user had to click away from the reservoir element and then re-select it in order for the panel to update. The error was introduced in v4.11 and fixed in v4.12 beta 6.

Time Series Table not displayed when observed flow data is missing

There was an error that caused the Time Series Table to not be displayed when observed flow data was missing. This was fixed in v4.12 beta 6. 

Forecast fails when computing a second forecast in the CAVI

After computing a forecast, a second forecast would abort because the grid size in the second forecast was greater than the grid size used in the first forecast. The grid source location is compared with the gid in memory, and the grid size is reset if the locations are not the same. Fixed in v4.12 beta 6.

Forecast compute time increases after multiple computes in CAVI

When making multiple computes of a forecast from the CAVI the compute time would increase with each compute. The number of messages sent back to the CAVI during a forecast compute was increasing with each compute. The number of messages was reduced to one for each compute step. Fixed in v4.12 beta 6.

CAVI skips HMS forecast compute after HMS parameters are modified

HMS was not keeping track of when some forecast parameter adjustments had been modified. The code was updated so HMS keeps track of when a parameter adjustment is made. Also, the forecast alternative was modified to check if the basin model had been modified since the last compute. Fixed in v4.12 beta 6.

HMS Failed to copy DSS data when creating forecast in CAVI

HMS would not copy DSS data from the base directory to the forecast directory. This was fixed in v4.12 beta 6.

Negative and Undefined Precipitation Values in Spatial Results

When a gridded precipitation data set with negative or undefined values was applied to a Basin Model, inconsistent spatial and time series results were produced. In particular, the negative or undefined precipitation values were present in the spatial results (e.g. Incremental Precipitation and Cumulative Precipitation) but were filtered from the time series results. Negative and undefined precipitation values are now filtered from the computations and results and a warning alerting the user is displayed in the Message Log. This issue was introduced in v4.7 and fixed in v4.12 beta 6.

Deletion of a basin model tied to an Ensemble Analysis could cause user interface errors

In some cases, the deletion of a basin model could incorrectly cause the "Analysis Type" selectable options in the ensemble analysis editor panel to be blank. This could, in turn, cause the ensemble members table to be blank. These issues were introduced in v4.11 and fixed in v4.12 beta 6.

Integer parameter types reported as floating point in univariate searcher results

In the univariate search method of the Optimization Trial, integer parameters, i.e. number of reservoirs, were incorrectly reported as floating point values in the optimization trial results. It is unknown when this issue was introduced. This issue was fixed in the final release of v4.12.

Surface ET is now allowed to occur during periods of rainfall

Previously, surface evapotranspiration was not allowed to occur during periods of rainfall even if the "Wet and Dry Periods" option was selected in the canopy method. Surface evapotranspiration is now allowed to occur during periods of rainfall starting in v4.12.

This modification will cause computed results to slightly change when compared to previous versions IF a surface method is used in conjunction with a canopy method and the "Wet and Dry Periods" option is selected.

Plot not updating when simulation computes with different parameter values

Plots were not updating for simulations using interpolated air temperature and a fixed lapse rate. This issue was fixed in the final release of v4.12.

Using a lumped subbasin with gridded meteorologic methods caused errors

When a compute was attempted that used at least one lumped subbasin and the Gridded Dew Point, Gridded Humidity, Gridded Pressure, Gridded Longwave, and/or Gridded Windspeed meteorologic methods, an error was thrown. This issue was introduced in v4.11 and fixed in the final release of v4.12.

Missing values sometimes present in spatial results exports

Certain basin model configurations, such as having a mixture of lumped and gridded subbasins, would sometimes result in missing values when exporting spatial results. This issue was introduced in v4.10 and fixed in the final release of v4.12.

Gridded Penman Monteith errors when using a simulation time step longer than 1 hour

The Gridded Penman Monteith method would result in erroneous evapotranspiration values when a simulation time step longer than 1 hour was used. This issue was fixed in the final release of v4.12.

Gage temperature at a daily time step computed invalid daily average, minimum, and maximum values

The gage temperature method computed invalid daily average, minimum, and maximum values when the time step of the data was daily. This issue was fixed in the final release of v4.12.

2D Connection flows were not always computed for the initial time step with the Diffusion Wave transform

Flows and stage were not computed for 2D Connections in the Diffusion Wave transform in certain situations (when Use Warm up Period option was set to No). This issue was fixed in the final release of v4.12.

Incorrect Subbasin Editor Panel UI render when switching between Deg/Min/Sec and Decimal Dec via Program Settings

UI failed to render correctly for the subbasin editor panel when longitude and latitude switched between Deg/Min/Sec and Decimal Dec via Program Settings. This issue was fixed in the final release of v4.12.

Incorrect Solar Radiation calculations using FAO56 Shortwave method

FAO56 shortwave radiation method was not using sunshine hours in its calculations resulting in incorrect values for solar radiation. This issue was fixed in the final release of v4.12.

This change results in significant difference in calculated solar radiation.

Change in Subbasin discretization and snow methods from the global editor was not reflected in the Subbasin Editor

Fixed in the final release of 4.12.

Hypothetical precipitation editor for Area-Dependent Pattern storm type sometimes missed area field 

Area field was not added to the hypothetical storm editor for Area-Dependent Patterns storm type if area reduction was set to None. This was present as early as 4.10 and was fixed in the final release of 4.12.

Track rename, delete, and unit system changes in the subbasin and reach characteristics

In the subbasin and reach characteristics tables that are accessed from the Parameters | Characteristics menu, fixes were made so that the tables properly track with element renames and deletions, and changes to the basin model unit system. These issues have been present since basin characteristics compute was introduced in v4.7 and fixed in the final release of v4.12.

Handle daily time step solar radiation data

If a solar radiation gage used a daily time step, daily maximum calculations were invalid. The only process known to use daily maximum solar radiation as of the v4.12 release is RTI snowmelt. This issue has been present since the introduction of RTI snowmelt in v4.11 and fixed in the final release of v4.12.

Filter non-decimal separator when pasting into a Parameter Value Sample Paired Data table

When values are copied and pasted into a paired data table, the non-decimal separator character, i.e. "." or ",", was not filtered out of the text prior to paste with the net result being that the values failed to paste. This has been present since the parameter value sample paired data type was introduced in v4.3 and fixed in the final release of v4.12.

Wind speed units conversion issue when using a gridded model

Specified Anemograph used in combination with a discretized subbasin would result in invalid wind speed data. This was fixed in the final release of 4.12.

This modification will cause computed results to slightly change when compared to previous versions if the "Specified Anemograph" wind speed method is used in conjunction with a discretized subbasin for the Penman Monteith evapotranspiration methods and for the Energy Budget snowmelt methods.

Synchronize changes between discretization component editor and global editor

When both the discretization global editor and component editor were in view, changes in the component editor did not update the global editor and vice versa. This issue has been present since discretization global editors were introduced in v4.10 and fixed in the final release of v4.12.

Manual entry time-series editor notes missing value for first period

When manually entering data for a time-series gage of period values (i.e. not instantaneous), a note was incorrectly presented indicating a missing value corresponding to the first value of the time-series, which for period data, is empty. This was fixed in the final release of v4.12.

Remove discretization when switching from Structured to None

When changing the discretization method from structured to none, then recomputing grid cells with GIS | Compute Grid Cells, the structured discretization grid cells were not cleared from the GIS database and were not cleared from the graphical representation of the discretization in the Basin Map. This issue has been present since discretizations were introduced in v4.7 and fixed in the final release of v4.12.

Handle external HEC-DSS Parameter Value Samples

For externally referenced HEC-DSS parameter value samples, read units from the HEC-DSS record. Allow HEC-DSS pathnames with blank A, B, and F parts. This issue was introduced with the parameter value sample improvements in v4.12 and fixed in the final release of v4.12.

For gage meteorology treat "--None--" gage selection as no gage selected

For gage meteorologic methods, if gage selection was --None-- this was treated as a gage named "--None--" rather than no gage selected. This resulted in incorrect error messages at simulation time. This issue was introduced in v4.10 and fixed in the final release of v4.12.

Interpolated meteorology data for lumped subbasins is undefined when recomputed

Interpolated temperature, pressure, dew point, humidity, radiation, or wind speed is undefined when a simulation is recomputed. Undefined values for most of these will cause the simulation to stop. This error was fixed in the final release of v4.12.

Ignore data quality when computing observed flow

If observed time-series data included data quality flags indicating missing data the observed time-series would not interpolate between missing values and would include missing values. A change in behavior was made to ignore data quality flags when computing the interpolated observed time-series. This issue was fixed in the final release of v4.12.

Handle comma decimal separator in Parameter Value Samples data entry

If the decimal separator program setting was set to comma numeric input for parameter value samples would not save. This issue was introduced in v4.11 and fixed in the final release of v4.12.

Fix Error 10000 when saving Subbasin Editor Panel with 2D Diffusion Wave transform selected

Saving Subbasin Editor Panel with 2D Diffusion Wave transform option sometimes lead to unspecified errors. This was introduced in v4.11 and fixed in the final release of 4.12 by adding checks and error messages at runtime.

Allow File Specified Discretization to work with 2D Diffusion Wave transform

Previously File Specified Discretization would not work with 2D Diffusion Wave transform. This has been corrected and a user-specified *.hdf referenced in File Specified Discretization Panel will now function with 2D Diffusion wave, although the preferred method is still importing a HEC-RAS HDF file vie the File | Import menu. This was fixed in the final release of 4.12.

Beta Releases

The following table presents features that were added and bugs that were fixed within each beta release. Only bugs that were introduced and fixed during the v4.12 development cycle are listed here.