search

nhrap-hazus / FAST

Hazus - Flood Assessment Structure Tool
GNU General Public License v3.0
31 stars 7 forks source link

readme

ATTENTION: The latest version of this tool is available at https://msc.fema.gov/portal/resources/hazus This github repository is no longer receiving updates.

Hazus Flood Assessment Structure Tool

The Hazus Flood Assessment Structure Tool (FAST) calculates building-level flood impacts with user-provided building and flood depth data. FAST uses the Hazus Flood model methodology to assign depth damage functions to buildings according to their occupancy type, first floor elevation, foundation type, and number of stories. Flood depth is then extracted at every building and used as a depth damage function parameter to calculate flood losses in dollars. Flood-generated debris is estimated using building area in square feet. For more information about how FAST cacluates flood impacts, please refer to the Hazus Flood Technical Manual: https://www.fema.gov/media-library-data/20130726-1820-25045-8292/hzmh2_1_fl_tm.pdf

Building data must be formatted as a .csv file according to the specifications outlined here: https://github.com/nhrap-hazus/FAST/blob/master/Help/FASTBuildingData.pdf Flood depth data must be formatted as a .tiff raster. Sample building data for Honolulu, HI are included in the "UDF" folder.

FAST is developed using the Hazus Python Package, HazPy. HazPy tools automatically check for updates each time they are opened. Hazus Python Package documentation is found here: https://github.com/nhrap-hazus/hazus. The Hazus Team would like to thank the Oregon Department of Geology and Mineral Industries for developing an early version of this tool: https://www.oregongeology.org/pubs/ofr/O-18-04/O-18-04_user_guide.pdf

Requirements

The Flood Assessment Structure Tool requires Anaconda to be installed on your computer. Anaconda is a free software that automatically manages all Python packages required to run Hazus open source tools - including the Hazus Python package: https://fema-ftp-snapshot.s3.amazonaws.com/Hazus/hazpy/build/html/index.html Please note that FAST is not compatible with the Export Tool at this time. If you have the Export Tool installed on your machine, please remove it before downloading and installing FAST

  1. Go to https://www.anaconda.com/distribution/

  2. Download Anaconda for Python 3

  3. Complete the installation. During installation, make sure the following options are checked:

    • [x] Add Anaconda to my PATH environment variable
    • [x] Register Anaconda as my default Python
    • [x] Install Anaconda for local user, rather than all users

FAST will automatically check for HazPy updates each time it is opened. If you experience errors during this process, please try uninstalling Anaconda and reinstalling the latest version.

Documentation

Please see the Help folder for building data guidance, FAST case study information (coming soon), and a brief video demonstration of FAST: https://github.com/nhrap-hazus/FAST/tree/master/Help

Contact

Check out the Troubleshooting section below for help operating FAST.

Issues can be reported through the repository on Github: https://github.com/nhrap-dev/FAST/issues

For questions contact the Hazus Team at fema-hazus-support@fema.dhs.gov.

To Use

Follow the steps below to run FAST. To ensure .py files run when double-clicked, right-click the .py file and go to Properties. Under the "General" tab next to "Opens With", make sure "python.exe" is selected. If not, click "Change" and select "python.exe" from your Python installation directory.

1. Download zip folder from GitHub, unzip.

Download FAST

**2. Place your formatted building data in the "UDF" subfolder. Place your flood depth data in the "Rasters" subfolder. Guidance for formatting building data can be found here: https://github.com/nhrap-hazus/FAST/blob/master/Help/FASTBuildingData.pdf***

Store input data

3. Double-click "FAST.py" If you don't have the Hazus Python Library installed, follow the prompt to install, then double-click "FAST.py" again.

To customize the damage functions used by FAST to calculate losses, review these guidelines: https://github.com/nhrap-hazus/FAST/blob/master/Help/FASTDamageFunctions.pdf

Open FAST

4. Click "Browse to Inventory Input (.csv)" to select your formatted building data.

Supply building data

5. Select "Riverine", "CoastalA", or "CoastalV" from the "Coastal Flooding Attribute" window according to your analysis requirements. Select a flood depth dataset from the "Depth Grid" window.

Select flood type and flood data

6. Click "Execute". Review the summary window after FAST finishes to confirm data were analyzed.

Run FAST

Troubleshooting

Please reach out to the Hazus Team any time for help troubleshooting tool issues at fema-hazus-support@fema.dhs.gov.

Hazus open source tools use a centrally managed Python environment added to your machine upon installation. If you downloaded and installed FAST prior to 2021, you may need to delete your old Python environment - called "hazus_env". If you're having issues opening FAST or if the version number in your "src/init.py" file reads '0.0.5' or older, try one of the two options below to delete your old Python environment:

Using Anaconda:

  1. Delete FAST from your machine.
  2. Open Anaconda.
  3. Select the 'hazus_env'.
  4. Click the 'Remove' button.
  5. A popup will appear asking you to confirm. Click the 'Remove' button. This may take a few minutes.
  6. Download the latest FAST and it will create the hazus_env and install hazpy. Anaconda Remove Environment

Using Command Line:

  1. Delete FAST from your machine.
  2. Open a command line prompt
  3. Enter the following without qoutes 'conda info --envs' to see your environments. 'hazus_env' should be listed.
  4. Enter the following without quotes 'conda env remove --name hazus_env' to remove the environment. This may take a few minutes.
  5. Enter the following without qoutes 'conda info --envs' to see your environments again and hazus_env should not be listed.
  6. Download the latest FAST and it will create the hazus_env and install hazpy. Command Line Remove Environment