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 |
Name of the result dataset. |
|
|
Hazard type |
Hazard type (earthquake and tsunami). |
|
|
Hazard id |
ID of the hazard from the Hazard service. |
|
|
Fragility key |
Fragility key used in mapping dataset. |
|
|
Liquefaction |
Use liquefaction, if applicable to the hazard. Default is |
|
|
Uncertainty |
Use hazard uncertainty. |
|
|
Liquefaction id |
Liquefaction susceptibility dataset. |
|
|
Fragility key |
Fragility key used in mapping dataset. |
|
|
Number of CPUs |
Number of CPUs used for parallel computations. |
Input Hazards
key name |
type |
name |
description |
---|---|---|---|
|
|
Hazard |
Supported hazard object for using local and remote hazards. |
Input Datasets
key name |
type |
name |
description |
---|---|---|---|
|
Facility dataset |
A water facility dataset. |
|
|
DFR3 Mapping Set |
DFR3 Mapping Set. |
Output datasets
key name |
type |
parent key |
name |
description |
---|---|---|---|---|
|
|
Results |
A dataset containing results |
|
|
|
Results |
Information about applied hazard value and fragility |
(* 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