Welcome to the HEC-FDA Version 2.0 Quick Start Guide. This document is written for users who have previous experience using the HEC-FDA software or have experience working with hydrologic, hydraulic, and economic data. Specifically, this document walks users through the data requirements and workflow involved in converting an HEC-FDA Version 1.4.3 study into an HEC-FDA Version 2.0 study.  Review the HEC-FDA User Manual for more information. The HEC-FDA tutorial on Version 1.4.3 to Version 2.0 Study Conversion contains a more detailed demonstration of the workflow provided in this quick start guide.In the conversion tutorial, we use a different data set than the data set that is used for the Create New Study from Scratch quick start guide.

Heads up: transitioning from decades-old technology straight to brand-new technology can be clunky. As an example, consider what it would take to upload the data on a floppy disk to the cloud. Compared to that, this workflow is a breeze! 

Study Conversion Data Requirements  

The following data can be exported from HEC-FDA Version 1.4.3 as a tab-delimited text file for direct import into HEC-FDA Version 2.0:

  • Damage Categories
  • Occupancy Types
  • Frequency Functions
  • Regulated-Unregulated Functions
  • Stage-Discharge Functions
  • Levee Data
  • Aggregated Stage-Damage Functions (you need to manually set the export parameter in the database to 1, navigate here to see how)

Read about what 1.4.3 study data cannot be converted into 2.0 study data and why, in the section below on Inconvertible Study Data. 

Helpful Hints About Working With Study Data in 2.0

Tips and Tricks

  • Keep track of the units of measurement. Units of measurement will not be tracked nor handled within HEC-FDA Version 2.0. For example, if terrain elevation is measured in meters but the first floor elevation is measured in feet, HEC-FDA will not know about the discrepancy - this will have to be handled outside of HEC-FDA. 
  • Generally, there are five distributional assumptions available for input relationships and uncertainty parameters: normal, log normal, triangular, uniform, and deterministic (no uncertainty). These distributions are specified in their usual way. 

Study Conversion Workflow

First: Export from 1.4.3 and Import into 2.0 

  1. Create a new study by importing an a tab-delimited file with the above listed study data that was exported from HEC-FDA Version 1.4.3
  2. Import impact area set
  3. Import stage-damage functions 

  A set of impact areas in the form of a polygon shapefile must be developed. The file must have a string or integer field that identifies a unique name. Only one set of impact areas can be imported. 

Alternatively, create a new study the usual way (see Create New Study from Scratch for instructions) and import the study data element by element (e.g., import all frequency curves, then import all rating curves). You can have all exported 1.4.3 study data in a single tab-delimited text file - the import procedure only imports the data requested. 

Take a look at the following video to learn about creating a new study from Version 1.4.3 data. 

Second: Specify and Compute Scenarios

Specify a Scenario for each project condition-analysis year combination. Review the Specify and Compute Scenarios section of the Create New Study from Scratch guide for more information.

The following must be selected for each impact area for a given Scenario:

  1. Discharge-frequency function
  2. Stage-discharge function 
  3. Stage-frequency function if not able to use discharge-frequency function and stage-discharge function 
  4. Set of stage-damage functions, one for each damage category - asset category combination 

The following may optionally be selected for each impact area for inclusion in a given Scenario:

  1. Regulated-unregulated flow transform function
  2. Interior-exterior stage transform function 
  3. Levee elevation, system response curve optionally 
  4. Additional thresholds 

After completing the selections for each impact area, hit save, and right-click on the scenario and hit compute. When the compute is complete, a message will be displayed prompting whether to display results. 

Third: Specify Alternatives and an Alternative Comparison Report

  1. Specify Alternatives. An alternative should represent a given project condition and should include one Scenario for each analysis year. Right-click on the Alternative and hit view results. 
  2. Specify the Alternative Comparison Report by identifying the without-project condition and each with-project condition for comparison. Right-click on the alternative comparison report and hit view results.

Review the  for more information regarding alternatives and alternative comparison reports

Inconvertible Study Data

The following items can not be converted from 1.4.3 study data into 2.0 study data:

  1. Price index information
  2. Plans
  3. Years
  4. Streams
  5. Damage reaches
  6. Damage categories
  7. Structure modules
  8. Structures
  9. Water surface profiles

The above items that cannot be imported are not accommodated for one of three reasons:

  1. Data is not exported from HEC-FDA 1.4.3
  2. Study configuration is different in HEC-FDA 2.0
  3. HEC-FDA 2.0 requires spatial data sets

Related Topics

  • Page:
    Version 1.4.3 to Version 2.0 Study Conversion — This tutorial documents the steps to follow to convert an HEC-FDA Version 1.4.3 study to a Version 2.0 study. Heads up: transitioning from decades-old technology straight to brand-new technology can be clunky. As an example, consider what it would take to transfer the contacts on a Nokia flip phone to an iPhone 14. Compared to that, this workflow is a breeze!