Network cascading interdependency functionality

Network cascading interdependency functionality#

Description

This analysis computes cascading functionality based on the interdependencies between electric power facility (EPF) networks and water distribution (WDS) networks.

This analysis computes the output of the Leontief equation for functional dependencies between two interdependent networks having functionality information per node. These dependencies capture cascading dependencies on infrastructure functionality, expressed in terms of discretized times.

The output of the computation consists of a dataset with EPN cascading functionality accompanying the original discrete ones.

Contributors

Science: Milad Roohi, John van de Lindt
Implementation: Milad Roohi, Santiago Núñez-Corrales and NCSA IN-CORE Dev Team

Related publications

Roohi M, van de Lindt JW, Rosenheim N, Hu Y, Cutler H. (2021) Implication of building inventory accuracy on physical and socio-economic resilience metrics for informed decision-making in natural hazards. Structure and Infrastructure Engineering. 2020 Nov 20;17(4):534-54.
Milad Roohi, Jiate Li, John van de Lindt. (2022) Seismic Functionality Analysis of Interdependent Buildings and Lifeline Systems 12th National Conference on Earthquake Engineering (12NCEE), Salt Lake City, UT (June 27-July 1, 2022).

Input Parameters

key name	type	name	description
`result_name` ^*	`str`	Result name	Name of the result dataset.
`discretized_days` ^*	`List[int]`	Discretized days	List of discretized days used across related analyses.

Input Datasets

key name	type	name	description
`epf_network` ^*	`incore:epnNetwork`	Electric Power Facility Network	Electric Power Facility Network Dataset. `wds_network` ^*
`epf_wds_intdp_table` ^*	`incore:networkInterdependencyTable`	EPN-to-WDS Interdependency	EPN-to-WDS Interdependency Table.
`wds_epf_intdp_table` ^*	`incore:networkInterdependencyTable`	WDS-to-EPN Interdependency	WDS-to-EPN Interdependency Table.
`epf_subst_failure_results` ^*	`incore:failureProbability`	Substation failure probability	Substation failure probability Dataset.
`epf_inventory_rest_map` ^*	`incore:inventoryRestorationMap`	EPN inventory restoration map	EPN inventory restoration Map.
`epf_time_results` ^*	`incore:epfRestorationTime`	EP facility restoration time	EP facility restoration time Dataset.
`wds_dmg_results` ^*	`ergo:waterFacilityDamageVer6`	Water facility damage	Water Facility Damage Dataset.
`wds_inventory_rest_map` ^*	`incore:inventoryRestorationMap`	WDS inventory restoration map	WDS inventory restoration Map.
`wds_time_results` ^*	`incore:waterFacilityRestorationTime`	Water facility restoration time	Water facility restoration time Dataset.
`epf_damage` ^*	`incore:epfDamageVer3`	Electric Power Facility Damage	Electric Power Facility Damage Dataset.

Output datasets

key name	type	parent key	name	description
`epf_cascading_functionality` ^*	`incore:epfDiscretizedCascadingFunc`	`electric_power_facilities`	EPF network interdependency cascading functionality results	CSV file of interdependent cascading network functionality for EPF.

(* required)

Execution

code snippet:

    client = IncoreClient()

    nic_func = NciFunctionality(client)
    nic_func.set_parameter("result_name", "MMSA_nci_result")
    nic_func.set_parameter("discretized_days", [1, 3, 7, 30, 90])
    nic_func.load_remote_input_dataset("epf_network", epf_mmsa_network)
    nic_func.load_remote_input_dataset("wds_network", wds_mmsa_network)
    nic_func.set_input_dataset("epf_wds_intdp_table", epf_wds_interdependencies)
    nic_func.set_input_dataset("wds_epf_intdp_table", wds_epf_interdependencies.csv)
    nic_func.set_input_dataset("epf_subst_failure_results", epf_subst_failure_results)
    nic_func.set_input_dataset("epf_inventory_rest_map", epf_inventory_rest_map)
    nic_func.set_input_dataset("epf_time_results", epf_time_results)
    nic_func.set_input_dataset("wds_dmg_results", wds_dmg_results)
    nic_func.set_input_dataset("wds_inventory_rest_map", wds_inventory_rest_map)
    nic_func.set_input_dataset("wds_time_results", wds_time_results)
    nic_func.set_input_dataset("epf_damage", epf_damage)

    # Run Analysis
    nic_func.run_analysis()

full analysis: nci_functionality.ipynb