Water facility damage#

Description

This analysis computes water facility damage based on a particular hazard. Currently supported hazards are: earthquake and tsunami.

The process for computing the structural damage is similar to other parts of the built environment. First, a fragility is obtained based on the hazard type and attributes of the building. Based on the fragility, the hazard intensity at the location of the building is computed. Using this information, the probability of exceeding each limit state is computed, along with the probability of damage. For the case of an earthquake hazard, soil information can be used to modify the damage probabilities to include damage due to liquefaction.

The outputs of this analysis are CSV file with probabilities of damage and JSON file with information about hazard and fragilities.

Input Parameters

key name

type

name

description

result_name *

str

Result name

Name of the result dataset.

hazard_type

str

Hazard type

Hazard type (earthquake and tsunami).

hazard_id

str

Hazard id

ID of the hazard from the Hazard service.

fragility_key

str

Fragility key

Fragility key used in mapping dataset.

use_liquefaction

bool

Liquefaction

Use liquefaction, if applicable to the hazard. Default is
False.

use_hazard_uncertainty

bool

Uncertainty

Use hazard uncertainty.

liquefaction_geology_dataset_id

str

Liquefaction id

Liquefaction susceptibility dataset.

liquefaction_fragility_key

str

Fragility key

Fragility key used in mapping dataset.

num_cpu

int

Number of CPUs

Number of CPUs used for parallel computations.
Default 1.

Input Hazards

key name

type

name

description

hazard

earthquake
tsunami

Hazard

Supported hazard object for using local and remote hazards.

Input Datasets

key name

type

name

description

water_facilities *

ergo:waterFacilityTopo

Facility dataset

A water facility dataset.

dfr3_mapping_set *

incore:dfr3MappingSet

DFR3 Mapping Set

DFR3 Mapping Set.

Output datasets

key name

type

parent key

name

description

result *

ergo:waterFacilityDamageVer5

water_facilities

Results

A dataset containing results
(format: CSV).

damage_result *

incore:waterFacilityDamageSupplement

water_facilities

Results

Information about applied hazard value and fragility
(format: JSON).

(* required)

Execution

code snippet:

    # Create water facility damage analysis
    wf_dmg = WaterFacilityDamage(client)

    # Load water facility inventory dataset
    wf_dmg.load_remote_input_dataset("water_facilities", facility_dataset_id)

    # Load fragility mapping
    fragility_service = FragilityService(client)
    mapping_set = MappingSet(fragility_service.get_mapping(mapping_id))
    wf_dmg.set_input_dataset('dfr3_mapping_set', mapping_set)

    # Specify result name
    result_name = "wf-dmg-results"

    # Set analysis parameters
    wf_dmg.set_parameter("result_name", result_name)
    wf_dmg.set_parameter("hazard_type", hazard_type)
    wf_dmg.set_parameter("hazard_id", hazard_id)
    wf_dmg.set_parameter("fragility_key", fragility_key)
    wf_dmg.set_parameter("use_liquefaction", liquefaction)
    wf_dmg.set_parameter("liquefaction_geology_dataset_id", liq_geology_dataset_id)
    wf_dmg.set_parameter("liquefaction_fragility_key", liq_fragility_key)
    wf_dmg.set_parameter("use_hazard_uncertainty", uncertainty)
    wf_dmg.set_parameter("num_cpu", 4)

    # Run water facility damage analysis
    wf_dmg.run_analysis()

full analysis: water_facility_dmg.ipynb