/infrarisk

An integrated water-power-transportation model for network simulations.

Primary LanguageJupyter NotebookBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

drawing

InfraRisk: A simulation tool for risk and resilience analysis of interdependent infrastructure networks

A Python -based simulation platform to simulate the interdependent failures in interdependent water-power-transport networks.

Getting Started

Prerequisites

  • Operating System: Windows 10
  • Python 3.7+
  • Anaconda

Installation

Please follow the steps below to setup the InfraRisk Integrated Simulation Platform.

  1. Clone the InfraRisk integrated simulation platfom repository from Github.
git clone https://github.com/srijithbalakrishnan/dreaminsg-integrated-model.git folder-name
  1. Create a new python virtual environment with all required packages needed to run the simulation platform
conda env create --name ENV_NAME --file=environment.yml
  1. Install the InfraRisk package in the created environment. Go to the project folder and run the following command:
conda activate redcar
pip install –-editable .

Help

For instructions to run sample simulation on the simple network testbed, please refer to notebooks/event_based_simulations/simple_network.ipynb (faster).

For instructions to run sample simulation on the Micropolis testbed, please refer to notebooks/event_based_simulations/micropolis_network.ipynb (slower).

For instructions to run sample simulation on the Shelby County testbed, please refer to notebooks/event_based_simulations/shelby_county.ipynb (slower).

For instructions to run MPC optimization on the simple network testbed, please refer to notebooks/recovery_optimization/demo_optimization_incomplete.ipynb (faster). The notebook works for the current disruptive event (test1). However, please note that there could be an issue of infinite loops when performing MPC optimization of repair sequence for disruptions involving inaccessible components. The bug will be rectified soon.

For generating various hazards, see tutorials in notebooks/hazard_generation/

Full documentation is available at dreaminsg_documentation.pdf or HTML version is available on Read the Docs website. Please do note some sections need to be updated and the process is going on.

Publications

  1. Balakrishnan, S., & Cassottana, B. (2022). InfraRisk: An open-source simulation platform for resilience analysis in interconnected power–water–transport networks. Sustainable Cities and Society, 83, 103963 (link).
  2. Cassottana, B., Biswas, P. P., Balakrishnan, S., Ng, B., Mashima, D., & Sansavini, G. (2022). Predicting Resilience of Interdependent Urban Infrastructure Systems. IEEE Access, 10, 116432-116442 (link).
  3. Balakrishnan, S., Cassottana, B., & Verma, A. (2022). Application of Clustering Algorithms for Dimensionality Reduction in Infrastructure Resilience Prediction Models. arXiv preprint arXiv:2205.03316. (link).

Authors

Contributors' names and contact info:

  1. Srijith Balakrishnan, Ph.D. (Email: inform.srijith@gmail.com)

Version History

  • 0.1
    • Initial Release

License

This project is licensed under the MIT License

SEC Disclaimer

This research is carried out by Singapore ETH Centre through its Future Resilient Systems module funded by the National Research Foundation (NRF) Singapore. It is subject to Agency's review and hence is for internal use only. Not the contents necessarily reflect the views of the Agency. Mention of trade names, products, or services does not convey official NRF approval, endorsement, or recommendation.

Acknowledgments

The platform is developed as part of the DREAMIN'SG project funded by the National Research Foundation Singapore (NRF) through the Intra-CREATE program.