Pelicun Requirements

pelicun is a framework for calculating damage and loss to an assest associated with an event. The requirements are related to sections 1.3.6 of the SimCenter WBS.

General

Requirements - General

#

Description

Source

Priority

Version

WBS

P.1

Existing Assessment Methods

P.1.1

Implement the high-resolution loss assessment methodologies

GC

P.1.1.1

Implement the scenario-based assessment from FEMA-P58

SP

M

Implemented

P.1.1.2

Implement the time-based assessment from FEMA-P58

SP

D

InProgress

1.1.3.5

P.1.1.3

Implement high-resolution assessment of buildings under wind hazards

SP

M

InProgress

1.1.3.5

P.1.1.4

Implement high-resolution assessment of buildings under water hazards

SP

M

InProgress

1.1.3.5

P.1.1.5

Implement high-resolution assessment of transportation networks

SP

M

InProgress

1.1.3.5

P.1.1.6

Implement high-resolution assessment of buried pipelines

SP

M

InProgress

1.1.3.5

P.1.2

Implement the efficient loss assessment methodologies from HAZUS

GC

InProgress

1.1.3.4

P.1.2.1

Implement the assessment of buildings under earthquake hazard from HAZUS

SP

M

Implemented

P.1.2.2

Implement the assessment of buildings under hurricane wind hazard from HAZUS

SP

M

Implemented

P.1.2.3

Implement the assessment of buildings under storm surge hazard from HAZUS

SP

M

P.1.2.4

Implement the assessment of buried pipelines under earthquake hazard from HAZUS

SP

M

InProgress

1.1.3.4.3

P.1.2.5

Implement the assessment of transportation networks under earthquake hazard from HAZUS

SP

M

InProgress

P.1.2.6

Implement the assessment of power networks under earthquake hazard from HAZUS

SP

M

InProgress

P.2

Control

P.2.1

Analysis & Data

P.2.1.1

Allow users to set the number of realizations

SP

M

Implemented

P.2.1.2

Allow users to customize fragility and consequence function parameters

SP

D

Implemented

P.2.1.3

Allow users to specify dependencies between logically similar parts of the stochastic models

SP

D

Implemented

P.2.2

Response Model

P.2.2.1

Allow users to specify the added uncertainty to EDPs (increase in log-standard dev.)

SP

M

Implemented

P.2.2.2

Allow users to specify the EDP ranges that correspond to reliable simulation results

SP

D

Implemented

P.2.2.3

Allow users to specify the type of distribution they want to fit to the empirical EDP data

UF

D

Implemented

P.2.2.4

Allow users to choose if they want to fit a distribution only to the non-collapsed EDPs

UF

M

Implemented

P.2.3

Performance Model

P.2.3.1

Allow users to prescribe a different number of inhabitants on each floor

SP

D

Implemented

P.2.3.2

Allow users to customize the temporal distribution of inhabitants

SP

D

Implemented

P.2.3.3

Allow users to prescribe different component quantities for each floor in each direction

SP

D

Implemented

P.2.3.4

Allow users to specify the number of component groups and their quantities in each performance group

UF

D

Implemented

P.2.4

Damage Model

P.2.4.1

Allow users to specify the residual drift limits that determine irrepairability

SP

D

Implemented

P.2.4.2

Allow users to specify the yield drift value that is used to estimate residual drifts from peak drifts

SP

D

Implemented

P.2.4.3

Allow users to specify the EDP limits that are used to determine collapse probability

SP

D

Implemented

P.2.4.4

Allow users to specify arbitrary collapse modes and their likelihood

SP

D

Implemented

P.2.4.5

Allow users to prescribe the collapse probability of the structure

UF

M

Implemented

P.2.5

Loss Model

P.2.5.1

Allow users to decide which DVs to calculate

SP

D

Implemented

P.2.5.2

Allow users to specify the likelihood of various injuries in each collapse mode

SP

D

Implemented

P.3

Hazard Model

InProgress

1.1.3.3

P.3.1

Hazard Occurrence Rate

P.3.1.1

Enable estimation of the likelihood of earthquake events

SP

M

P.3.1.2

Enable estimation of the likelihood of wind events

SP

M

P.3.1.3

Enable estimation of the likelihood of storm surge events

SP

M

P.3.1.4

Enable estimation of the likelihood of tsunami events

SP

M

P.4

Response Model

InProgress

1.1.3.5

P.4.1

EDP (re-)sampling

P.4.1.1

Enable coupled assessment by using raw EDP values as-is

UF

M

Implemented

P.4.1.2

Enable non-Gaussian EDP distributions

UF

D

P.4.2

EDP Identification

P.4.2.1

Implement automatic identification of required EDP types based on the performance model

SP

M

P.5

Performance Model

P.5.1

Auto-population of performance models

P.5.1.1

Implement framework to enable user-defined auto-population scripts

UF

D

Implemented

P.5.1.2

Prepare script to perform auto-population based on normative quantities in FEMA P58

UF

D

P.6

Damage Model

InProgress

1.1.3.5

P.6.1

Collapse estimation

P.6.1.1

Estimate collapse probability of the structure using EDP limits and the joint distribution of EDPs

SP

D

Implemented

P.6.1.2

Estimate the collapse probability of the structure using empirical (raw) EDP data

UF

M

Implemented

P.6.1.3

Enable user-defined collapse probability

UF

M

Implemented

P.6.2

Building Damage

P.6.2.1

Implement earthquake fragility functions for building components from FEMA P58

SP

M

Implemented

P.6.2.2

Implement earthquake fragility functions for buildings from HAZUS

SP

M

Implemented

P.6.2.3

Implement wind fragility functions for buildings from HAZUS

SP

M

Implemented

P.6.2.4

Implement inundation fragility functions for buildings from HAZUS

SP

M

Implemented

P.6.2.5

Implement high-resolution wind fragility functions for building components

SP

M

InProgress

1.1.3.5.1

P.6.2.6

Implement high-resolution inundation fragility functions for building components

SP

M

InProgress

1.1.3.5.2

P.6.3

Lifeline Damage

P.6.3.1

Implement earthquake fragility functions for buried pipelines from HAZUS

SP

M

InProgress

1.1.3.5.4

P.6.3.2

Implement earthquake fragility functions for bridges from HAZUS

SP

M

InProgress

P.6.3.3

Implement earthquake fragility functions for power networks from HAZUS

SP

M

P.6.3.4

Implement high-resolution fragility functions for buried pipelines

SP

M

InProgress

1.1.3.5.4

P.6.3.5

Implement high-resolution fragility functions for transportation networks

SP

M

InProgress

1.1.3.5.3

P.6.4

Cascading Damages

P.6.4.1

Implement fault tree-based cascading damage model

SP

M

InProgress

1.1.3.5

P.7

Loss Model

P.7.1

Consequence functions for buildings

P.7.1.1

Implement functions for repair cost and time as per FEMA P58

SP

M

Implemented

P.7.1.2

Implement functions for red tag triggering as per FEMA P58

SP

M

Implemented

P.7.1.3

Implement functions for injuries and fatalities as per FEMA P58

SP

M

Implemented

P.7.1.4

Implement functions for repair cost and time as per HAZUS earthquake

SP

M

Implemented

P.7.1.5

Implement functions for debris as per HAZUS earthquake

SP

D

P.7.1.6

Implement functions for business interruption as per HAZUS earthquake

SP

D

P.7.1.7

Implement functions for repair cost and time as per HAZUS wind

SP

M

Implemented

P.7.1.8

Implement functions for repair cost and time as per HAZUS inundation

SP

M

P.7.1.9

Implement functions for environmental impact estimation as per FEMA P58 2nd edition

SP

M

Implemented

1.1.4.3

P.7.1.10

Implement functions for high-resolution repair cost and time assessment for wind hazards

SP

M

InProgress

1.1.3.5.1

P.7.1.11

Implement functions for high-resolution repair cost and time assessment for water hazards

SP

M

InProgress

1.1.3.5.2

P.7.2

Consequence functions for other assets

P.7.2.1

Implement functions for repair cost and time for buried pipelines as per HAZUS earthquake

SP

M

Implemented

P.7.2.2

Implement functions for repair cost and time for bridges as per HAZUS earthquake

SP

M

InProgress

1.1.3.4.3

P.7.2.3

Implement functions for repair cost and time for power networks as per HAZUS earthquake

SP

M

P.7.2.4

Implement high-resolution functions for repair cost and time for transportation networks

SP

M

InProgress

1.1.3.5.3

P.7.2.5

Implement high-resolution functions for repair cost and time for buried pipelines

SP

M

InProgress

1.1.3.5.4

Key:
Source: GC=Needed for Grand Challenges, SP=Senior Personnel, UF=User Feedback
Priority: M=Mandatory, D=Desirable, P=Possible Future
Status: Implemented, InProgress, and Blank (i.e. not started)
Implementation: UM=User Manual, DM=Developer Manual, SC=Source Code

Databases & Files

Requirements - Databases & Files

#

Description

Source

Priority

Version

WBS

DLD

Database for Damage and Loss Fragilities and Consequence Functions: Loss computations use fragility and consequence functions for modern and archaic structural and nonstructural components and assem- blies in structures. The database of such functions for components and assemblies is small and must be expanded through coordinated numerical and experimental simulations

GC

M

DLD.1

Data Sources

DLD.1.1

Make the component fragility and consequence functions from FEMA P58 available

SP

M

DLD.1.1.1

FEMA P58 First Edition

SP

M

Implemented

DLD.1.1.2

FEMA P58 Second Edition

UF

M

Implemented

DLD.1.1.3

Extend FEMA P58 Second Edition consequence functions with environmental impact parameters

SP

M

DLD.1.2

Make the building fragility and consequence functions from HAZUS available

SP

M

DLD.1.2.1

HAZUS earthquake damage and reconstruction cost and time

SP

M

Implemented

DLD.1.2.2

HAZUS hurricane wind damage and reconstruction cost and time

SP

M

Implemented

DLD.1.2.3

HAZUS storm surge damage and reconstruction cost and time

SP

M

DLD.1.3

Make the lifeline fragility and consequence functions from HAZUS available

SP

M

DLD.1.3.1

HAZUS bridge damage and reconstruction cost and time

SP

M

DLD.1.3.2

HAZUS buried pipeline damage and reconstruction cost and time

SP

M

DLD.1.3.3

HAZUS power network damage and reconstruction cost and time

SP

M

DLD.1.4

Extend available high-resolution building damage and loss model parameters

SP

M

DLD.1.4.1

Building damage and loss model parameters under wind hazards

SP

M

DLD.1.4.2

Building damage and loss model parameters under water hazards

SP

M

DLD.1.5

Make high-resolution damage and loss model parameters available for lifelines

SP

M

DLD.1.5.1

Transportation network damage and loss model parameters

SP

M

DLD.1.5.2

Buried pipeline network damage and loss model parameters

SP

M

DLD.2

Data Storage

DLD.2.1

Generic JSON format

SP

M

DLD.2.1.1

Develop a generic JSON data format for component fragility and consequence functions

SP

D

Implemented

DLD.2.1.2

Store FEMA P58 and HAZUS component data in the new JSON format and make them available

SP

D

Implemented

DLD.2.2

HDF5 Data Storage

SP

M

DLD.2.2.1

Store the JSON files in an HDF5 data structure for each data source

SP

M

Implemented

DLD.2.3

Online Database

SP

M

DLD.2.3.1

Create an online database for storing parameters of damage and loss models for buildings

SP

M

DLD.2.3.2

Extend online database to store parameters of damage and loss models for transportation networks

SP

M

DLD.2.3.3

Extend online database to store parameters of damage and loss models for buried pipeline networks

SP

M

DLD.2.3.4

Populate building database with high-resolution model parameters from researchers

SP

M

DLD.2.3.5

Populate lifeline database with high-resolution model parameters from researchers

SP

M

Key:
Source: GC=Needed for Grand Challenges, SP=Senior Personnel, UF=User Feedback
Priority: M=Mandatory, D=Desirable, P=Possible Future
Status: Implemented, InProgress, and Blank (i.e. not started)
Implementation: UM=User Manual, DM=Developer Manual, SC=Source Code