search

IN-CORE / incore-usrse24-submission

This repository contains the submission materials for the US-RSE’24 conference from the IN-CORE framework. It demonstrates the application of IN-CORE (Interdependent Networked Community Resilience Modeling Environment) for assessing community resilience, focusing on the Joplin, Missouri Tornado damage case study.
Mozilla Public License 2.0
0 stars 0 forks source link

readme

Community Resilience Research Using IN-CORE - Case Study with 2011 Tornado Event at Joplin, MO

Authors:

Affiliation: Authors marked with * are affiliated with the National Center for Supercomputing Applications, University of Illinois at Urbana-Champaign. Authors marked with † is affiliated with Colorado State University.

Note: This repository contains the submission materials for the US-RSE’24 conference regarding the IN-CORE (Interdependent Networked Community Resilience Modeling Environment) platform. It demonstrates the application and capabilities of IN-CORE for assessing community resilience with a real-world case study on 2011 EF-5 Tornado at Joplin, Missouri.

Abstract

Community resilience research is essential for anticipating, preventing, and mitigating the impacts of natural and anthropogenic disasters. To support this research, the Center for Risk-Based Community Resilience Planning, funded by the National Institute of Standards and Technology (NIST), developed the measurement science and metrics that can help communities in planning, adapting and recovering from disasters. This measurement science is implemented on an open source platform called the Interdependent Networked Community Resilience Modeling Environment (IN-CORE). On IN-CORE, users can run scientific analyses that model the impact of natural hazards and community resilience against these impacts.

This Jupyter Notebook uses the Joplin, MO community and the historical 2011 EF-5 Tornado event as an example of how to use IN-CORE to analyze community resilience. The city of Joplin, Missouri, USA, was hit by an EF-5 tornado on May 22, 2011 (NIST Report). Note that IN-CORE supports various hazards including earthquake, tornado, tsunami, flood, and hurricane.

The notebook includes analyses of structural damage to buildings, electric power network damage, building functionality, economic impact on the community, population dislocation, household recovery, and retrofit options for buildings. It also demonstrates how to visualize the results of these analyses. These analyses are powered by pyIncore, a Python client for IN-CORE, which provides a high-level interface for interacting with IN-CORE services, offering specific models (e.g., representing a tornado) and ensuring a consistent and controlled interface.

Lastly, the core logic of this notebook is used to power the IN-CORE Community Resilience Playbook, an interactive guide for community resilience planning. It has been used in workshops with the city planners and government officials, making it a valuable resource for resilience planning.

Instructions

Register an IN-CORE account

Access to the IN-CORE service requires a user account. Registering for an account is free and open to everyone. This account gives you access to all of the public data on the system and allows you to create data that is only accessible by you. If applicable, it is recommended that you sign up with your institutional email. To register for an account, please go to:

Registration Link

IN-CORE login window

Install pyIncore and related packages

  1. Update Conda (if already installed):

    conda update conda

  2. Install Miniconda (if not already installed):

    Download the latest Miniconda3 installer from the Miniconda web page.

  3. Add Conda-Forge Channel:

    conda config --add channels conda-forge

  4. Create Python Environment:

    conda create -n pyincoreEnv python=3.9

  5. Activate Environment:

    conda activate pyincoreEnv

  6. Install pyIncore and pyIncore-viz:

    conda install -c in-core pyincore pyincore-viz

    If you have trouble installing pyincore and pyincore-viz, or it is taking a long time to resolve the dependencies, try using the libmamba solver by running the following command:

    conda install -c in-core pyincore pyincore-viz --solver=libmamba

  7. Install pyIncore-data (optional): This package is not used in the submitted notebook.

    conda install -c in-core pyincore-data

    If you have trouble installing pyincore-data, or it is taking a long time to resolve the dependencies, try using the libmamba solver by running the following command:

    conda install -c in-core pyincore-data --solver=libmamba

  8. Specify Version (if needed):

    conda install -c in-core pyincore=1.18.1

  9. Install Jupyter Notebook:

    conda install jupyter

Running Jupyter Notebook

  1. Start Jupyter Notebook:

    jupyter notebook

  2. Open Notebook: Open the notebook in-core_joplin_case_study.ipynb in your browser. If it doesn't open automatically, copy/paste the token provided in the terminal into your browser's navigation bar.

  3. Connect to IN-CORE When running the notebook, you will encounter the IN-CORE client instantiation. You will be prompted to provide your IN-CORE username and password. incore-client

For more information, visit:

Additional Resources