pelicun: Probabilistic Estimation of Losses, Injuries, and Community resilience Under Natural disasters (latest version 3.2)

Pelicun is a Python package that provides tools for assessment of damage and losses due to natural hazards. It uses a stochastic damage and loss model that is based on the methodology described in FEMA P58 (FEMA, 2012). While FEMA P58 aims to assess the seismic performance of a building, with pelicun we want to provide a more versatile, hazard-agnostic tool that will eventually provide loss estimates for other types of assets (e.g. bridges, facilities, pipelines) and lifelines. The underlying loss model was designed with these objectives in mind and it will be gradually extended to have such functionality.

Currently, the scenario assessment from the FEMA P58 methodology is built-in the tool. Detailed documentation of the available methods and their use is available at http://nheri-simcenter.github.io/pelicun

What can I use it for?

The current version of pelicun can be used to quantifiy lossess from an earthquake scenario in the form of decision variables. This functionality is typically utilized for performance based engineering or seismic risk assessment. There are several steps of seismic performance assessment that pelcicun can help with:

  • Describe the joint distribution of seismic response. The response of a structure or other type of asset to an earthquake is typically described by so-called engineering demand parameters (EDPs). pelicun provides methods that take a finite number of EDP vectors and find a multivarite distribution that describes the joint distribution of EDP data well.

  • Define the damage and loss model of a building. The component damage and loss data from FEMA P58 is provided with pelicun. This makes it easy to define building components without having to provide all the data manually. The stochastic damage and loss model is designed to facilitate modeling correlations between several parameters of the damage and loss model.

  • Estimate component damages. Given a damage and loss model and the joint distribution of EDPs, pelicun provides methods to estimate the quantity of damaged components and collapses.

  • Estimate consequences. Using information about collapses and component damages, the following consequences can be estimated with the loss model: reconstruction cost and time, unsafe placarding (red tag), injuries and fatalities. 

Why should I use it?

  1. It is free and it always will be. 
  2. It is open source. You can always see what is happening under the hood.
  3. It is efficient. The loss assessment calculations in pelicun use numpy and scipy libraries to efficiently propagate uncertainties and provide detailed results quickly.
  4. You can trust it. Every function in pelicun is tested after every commit. See the Travis-CI and Coveralls badges at the top for more info. 
  5. You can extend it. If you have other methods that you consider better than the ones we already offer, we encourage you to fork the repo, and extend pelicun with your approach. You do not need to share your extended version with the community, but if you are interested in doing so, contact us and we are more than happy to merge your version with the official release.

Relevant Webinars:


Live Expert Tips: April 22, 2022

Hazus-style, building-level performance
assessment" in Pelicun, Dr. Adam Zsarnóczay,

Stanford University

Live Expert Tips: February 18, 2022

Interactive Seismic Performance Assessment of Buildings in a Jupyter Environment using Pelicun
 


SimCenter User Workshop: August 11, 2020

2020 Joint WOW & SimCenter User Workshop: "Framework for Damage Fragility Models"

Join the User Forum Conversation:

  • submit questions and get answers
  • provide user feedback
  • post feature requests
  • get bug reports

 

How to cite:

Adam Zsarnoczay, John Vouvakis Manousakis, Pouria Kourehpaz, Jinyan Zhao, Kuanshi Zhong, Frank McKenna, Barbaros Cetiner, & kanwardhindsa. (2024). NHERI-SimCenter/pelicun: v3.2 (v3.2). Zenodo. https://doi.org/10.5281/zenodo.10720557

Major new features in v3.0:

  • The architecture was redesigned to better support interactive calculation and provide a low-level integration across all supported methods. This is the first release with the new architecture.
  • New assessment module introduced to replace control module.
  • Decoupled demand, damage, and loss calculations.
  • Integrated damage and loss calculation across all methods and components.
  • Introduced Options in the configuration file and in the base module.
  • Introduced consistent handling of units. Each csv table has a standard column to describe units of the data in it. If the standard column is missing, the table is assumed to use SI units.
  • Introduced consistent handling of pandas MultiIndex objects in headers and indexes. When tabular data is stored in csv files, MultiIndex objects are converted to simple indexes by concatenating the strings at each level and separating them with a -. This facilitates post-processing csv files in pandas without impeding post-processing those files in non-Python environments.
  • Updated the DL_calculation script to support the new architecture. Currently, only the config file input is used. Other arguments were kept in the script for backwards compatibility; future updates will remove some of those arguments and introduce new ones.
  • The log files were redesigned to provide more legible and easy-to-read information about the assessment.