2.0 Data Requirements for a New HEC-FDA Study

Study data requirements vary widely. The requirements depend on the purpose of the study, the size of the study area, the hydrologic and hydraulic conditions of the study area, and the types of alternative plans considered, just to name a few. In general, the data required to build a new study must contain:

  1. Impact areas in the form of a polygon shapefile. The file must have a string or integer field that identifies a unique name. Only one set of impact areas can be imported. 
  2. Analysis year(s).

Further, for a given alternative, analysis year, and impact area, a study must contain at a minimum the following data:

  1. Frequency functions - either (a) or (b) below: 
    1. Analytical flow-frequency: (1) equivalent record length, mean, standard deviation, and skew, or (2) series of peak flows. 
    2. Graphical frequency relationship: at least 8 (preferably 9) flow-frequency coordinates and equivalent record length. Stage-frequency is an option of the hydraulic conditions warrant.
  2. Stage-discharge functions consisting of flows and distributions of stages, if frequency function reflects discharge. If frequency function reflects stage, a stage-discharge function is not required.
  3. Aggregated stage-damage functions consisting of stages and distributions of damage, which can be manually entered or internally computed. 

If you're using HEC-FDA 2.0 to compute the aggregated stage-damage functions, you will also need:

  1. Terrain, for one or both of the following: (1) using HDF results for hydraulics, in which case the terrain should be in HDF format, or (2) using terrain data for ground elevation at structure, in which case the terrain can be imported as a raster data set or HDF. Only one terrain file can be imported.  
  2. Hydraulics data set should reflect water surface elevations (not depth) with three data format options: (1) steady or unsteady: 8 subdirectories with raster datasets (2) steady: 1 HDF; or (3) unsteady: 8 HDFs.
  3. Discharge-frequency function and stage-discharge function, or stage-frequency function only (same functions mentioned above). 
  4. Occupancy types with damage categories, depth-percent damage functions with uncertainty, first floor elevation uncertainty, and either: (1) structure/content/other value uncertainty, or (2) content-to-structure value ratios with uncertainty and other-to-structure value ratios with uncertainty. Content, vehicle, and other configuration is optional. 
  5. Structure inventory in the form of a point shapefile with at least a structure ID, structure value, first floor elevation (or ground elevation and foundation height) and occupancy type. Optionally: content value, other value, beginning damage depth, among others. 

Stage-Damage H&H Data

  • There are three types of engineering data required for a stage-damage compute: a frequency function, a stage-discharge function if frequency reflects flows, and a hydraulics data set. Double-check that the project conditions are the same across the three items. The computed stage-damage function will not make sense if: (1) with-project conditions are unique from without-project conditions, and (2) with-project data is used along with without-project data for the without-project set of stage damage functions. 
  • Ensure that the coordinate reference system is either set to be the same across all geospatial data sets, and/or that the study coordinate reference system is set by selecting the study projection from the study properties editor under the File menu (best practice). The coordinate reference system should match that of the hydraulics modeling.

Optional items include:

  1. Index points in the form of a point shapefile, if retrieving graphical stage-frequency from water surface elevations in hydraulics. Index points are not explicitly used for anything else within HEC-FDA, but remain an important concept. 
  2. Regulated-unregulated transform function with unregulated flows and distribution of regulated flows.
  3. Exterior-interior function with exterior stages and distributions of interior stages. 
  4. Levee (top of levee elevation) and optionally system response curve involving stages and distributions of breach probabilities.

Here's what you'll need from engineering

For each alternative-analysis year-impact area combination, you will need from engineering:

  • Frequency functions - either (1) or (2) below: 
    1. Analytical flow-frequency: equivalent record length, mean, standard deviation, and skew. 
    2. Graphical frequency relationship: at least 8 (preferably 9) flow-frequency coordinates and equivalent record length. Stage-frequency is an option of the hydraulic conditions warrant.
  • Stage-discharge functions consisting of flows and distributions of stages, if frequency function reflects discharge. If frequency function reflects stage, a stage-discharge function is not required. 

The frequency function and stage-discharge function should reflect the same place in the channel, i.e. the same index point. You will also need a data set of hydraulic modeling for each alternative-analysis year combination. The modeling should reflect water surface elevations (not depth) with three data format options: (1) steady or unsteady: 8 subdirectories with raster datasets (2) steady: 1 HDF; or (3) unsteady: 8 HDFs

Create New Study and Compute Workflow

This section walks you through creating a new study and computing all results. This section assumes that you will use HEC-FDA Version 2.0 to compute aggregated stage-damage functions. 

First: Create Study then Import or Specify Study Data

Create New Study

  1. To create a new HEC-FDA study. From the File menu, click New to open the Create New Study tab. 
    HEC-FDA main window, File menu commands. 
  2. Enter the Study Name and for the study.
  3. From the Study Path box, click the browser ellipse button to open a Select Folder browser window. Navigate to the desired location for saving the study and click, Select Folder.
  4. Entering a description is optional, but recommended for tracking important study information.
  5. Click OK to create the new study.
    Example completed Create New Study dialog

Set Study Properties

  1. Set the study properties, including the discount rate, period of analysis, and study projection. Open the Study Properties tab from the File menu.
    HEC-FDA Version 2.0, File Menu, Properties command selected.
  2. Review and update the Discounting Information, which includes the Discount Rate and Period of Analysis.

  3. Review and update the Price Information, which includes the Surveyed Year, Updated Year and Updated Price Index.
    Study Properties tab, red boxes highlight discount and price information.

  4. Click Save and Close to save the study properties and close the tab.

Import Terrain (Optional)

The terrain is used to identify the ground surface elevation across an area of interest. 

Terrain FDA icon Please note that only 1 terrain file may be imported. Import terrain as a HEC-RAS terrain. A RAS Terrain is a .hdf file paired with one or more .tif files. Select the .hdf file when importing your terrain and ensure the accompanying files are included in the same subdirectory. A terrain file is required if you're relying on hydraulic data in HDFs or if you do not have elevation data in your structure inventory (e.g., only foundation heights but no ground elevations). 

  1. Import terrain if using terrain to identify ground elevation at structures or if using hydraulics from HEC-RAS in HDF file. From the Study Tree, right-click on Terrain and select the Import Terrain command.
    Import Terrain shortcut command opened by right-clicking the Terrain study element 
  2. A name and path to the terrain file are required for import, as in the image below. Click the browser ellipse button to navigate to the appropriate file (e.g., HEC-RAS Terrain, HDF file) and click Open. Click OK to import the terrain file.
    Import Terrain tab, example completed dialog.

Import Impact Areas

The impact area (formerly known as damage reaches in HEC-FDA Version 1) is the smallest geographical unit at which we calculate risk (at which we apply the risk equation).

  1. To import impact area set, from the Study Tree, right-click on Impact Area Set and select the import command.
    Import Impact Area Set study tree shortcut command
  2. From the Import Impact Area Set dialog, enter a name and description. Click the browser ellipse button to navigate to the appropriate file and click Open to set the shapefile path. Then select the unique impact area name (a field of the attribute table). Click OK to import the dataset.

    Impact Areas FDA icon Only one set of impact areas may be imported into an HEC-FDA file. This means that all impact areas must be included in one polygon shapefile to be used in a study that contains a field for a unique impact area ID. 

    Impact Area Set importer completed for the example study.

Import Index Points (Optional)

Impact Areas FDA icon Index points are only required when imported water surface elevations in hydraulics will be used to retrieve graphical stage-frequency functions. In other words, index points are not explicitly used for anything else within HEC-FDA, but remain an important concept. Import index points in the form of a point shapefile (only one index points dataset can be imported into a study).

  1. If desired, create index points for the study. Index points should be created when retrieving graphical stage-frequency from water surface elevations in hydraulics. From the Study Tree, right-click on Index Points and select the create new command.
    Create New Index Points study tree shortcut command
  2. From the Create New Index Points dialog, enter the name and description for the data. Click the browser ellipse button to navigate to the appropriate file and click Open to set the shapefile path. Then select the unique name (a field of the attribute table). Click OK to import the dataset.
    Create New Index Points example completed

Import Hydraulic Data

Import set of eight hydraulic profiles for the without-project condition, and for each with-project condition if the hydraulics are different than the without-project condition. The hydraulics data may be one of the three below imported from grids (.tif), or hierarchical data format (.hdf).

  • Unsteady HDF
  • Steady HDF
  • Gridded Data

To import the hydraulics:

  1. From the Study Tree, right-click on desired hydraulic dataset (e.g., Steady HDF) and select the import command.
    Import Hydraulics example study tree shortcut command for the Steady HDF hydraulics data set 
  2. For a given hydraulics data set, one HDF is required for steady hydraulics modeling, eight HDFs are required for unsteady hydraulics modeling. Gridded water surface elevation data is accommodated, see Hydraulics for more information. Specify a name, description, source file (or folder for unsteady), and be sure to identify either the correct Annual Exceedance Probabilities or correct Return Intervals.

  3. For the Steady HDF example importer, entering the Return Interval values updates the annual exceedance probability value. 
  4. Users also have the option to set the study projection. Select the Set Study Projection button to open the Study Properties dialog for importing the study projection file.
    Import Hydraulics dialog, example for Steady HDF

Specify Frequency Relationships

Frequency relationships should be entered for each project condition-analysis year-impact area combination. To access the options for creating, retrieving or importing frequency functions, from the Study Tree, right-click on Frequency Functions and select the desired shortcut command.

Options for creating, retrieving or importing frequency functions.

The frequency relationships may be one of the three below.  

  1. Analytical flow-frequency function. 
  2. Graphical flow-frequency function. 
  3. Graphical stage-frequency function. 

Frequency Functions FDA icon Please see EM 1110-2-1619, HEC-FDA on Discourse, or speak with HEC about choosing one of the three. Recall that uncertainty in EAD is most sensitive to uncertainty in flow, so we want to include flow in our models if the hydrologic and hydraulic conditions permit.

Users can edit, rename or remove frequency functions. To access the options, from the Study Tree, right-click on the function (e.g., Muncie Example LP3) and select the desired command from the shortcut menu.

Frequency functions edit, remove or rename commands

Analytical Frequency Function

To create an analytical frequency function, from the Study Tree right-click on Frequency Functions and select the create new option. Enter the name for the function and a description (optional, but recommended). Select Analytical, and provide the mean, standard deviation, skew, and equivalent record length. Click Save and Close to create the new function.

Create an Analytical Frequency Function Example

To edit the created frequency function, from the Study Tree right-click on the created function and click Edit Frequency Function.

Graphical Frequency Function

To create an graphical frequency function, from the Study Tree right-click on Frequency Functions and select the create new option. Enter the name for the function and a description (optional, but recommended). Select Graphical, select either Flow or Stage. Provide at least eight coordinates of exceedance probability and flow (or stage), and an equivalent record length. Click on Compute Confidence Limits to view the 0.025 and 0.975 confidence limits. Click Save and Close to create the new function.

Graphical Frequency Function Example for Flow-frequency

To edit the created frequency function, from the Study Tree right-click on the created function and click Edit Frequency Function.

Frequency Function FDA icon Computed confidence limits are for viewing purposes only, there is no need to compute confidence limits to use the frequency function in an expected annual damage compute. The computational engine calculates the uncertainty when the entered frequency function is used in a compute. Once created, users will need to re-compute the confidence limits if opened in the Editor.

Retrieve Graphical Frequency Function

Users may retrieve graphical stage-frequency curves from the imported hydraulic data (review the Add Graphical Frequency Function section for instructions). Recall that index points must also be imported in the FDA study to use this option (review the Index Points section for import instructions). Don't forget to edit the equivalent record length for each function after generation. 

  1. To create an graphical stage-frequency function, from the Study Tree right-click on Frequency Functions and select the Retrieve Graphical Frequency Function option.
  2. Select the appropriate Hydraulic Dataset and Index Point Set to retrieve from, and click the GenerateFrequencyCurves button.
    Retrieve graphical frequency functions option requires the hydraulic dataset and index point set.
  3. The generated frequency curves are added to the Study Tree under the Frequency Functions element and is automatically named based on the name of the imported index point(s) (e.g., 3347000) and hydraulic dataset (e.g., WOP-BaseYear).
    Example retrieved graphical stage-frequency function.
  4. Provide the correct equivalent record length for each generated stage-frequency function. To edit the generated frequency function, from the Study Tree right-click on the created function and click Edit Frequency Function.

Regulated-Unregulated Relationship (Optional)

Optionally, specify regulated-unregulated transform flow relationships. Specify with a series of coordinates of unregulated flow and distribution of regulated flow.

To create a regulated-unregulated transform relationship:

  1. From the Study Tree right-click on Regulated-Unregulated Transform Functions and select the create new option.
    Regulated-Unregulated transform functions shortcut command options for creating or importing relationships.
  2. Enter the name for the function and a description (optional, but recommended). 
  3. Select the Distribution Type from the options: 
    • Deterministic
    • Uniform
    • Normal
    • Triangular (default selection)
    • LogNormal
  4. Enter the inflows and specify the distribution of outflows.
    Regulated-Unregulated Transform Flow Function
  5. Click Save and Close to create the new relationship.

Stage Transform Functions

The stage-discharge function is required unless a stage-frequency function is used as the defining frequency relationship. Exterior-interior stage-transform functions are optional.

Stage-Discharge Relationship (Conditional)

If using discharge-frequency, specify a stage-discharge relationship. You'll need to specify a stage-discharge function to accompany each flow-frequency function. Specify with a series of coordinates of flow and distribution of stage. To create a new stage-discharge relationship:

  1. From the Study Tree, under Stage Transform Functions, right-click on Stage-Discharge Functions and select the create new option. 
    Stage-Discharge Functions shortcut command options for creating or importing relationships.
  2. Enter the name for the function and a description (optional, but recommended). 
  3. Select the Distribution Type from the options: 
    • Deterministic (default selection)
    • Uniform
    • Normal
    • Triangular
    • LogNormal
  4. Enter the stage-discharge function coordinates with the specification of the distribution of stages for a given flow. Be sure to include the zero flow-invert stage coordinate.
    Stage-Discharge Relationships example displaying the Distribution Type list.
  5. Click Save and Close to create the stage transform function.

Specify Exterior-Interior Relationships (Optional)

An exterior-interior stage transform function relates the water surface elevation in the channel (exterior) to the water surface elevation in the floodplain (interior). To create an exterior-interior stage transform function:

  1. From the Study Tree, under Stage Transform Functions, right-click on Exterior-Interior Functions and select the create new option.
    Exterior-Interior functions shortcut command options for creating or importing relationships.
  2. Enter the name for the function and a description (optional, but recommended). 
  3. Select the Distribution Type from the options: 
    • Deterministic (default selection)
    • Uniform
    • Normal
    • Triangular
    • LogNormal
  4. Enter the paired data with or without uncertainty. The X Value column should have external stages and Y Value column(s) should specify the corresponding interior stage.
    Example of the Create New Exterior-Interior Relationship dialog with the Distribution Type list.
  5. Click Save and Close to create the transform function.

Lateral Structures

Optionally, specify levees with a top of levee elevation minimally. Ideally, select user-defined and enter a system response curve in stages and failure probabilities. To create new lateral structure:

  1. From the Study Tree, right-click Lateral Structures and select the create new option. 
    Lateral Structures shortcut command options for creating or importing relationships.
  2. Give the levee a useful Name and Description (optional, but recommended). 

    Lateral Structure IconLateral Structure Failure Function IconWhen naming lateral structures it is recommended to include the impact area in the name. For example, "Left-bank" is included in the name for the levee in the example below because the levee in the Example Study Data is in the left-bank impact area.

  3. Specify the Top of Levee Elevation.
  4. The System Response Curve is set to Default. Alternatively, select User Defined and enter the failure function to specify the probability of breach for each stage. 
    Create New Lateral Structure dialog with the User Defined option selected and displaying an example geotechnical failure system response curve.
  5. Click Save and Close to add the lateral structure.

Import Occupancy Types

The recommended workflow is to import occupancy types using the same flat-file format as that which was used for HEC-FDA Version 1.4.3. See Appendix D of the Version 1.4.1 User's Manual for more information. Optionally, occupancy types may be entered manually. The occupancy types editor is the most complicated editor. See the page on the HEC-FDA User Interface for more information. 

Edit Occupancy Types example Auto occupancy type selected.

Occupancy types can be imported from a text file or created within the FDA occupancy types editor. To import occupancy types from a tab-delimited text file:

  1. From the Study Tree, right-click on Occupancy Types under Economics and select the import option. To view the requirements for the tab-delimited text file review the HEC-FDA Version 1.4.1 User's Manual, Appendix D (available here).
    Occupancy Types - create new or import shortcut menu commands
  2. From the import dialog enter the Base Name and Base Description.
  3. From the Tab Delimited File box, click the browser ellipse button to navigate to the appropriate text file and click Open. Then select the unique name (a field of the attribute table). Click OK to import the dataset.
    Example Import Occupancy Types From Tab Delimited File, displaying the import log.

Alternatively, to create new occupancy types, from the Study Tree, right-click on Occupancy Types under Economics and select the create new option to open a blank editor for creating new occupancy types.

Import Structure Inventories

A structure inventory is imported using a point shapefile, where the attribute table must have the following attributes: unique ID, dollar-denominated structure value, occupancy type, and either both foundation height and ground elevation or just the first floor elevation. Identify whether first floor elevation or foundation height will be used, and if foundation height, identify whether the ground elevations will come from the structure inventory or a terrain file. Select optional attributes and identify what occupancy type names in the structure inventory correspond to which occupancy types in the study database. 

To import a structure inventory:

  1. Right-click on Structure Inventories under Economics in the Study Tree and select Import From Shapefile.
    Structure Inventories - Import From Shapefile shortcut menu command.
  2. Give the imported inventory a useful Name and Description (optional, but recommended).
  3. Identify the path of the shapefile. From the Structure Inventory Shapefile box, click the browser ellipse button to navigate to the appropriate point shapefile and click Open.
  4. From the Required Attributes panel, select the first floor elevation source:
    1. First Floor Elevation – Select this option if the shapefile contains an attribute with the structure first floor elevation. When selected a First Floor Elevation required attribute dropdown list will be provided below the Structure ID and Occupancy Type dropdown lists.
    2. Ground Elevation and Foundation Height – Select this option to have the first floor elevation calculated from the structure ground elevation and foundation height. Selecting this option requires users to select the Ground Elevation Source either from an imported terrain file or from the selected structure inventory shapefile. 

      Economics FDA icon HEC-FDA will notify users if the required attributes have not been selected in the import wizard (e.g., Structure ID was left blank), or if a terrain file has not been imported and the From Terrain File is selected. 

  5. Identify required attributes and any optional attributes.
    Import Structure Inventory, identify structure attributes, first window example.
  6. Click Next.
  7. The next window requires users to identify the occupancy types for the structures. Select source of occupancy types (e.g., NSIOccTypes MuncieOccTypes), and match imported occupancy types to occupancy types in the structure inventory.
    Import Structure Inventory, identify occupancy types, finish window example.
  8. Click Finish.

Duplicates Not Needed

  1. If a given study data item is the same for multiple project conditions, then that study data item need not be duplicated. For example, assume that you have a flow-frequency function for the existing condition of a given impact area, but the flow-frequency function is also representative of the hydrologic conditions of the future-without project condition, and all with-project conditions. In that case, create one frequency function, and select the same frequency function for each of the Scenarios. 
  2. Except for terrain and the set of impact areas, many items can be created for a given study data element. For example, multiple structure inventories can be imported. 

Second: Compute Aggregated Stage-Damage Functions

The following items must be selected for configuration of an aggregated stage-damage compute: 

  1. Discharge-frequency function and discharge-stage function or just a stage-frequency function 
  2. Hydraulic data set
  3. Structure inventory 
  4. Occupancy types 

To create a new aggregated stage-damage function:

  1. Right-click on Aggregated Stage-Damage Functions under Economics within the Study Tree and select the create new option.
    Aggregated Stage-Damage Functions - Create and Import shortcut menu commands.
  2. Define a useful Name and Description.
  3. Select Computed.
  4. Enter the Analysis Year (e.g., base year is 2024 in the example).
  5. In the Configure and Compute panel, select the the appropriate hydraulic dataset (e.g., Steady-State_RASdata) and structure inventory (e.g., BaseWO). Then for each impact area select the appropriate Frequency and Stage Discharge functions. 
  6. Optionally, select Write Details to CSV to obtain structure-level stage-damage details (selected by default). The CSV file for the created function will be saved to you study directory in a new folder named StuctureStageDamageDetails.
  7. Click Compute Curves.

    Aggregated Stage-Damage Function FDA icon An aggregated stage-damage function is computed for each impact area, damage category, asset category combination.

     
    Example Aggregated Stage-Damage Functions dialog.
  8. Click Save, and Close.

Third: Specify and Compute Scenarios

Typical Scenarios

Specify a scenario for each project condition-analysis year combination. The following must be selected for each impact area for a given scenario to compute EAD:

  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. Stage-damage functions, one for each damage category - asset category combination (optional if performance is the only metric of interest)

The following may optionally be selected for any impact area for 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 

To create a new typical scenario:

  1. From the Study Tree, right-click on Scenarios and select Create New Scenario.
    HEC-FDA Study Tree, Scenarios study element right-clicked to display the Scenarios shortcut menu options.
  2. Give the scenario a useful name, description, and specify the analysis year.
  3. If the scenario is a typical scenario move to top impact area tab (e.g., Left-Bank). If the scenario is for calculating total risk, move to the Total Risk Scenarios section. 
  4. For each impact area, select:
    1. Frequency function (if using flow-frequency, specify rating curve).
    2. Set of aggregated stage-damage functions (optional if performance is the only metric of interest).
    3. Regulated-unregulated function (optional).
    4. Lateral structure (if the impact area contains a levee).
    5. Exterior-interior function (optional).
  5. For each impact area, specify the threshold stage by which system performance statistics will be calculated. This step requires configuration for those impact areas of a scenario that will not be assigned a lateral structure. 
    1. For impact areas with lateral structures, the software automatically identifies the threshold. 
      1. For impact areas with a lateral structure but without a system response curve, the threshold is the stage equal to the top elevation of the levee.
      2. For impact areas with lateral structures and with system response curves, performance does not reflect a fixed threshold. Instead, performance considers the joint probability of hazard loading (e.g. stage) and levee breach for the entire range of stages for which there is a non-zero probability of breach. 
    2. For impact areas without lateral structures and if the scenario reflects the without-project condition, choose Calculate Default Threshold. The default threshold is the stage at which 5% of the damage of the 1% event occurs. This is considered to be the stage at which significant damage begins. 
    3. For impact areas without lateral structures and if the scenario reflects the with-project condition, use without-project condition scenario performance results to identify the threshold stage. Obtain the without-project condition threshold stage calculated for the same impact area and analysis year. Using the same threshold for both the without- and with-project conditions of the same analysis year where no levees are present correctly results in changes to system performance metrics through modifications to hydrology or hydraulics. System performance changes are not modeled for nonstructural alternatives. 

      Important Note:

      If the scenario is a with-project scenario then you must manually enter the Threshold Stage for all impact areas that do not have a lateral structure. This threshold stage is the "Target Stage" (or project performance threshold value) that is calculated for the without-project scenario for the corresponding analysis year and impact area. 

      To view the target threshold value, from the Study Tree, right-click on the without project scenario (for the correct analysis year), and select Compute Scenario if results have not yet been computed, otherwise right-click on the scenario and view results. The Compute Log opens to display the compute progress. Once complete, click Yes to view the results. Select the appropriate impact area, and the Performance outcomes. Note that the calculated Threshold value is displayed for the selected impact area. Return to the Create New Scenario dialog and enter the identified threshold stage for the corresponding impact area.
  6. Once all the required (noted with a red * asterisk) summary relationships and parameters have been selected for each impact area the impact area tab displays a green green checkmark checkmark. 

  7. Another option in the scenario editor is the ability to add additional thresholds. Additional thresholds could be handy for nonstructural alternatives to be able to report performance for differentially elevated structures. To add thresholds, click the Additional Thresholds button and from the System Performance Thresholds dialog click Add to add new rows to the thresholds table and enter a stage value. Repeat this process to add more thresholds. To remove an entered threshold, select the row you want to delete and click Remove. Once finished, click OK.
  8. Click the Preview Compute button to view damage frequency function and deterministic calculations of EAD and AEP. Spend time inspecting the overlap across the summary relationships. Lack of overlap is a significant problem that means that modeling conditions and assumptions are inconsistent between hydrology, hydraulics, or economics and the resulting risk compute will produce bad results. 
    Create New Scenario, Example Preview Compute Plots and Warnings
  9. When finished, click Save and Close to create the new scenario.

Total Risk Scenarios

In addition to the normal FDA study requirements, when creating total risk scenarios the following must also be added to your study: 

  • A second hydraulic dataset for the non-failure situation for the interior flooding that would occur in the floodplain if the levee does not fail (e.g., is overtopped or outflanked).
  • A second set of aggregated stage-damage functions calculated using the non-failure hydraulic dataset.

To create a scenario that calculates total risk:

  1. From the Study Tree, right-click on Scenarios and select Create New Scenario.
  2. Enter the name, description and analysis year for the scenario.
  3. Enable the Non-Failure Scenario Modeled option, by checking the checkbox. Note, the Create New Scenario dialog updates to include two stage-damage lists. One list for the Failure Stage-Damage function and one for the Non-Failure Stage-Damage function.
  4. Next, complete the scenario as you normally would by making sure you select the correct summary relationships and parameters required for each impact area (see the Typical Scenarios section for detailed steps). Users must remember to include the lateral structure for the appropriate impact area as HEC-FDA does not check that a lateral structure is selected when the non-failure scenario modeled option is enabled. 
  5. Once all the required (noted with a red * asterisk) summary relationships and parameters have been selected for each impact area the impact area tab displays a green green checkmark checkmark.
    Create New Scenario Example for Total Risk with Non-Failure Scenario Modeled Selected.
  6. Click the Preview Compute to view damage frequency function and deterministic calculations of EAD and AEP.
  7. If desired, use the Additional Thresholds button to add thresholds to the scenario.
  8. When finished, click Save and Close to create the new scenario. 

Compute and View Scenario Results

  1. To compute a specific scenario, from the Study Tree, right-click on the scenario and select Compute Scenario. For example, to view the target threshold value, from the Study Tree, right-click on the without project scenario (for the correct analysis year), and select Compute Scenario. The Compute Log opens to display the compute progress. 
    Example Scenario Shortcut Menu Command Options.
    Alternatively, users can compute multiple scenarios at once by right-clicking on Scenarios from the Study Tree and selecting Compute Scenarios. A dialog opens that provides checkboxes to select specific scenarios to compute, or use the Select All option to compute all the scenarios at once.
    Scenarios Shortcut Menu Command Options.
    Example Compute Scenarios dialog with previously computed scenarios re-computed.
  2. Once the compute is complete, click Yes to view the results.
  3. Select the type of report - Expected Annual Damage or Project Performance, and select result of interest. For example, to identify the target stage for a with-project scenario, select the appropriate impact area, and the Performance outcomes. Note that the calculated Threshold value is displayed for the selected impact area.
  4. Then, return to the Scenario dialog and enter the identified threshold stage for the corresponding impact area.

See Scenario Results for more information. 

Fourth: Specify Alternatives and an Alternative Comparison Report

Create Alternatives

To create a new alternative:

  1. First, set the study properties, including the discount rate and period of analysis. Open the Study Properties tab from the File menu.
    HEC-FDA Version 2.0, File Menu, Properties command selected.
  2. Enter the discount rate and period of analysis from the Properties dialog. Click Save and Close to close the dialog and set the discount rate and period of analysis. 

    Please note that the discount rate should be in decimal form, not percentage.


  3. Next, from the Study Tree, right-click on Alternatives and select Create New Alternative.
    Alternatives shortcut menu commands
  4. Give the alternative a useful name (e.g., Without Project) and description.
    Example Create New Alternative dialog.
  5. From the Base Year Scenario, select the appropriate created scenario (e.g., WOP_Base) and enter the correct base year (e.g., 2024). 
  6. From the Future Year Scenario, select the appropriate corresponding future year scenario (e.g., WOP_Future) and enter the correct future year (e.g., 2054).

    Alternatives FDA icon Note: you must be sure that the period of analysis in the Study Properties is consistent with the base and future years you select.

  7. Click, Save and Close
  8. Either compute and view the alternative results, or continue creating additional project alternatives and view the summary results.
  9. To view the results for a specific alternative, from the Study Tree, right-click on the alternative and select View Results to compute.
    Example Created Alternative - shortcut menu commands.
  10. From the Alternative Results dialog, select the desired Report from the list which includes: Damage with Uncertainty, Damage by Impact Area, or Damage by Damage Category. 
    Example Alternative Results - Without Project - Damage with Uncertainty report.
  11. Alternatively, compute and view the results summary table. To view the summary results, from the Study Tree, right-click on Alternatives and select View Alternative Summary Results.
    Alternatives, View Alternative Summary Results shortcut menu command.
  12. From the View Alternative Results dialog, select desired alternatives to include in the summary results, or click Select All and include all alternatives. Click View to open the summary results.
    View Alternative Results dialog, for selecting the alternatives to compute and view.

Review Alternative Results for more information.

Create an Alternative Comparison Report

  1. Right-click on Alternative Comparison Reports in the Study Tree and select the create new option.
    Create New Alternative Comparison Report, shortcut menu command.
  2. Specify a useful Name and Description (optional, but recommended).
  3. For the Without Project, select the appropriate alternative (e.g., Without Project). 
  4. Select a with-project condition alternative.
  5. Click Add Comparison to include additional with-project condition alternatives, if applicable. By default the alternative comparison report dialog contains one With Project condition. Select the appropriate with-project condition alternatives to include in the comparison report. 
  6. To remove an added comparison, select the comparison (e.g., Levee and Nonstructural) and click Remove Comparison.
    Example Create New Alternative Comparison Report.
  7. When the desired without and with project comparison(s) have been added and selected, click Save and Close.
  8. Right-click on the created alternative comparison report and select View Results.
    Example Alternative Comparison Report element - shortcut menu commands.
  9. View the results for the desired With-Project Alternative (e.g., Levee Only Plan), and desired measurement of damage: expected annual damage (EAD) or average annual equivalent damage (AAEQ). 
    Alternative Comparison Report Results for an Example comparison with Damage Measure options.
  10. If EAD is selected, review the results by Analysis Year and report options. 
  11. For either damage measure, the Report options include: Damage with Uncertainty, Damage by Impact Area, or Damage by Damage Category.
    Alternative Comparison Report Results for an Example comparison with Report options.

Review the Alternative Comparison Report Results page for more information.

Helpful Hints About Study Data

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. 

Related Topics

Review the HEC-FDA Quick Start Guides Create New Study from Scratch page for instructional videos for creating a new study from scratch.