Water facility restoration#

Description

This analysis computes the repair time, and the percentage of functionality change with time for water facility restoration based the mapped restoration curves.

The restoration curves are obtained based on the hazard type and class of the water facility, e.g. Treatment plant, pumping plant, water storage tank, and etc. Based on the restoration curve applicable, we can obtain the percentage of the functionality change by varying the time; we can also compute the repair time at different level of percentage of functionality change by inversing the restoration function.

Input Parameters

key name

type

name

description

result_name *

str

Result name

Name of the result dataset.

restoration_key

str

Restoration key

Restoration key used in mapping dataset. Default to “Restoration ID Code”

end_time

float

End time

End repair time in days. Default to 365 days

time_interval

float

Time interval

Incremental interval for time in days. Default to 1

pf_interval

float

Percentage of functionality interval

Incremental interval for percentage of functionality. Default to 0.05

discretized_days

List[int]

Discretized Days

Discretized days to compute functionality. Defaults to 1, 3, 7, 30, 90

Input Datasets

key name

type

name

description

dfr3_mapping_set *

incore:dfr3MappingSet

DFR3 Mapping Set

DFR3 Mapping Set.

water_facilities *

ergo:waterFacilityTopo

Water Facilities

Water Facilities.

Output datasets

key name

type

parent key

name

description

time_results *

incore:waterFacilityRestorationTime

water_facilities

Time results

A csv file recording repair time at certain functionality recovery for each class and limit state.

pf_results *

incore:waterFacilityRestorationFunc

water_facilities

Percentage of functionality results

A csv file recording functionality change with time for each class and limit state.

inventory_restoration_map *

incore:inventoryRestorationMap

water_facilities

Mapping of inventory and restoration

A csv file recording the mapping relationship between GUID and restoration id applicable.

func_results *

incore:waterFacilityDiscretizedRestorationFunc

Discretized restoration functionality

A csv file recording discretized functionality over time.

(* required)

Execution

code snippet:

    # Create water facility restoration analysis
    client = IncoreClient()
    wf_rest = WaterFacilityRestoration(client)

    # Load restoration mapping
    restorationsvc = RestorationService(client)
    mapping_set = MappingSet(restorationsvc.get_mapping("61f075ee903e515036cee0a5"))  # new format of mapping
    wf_rest.load_remote_input_dataset("water_facilities", "5a284f2ac7d30d13bc081e52")  # water facility
    wf_rest.set_input_dataset('dfr3_mapping_set', mapping_set)
    wf_rest.set_parameter("result_name", "wf_restoration")
    wf_rest.set_parameter("discretized_days", [1, 3, 7, 30, 90])
    wf_rest.set_parameter("restoration_key", "Restoration ID Code")
    wf_rest.set_parameter("end_time", 100.0)
    wf_rest.set_parameter("time_interval", 1.0)
    wf_rest.set_parameter("pf_interval", 0.05)
    
    # run restoration analysis
    wf_rest.run_analysis()

full analysis: water_facility_restoration.ipynb