Templates

The simplest way to use HazImp is with a template, which sets up a PipeLine to run a collection of Job functions. There are currently templates for wind, earthquake and flood hazard events. Templates take into account internal vulnerability curves and the data flow needed to produce loss information, simplifying the configuration file.

Templates are used to set out the flow of processing invoked in separate Job functions that are then connected into a PipeLine that is subsequently executed.

Note

Because some of the Job functions in the templates are essential, the order of key/value pairs in the configuration files is important. The code will raise a RuntimeError if the order is incorrect, or if a mandatory configuration key is missing. This is even more important if not using the pre-defined templates.

We take the example of the wind_v4 template. It sets up the following job sequence in a specific order:

  1. LOADCVSEXPOSURE - load the exposure data

  2. LOADRASTER - load the hazard raster data

  3. LOADXMLVULNERABILITY - load the vulnerability functions

  4. SIMPLELINKER - select a group of vulnerability functions - some

vulnerability files may have multiple sets of curves identified by vulnerabilitySetID

  1. SELECTVULNFUNCTION - link the selected vulnerability function set

(specified by the vulnerabilitySetID option) to each exposure asset

  1. LOOKUP - do a table lookup to determine the damage index for each

asset, based on the intensity measure level (e.g. the wind speed)

  1. CALCSTRUCTLOSS - combine the calculated damage index with the building

value to calculate structural loss values.

  1. SAVE - should speak for itself - saves the building level loss data

  2. SAVEPROVENANCE - saves provenance data (like the version of HazImp,

source of the hazard data, etc.)

Available templates

There are currently 8 templates pre-packaged with HazImp. Most are built around wind impacts, but there are also templates for earthquake, flood (both structural and contents losses) and storm tide inundation:

  1. ‘wind_v4’ - Base wind impact template. Allows user to specify the

vulnerability function set in the configuration.

  1. ‘wind_v5’ - Optional categorisation and tabulation of output data.

  2. ‘wind_nc’ - Includes option to permute exposure data for mean and upper

limit of impact (structural loss ratio).

  1. ‘earthquake_v1’ - Base earthquake impact template. Allows similar

functions (aggregation, permutation, etc.) to the wind_nc template.

  1. ‘flood_fabric_v2’ - calculate structural loss due to flood inundation,

where floor height above ground is fixed.

  1. ‘flood_contents_v2’ - contents loss due to flood inundation.

  2. ‘flood_impact’ - structural loss due to flood inundation. Finished floor

height above ground specified as exposure attribute.

  1. ‘surge_nc’ - Structural loss due to storm tide inundation. This calculates

water depth above floor from floor height above ground as an attribute for each exposure attribute.