Introduction

Version 2.0.2 of the Hydrologic Engineering Center's Flood Damage Reduced Analysis (HEC-FDA) software is released. This version supersedes previous software versions. Version 2.0.2 is an intermediate release that includes critical patches to keep teams working while the HEC-FDA team prepares for the Version 2.1.0 release.

Resolved Issues

Issue

Description

Geospatial

Shapefile reading is now more robust to out-of-spec shapefiles. Prior versions of HEC-FDA erroneously processed geospatial data resulting in incorrect decimal values for structure values or "EMPTY" occupancy types.
Many datasets relying on .tif data were failing sample elevations correctly. This showed up in the form of structure inventory depths of entirely no-data values. Gridded data is now handle appropriately.
Geospatial libraries have been updated to the latest published RAS-2025 packages. This is largely invisible to users, but as HEC-FDA continues to mature, this will lead us to greater stability, better error messaging, and sets us up for future feature development.

UI Bug Fixes

Projections are no longer being archived and unset if the user saves properties after the initial specification.
Thresholds entered in the Scenario Editor now has a "set" button that ensures user input is maintained when switching between the tabs of different specific IASs. The SET button does not replace the need to click SAVE when finished editing your scenario. Your changes will not persist to the compute, or between opening or closing the study without clicking save. Previous behavior would revert changes if focus did not leave the textbox before moving to the next impact area, which caused headaches for some workflows.
Issues reported during the Alternative computes have been improved. Previous behavior would throw an exception when doing a batch compute with user error causing an invalid alternative definition such as an invalid discount rate or the specification of a most likely future year outside the period of analysis (the 51st year seems to be a common invalid choice) The software now gives users more detailed and useful information.
Copying data out of an FDA study and pasting into Excel is repaired. However, copying and pasting can only be completed by right-clicking at this time. In other words, the CTRL + C shortcut remains inoperable.

Differences in Results

The HEC-FDA team has completed a full round of testing to confirm that no changes in results between software versions are expected with this release. There are no changes to the computational algorithm and the team has confirmed that updated geospatial processing dependencies produce identical results as prior dependency versions.

Known Issues

Several known issues remain in the HEC-FDA software program. Several of the below issues are targeted for resolution in upcoming Version 2.1.

This table organizes known issues that are immediately relevant for HEC-FDA users with suggested workarounds and important limitations. The authoritative source of known issues can be found on GitHub.

Issue Title	Description	Workaround	Status	GitHub Issue
Structure distribution count incorrect for single structure damage pool	The distribution of the quantity of structures damaged by stage is provided among the stage-damage details written to file. This report works ineffectively where the damage pool includes just one structure. The cause is the ineffective way that the statistical tool (histogram) operates for single-valued distributions.	Do not refer to the distribution of structures damaged when there is just one structure being damaged.	Current in Version 2.0.0 through 2.0.2	Issue 1150
Graphical Uncertainty Incorrect for Edge Cases	HEC-FDA Version 2.0 has a bug that incorrectly interpolates graphical frequency and incorrectly forces monotonicity of graphical uncertainty for edge cases of user provided graphical curves. Curves that appear to be affected are those with many strong changes in shape as exceedance probability decreases.	No workaround is available at this time. The team is hustling to deliver a fix.	Current in Version 2.0.0 through 2.0.2	Issue 1214
Content value from CSVR does not show up in structure detail file.	The structure stage-damage details file provides information about each structure in the inventory, the stages sampled from the hydraulics model, and the corresponding level of damage. Among the structure information provided is content value, but content value only shows up if the structure has a content value in the inventory, the content value will not be reported if being estimated with a content-to-structure value ratio.	Refer to the occupancy type data set to estimate content value for each structure.	Current in Version 2.0.0 through 2.0.2	Issue 1111
Damage Computed Incorrectly for Vehicle as Part of Structure	When computing vehicle damage, if vehicle value is imported into HEC-FDA as part of a structure point instead of its own point, then the depth of inundation to which the vehicle is exposed is incorrectly calculated because the depth of inundation applied is depth above the structure's first floor elevation.	Import vehicles as separate points in the structure inventory and assign foundation height of zero so that the depth of flooding used in the calculation of percent damage is correctly calculated to be the depth of flooding above ground.	Current in Version 2.0.0 through 2.0.2	Issue 1255
Damage Fails to Compute for Inventories Imported with FFE and no Beginning Damage Depth	New in HEC-FDA is an updated aggregated stage-damage methodology that attempts to prevent damage from being calculated if the computed water surface elevation is below the ground elevation when no beginning damage depth is identified (otherwise beginning damage depth rules). This methodology essentially uses ground elevation as beginning damage depth by setting beginning damage depth to the negative of foundation height. This methodology does not work well when the inventory is imported with first floor elevation.	Either import the structure inventory using ground elevation and foundation height (and optionally beginning damage depth, especially when importing structures with basements) or using first floor elevation and be sure to assign beginning damage depth.	Current in Version 2.0.0 through 2.0.2	Issue 1239
Triangular CSVR and OSVR Import Incorrectly	Triangular content- and other-to-structure value ratios tab-delimited import works incorrectly. The tab delimited parameters are specified in the format preferred by Version 1.4.3, as percent increments and is transformed into the logical format used in Version 2, which consists of the true min, most likely, and max. See Differences Between Version 1.4.3 and Version 2.x for more information about this change. The transformation from the old format to the new format is not working correctly.	Specify the min, most likely, and max for CSVRs and OSVRs using the user interface rather than the tab delimited import process.	Current in Version 2.0.0 through 2.0.2	Pull Request 1228
Total Risk Scenarios can save to Database Incorrectly	When computing Scenarios in HEC-FDA with total risk, the software can save the incorrect levee identifications to the database, resulting in an incorrect compute. If you have a dataset that experiences this, contact the HEC-FDA team, as this issue is difficult to reproduce.	Switch between saved levee selections, and confirm using an SQL browser that the levee IDs (different from levee names) saved to the database match the levees you selected. You’ll review the impact_area_scenarios SQL table, and review the SQL entries. HEC-FDA uses internal IDs to track impact areas, summary relationships, levees, etc. Confirm that the levee IDs saved to the SQL database match your intended levees.	Current in Version 2.0.0 through 2.0.2	Issue 1252
Flow-frequency plot in preview editor inverted	The flow-frequency function plotted as part of a Scenarios preview compute is inverted.	No workaround is available at this time. Examine the flow-frequency editor to visualize the flow-frequency data.	Current in Version 2.0.0 through 2.0.2	Issue 1208

This table organizes those resolved issues which were previously reported in the above table.

Issue Title

Description

Workaround

Status

GitHub Issue

Price Index Broken

The price index found under study properties is used to update the inventoried structure, content, vehicle, and other values in the structure inventory from historical price levels to current price levels. The price index does not currently update values and should not be used.

Update structure, content, vehicle, and other values in the structure inventory prior to importing the inventory point shapefile. Attribute fields can be updated using field calculators in your preferred GIS software.

Resolved in Version 2.0.1

Issue 1198

Version 2.0.1 has Empty Damage Categories in Stage-Damage Compute

HEC-FDA Version 2.0.1 has a bug that came from an update to the HEC-RAS dependency for reading geospatial data sets.

The bug prevents the user from successfully computing aggregated stage-damage functions. Damage categories show up as empty and stage-damage shows zero damage.

The workaround is to use HEC-FDA Version 2.0.0 to compute stage-damage. Open the study in 2.0.0, delete and re-import the structure inventory, then re-run stage-damage compute. Version 2.0.0 is still available in a portable build from the HEC website: https://www.hec.usace.army.mil/software/hec-fda/downloads/HEC-FDA_20_Portable.zip

Resolved in Version 2.0.2

Issue 1224

Download

A zipped package of a portable build of the latest version of HEC-FDA can be downloaded from the HEC website. Download the portable package to a location where you have write access, such as C:\Programs and extract the contents of the zip file. Open the HEC-FDA 2.0 folder that contains the extracted contents to find the .exe application HEC.FDA.View with the green house icon. Double-click on HEC.FDA.View to launch the software.

Support Policy

The HEC support policy can be viewed on the HEC website. We encourage users of HEC-FDA to use HEC-FDA Discourse for bug reports and technical questions.