...

To apply FIAT in a Delft-FEWS workflow, you will need an inundation grid series (e.g. satellite image or flood inundation model like Delft-FM or 3Di-subgrid) to hand over to FIAT. When providing a max-depth map to FIAT it can calcualte the (financial) damage per category on the map or as a total value for the entire area . This max-depth map needs to be prepared in FEWS as a grid series with one timestep. When you also provide a flood wave (grid series with multiple timestep) to FIAT, it can compute the human impact (mortality and casualties) by internal conversion of the wave into (vertical) rise rate and an arrival time map. This conversion may take some time (several minutes).

FIAT-adapter

The FIAT-adapter (fews_wrapper.py) is wrapped around the FIAT computational core and available in the FIAT distribution. To accommodate portability without python installation troubles, a self-contained executable (FIAT.exe) is available on request with Edwin Bos at Deltares.

...

• <workDir>path</workDir>
  • Path is a full path to a directory, to be used as working directory by Delft-Fiat.
• <inputNetcdfFile>path/max_depth.nc</inputNetcdfFile>
  • Full or relative path to max_depth.nc, containing variable “waterdepth” with dimensions “time,y, x” or “time,realization,y, x”. This represents the maximum waterdepth during a flood event. If the file holds multiple timesteps, FIAT assumes that the last timestep represents the maximum
• <inputNetcdfFile>path/floodwave.nc</inputNetcdfFile> (optional)
  • Full or relative path to floodwave.nc, containing variable “waterdepth” with dimensions “time, y, x” or “time,realization,y, x”. This represents the waterdepth map evolving in time during a flood event.
• <outputNetcdfFile>path/impact_on_grid.nc</outputNetcdfFile>
  • Path is a full or relative path to a not-yet-existing file called impact_on_grid.nc, which will be created as output by Delft-Fiat and filled with the output grids.
• <outputNetcdfFile>path/impact_summary.nc</outputNetcdfFile>
  • Path is a full or relative path to a not-yet-existing file called impact_summary.nc, which will be created as output by Delft-Fiat and filled with the summary results.
• <outputDiagnosticFile>path/fiat_diagnostics.xml</outputDiagnosticFile>
  • Path is a full or relative path to a not-yet-existing file called fiat_diagnostics.xml, which will be created as output by Delft-Fiat.
• <properties>
  • <string key="JSON" value="path"/>
    • Full or relative path to json file defining the supported categories.
  • <string key="CATEGORY_1" value="Direct_industrie"/>
    • Specify the categories of interest as string elements, with unique random keys and the category name (specified in JSON file) as value.
• </properties>

...

The JSON file is the FIAT model configuration file, with a similar function to the Excel file often used in a FIAT stand alone context. The JSON file is basically a python dictionary definition that defines per category at least the exposure grid, the damage function and the max damage value. Other properties may be included when needed.. Please use category names with underscores as they will become the NetCDF-variables in the output dataset.

Below you can find the format specification and an example file, using relative pathsThe format is:

{
        'category name': {
            'exposure grid filepath': '', (full or relative)
            'maximum damage': float(),
            'bu maximum damage': float(), (optional)
            'damage function filepath': '', (full or relative)
            'bu damage function filepath': '', (optional)
            'output grid filepath': '', (only filename, not path!)
            'weight': float(),
            'units': '',
        }
        'category name': {} (repeat for all categories)
}

{
    "Direct_industrie": 
    {
        "damage function filepath": "../../SSM2015/Functions/393.csv",
        "maximum damage": 1769.0,
        "output grid filepath": "Direct_industrie.tif",
        "weight": 1.0, 
        "units": "m2",
        "exposure grid filepath": "../../SSM2015/25x25m_grid/industrie.tif"
    },
    "Direct_kantoor":
    {
        "damage function filepath": "../../SSM2015/Functions/391.csv",
        "maximum damage": 1283.0,
        "output grid filepath": "Direct_kantoor.tif",
        "weight": 1.0, 
        "units": "m2",
        "exposure grid filepath": "../../SSM2015/25x25m_grid/kantoor.tif"
    },
    "Aantal_eengezinswoningen":
    {
        "damage function filepath": "../../SSM2015/Functions/800.csv",
        "maximum damage": 1,
        "output grid filepath": "Aantal_eengezinswoningen.tif",
        "weight": 1.0, 
        "units": "objecten",
        "exposure grid filepath": "../../SSM2015/25x25m_grid/eeng_aant.tif"
    },
    "Direct_eengezinswoningen_inboedel_normaal":
    {
        "damage function filepath": "../../SSM2015/Functions/8.csv",
        "maximum damage": 70000.0,
        "output grid filepath": "Direct_eengezinswoningen_inboedel_normaal.tif",
        "weight": 1.0, 
        "units": "objecten",
        "exposure grid filepath": "../../SSM2015/25x25m_grid/eeng_aant.tif"
    },
    "Inwoners":
    {
        "damage function filepath": "../../SSM2015/Functions/2_0001.csv",
        "maximum damage": 1283.0,
        "output grid filepath": "Inwoners.tif",
        "weight": 1.0, 
        "units": "personen",
        "exposure grid filepath": "../../SSM2015/25x25m_grid/inwoners.tif"
    }
}

Other files

The max_depth.nc (input) file typically holds only one timestep. If the file holds multiple timesteps, FIAT assumes that the last timestep represents the maximum. Please remember to specify the missing value (e.g. -999) when exporting the file from FEWS, or prevent an export of missing values by filling up the grid with zero's.

The floodwave.nc (input) file file is expected to hold a mapstack of grids with equal timestep. Be aware that FIAT takes a few minutes to convert these files into a rise_rate and travel_time data file. Skip this export when you are not calculating the human impact (mortality and casualties)

The impact_on_grid.nc (output) file file is a mapstack file holds for each category a map with the associated damage. The data is written with the T0 timestep, assigning the category name to the NetCDF-variable.

The impact_summary.nc (output) file is a timeseries file that holds for each category a single value with the associated total damage in the area.

Suggested folder organisation

The screenshot presents a suggested folder organisation, where the fixed datasets (exposure maps and damage functions) are contained in the \SSM2015 folder, while the \Rotterdam folder contains the specific case/study area folder for exchange with FEWS. The executable and associated libraries are held in the \bin folder.

Image Added

Example configuration files:

Waterlevel2waterdepth.xml converts water level to water depth (including fill up with zero's)

Postprocess_waterdepth.xml computes max-depth

Waterdepth2impact.xml computes impact on several categories (to_FIAT-idmap, from_FIAT-idmap)

json file defines the categories and its associated datasets and properties