Electric power facility restoration

Electric power facility restoration#

Description

This analysis computes the repair time and the percentage of functionality change with time for an electric power facility based on input restoration curves.

The restoration curves are obtained based on the hazard type and class of the power facility, e.g. Low Voltage Substation, Large Power Plant, 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.1
`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.
`epfs` ^*	`incore:epf` `ergo:epf`	Electric Power Facilities	Electric Power Facilities.

Output datasets

key name	type	name	description
`pf_results` ^*	`incore:epfRestorationFunc`	Percentage of functionality results	A csv file recording functionality change with time for each class and limit state
`time_results` ^*	`incore:epfRestorationTime`	Time results	A csv file recording repair time at certain functionality recovery for each class and limit state.
`inventory_restoration_map` ^*	`incore:inventoryRestorationMap`	Mapping of inventory and restoration	A csv file recording the mapping relationship between GUID and restoration id applicable.
`func_results` ^*	`incore:epfDiscretizedRestorationFunc`	Discretized restoration functionality	A csv file recording discretized functionality over time.

(* required)

Execution

code snippet:

    # Create electric power facility restoration analysis
    client = IncoreClient()
    epf_rest = ElectricPowerFacilityRestoration(client)

    # Load restoration mapping
    restorationsvc = RestorationService(client)
    mapping_set = MappingSet(restorationsvc.get_mapping("61f302e6e3a03e465500b3eb"))  # new format of mapping
    epf_rest.load_remote_input_dataset('epfs', '5d92355bb9219c06ae7e386a')
    epf_rest.set_input_dataset('dfr3_mapping_set', mapping_set)
    epf_rest.set_parameter("result_name", "epf_restoration.csv")
    epf_rest.set_parameter("discretized_days", [1, 3, 7, 30, 90])
    epf_rest.set_parameter("restoration_key", "Restoration ID Code")
    epf_rest.set_parameter("end_time", 100.0)
    epf_rest.set_parameter("time_interval", 1.0)
    epf_rest.set_parameter("pf_interval", 0.01) 
    
    # run restoration analysis
    epf_rest.run_analysis()

full analysis: power_facility_restoration.ipynb