4. Requirements¶
The following table outlines the features that are currently available in pelicun and the requirements that will drive future development. We present these requirements to inform the community about our plans. We welcome suggestions for useful features that are missing from the list below. Go to Bugs & Feature Requests (:numref:lblBugs) to let us know about additional features you would like to see.
The original set of requirements came from grand challenge reports (GC). These were broken into smaller sets of deliverable features by senior faculty associated with the project (SP). Additional requirements have come from users through the User Forum, (UF). See section features if you have additional features you would like to see.
The priority column provides information about the relative importance of the features: M - mandatory, D - desirable, O - optional, P - possible.
4.1. General¶
# |
Description |
Source |
Priority |
Version |
|---|---|---|---|---|
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 |
|
P.1.1.3 |
Implement high-resolution assessment of buildings under wind hazards |
SP |
M |
|
P.1.1.4 |
Implement high-resolution assessment of buildings under water hazards |
SP |
M |
|
P.1.1.5 |
Implement high-resolution assessment of transportation networks |
SP |
M |
|
P.1.1.6 |
Implement high-resolution assessment of buried pipelines |
SP |
M |
|
P.1.2 |
Implement the efficient loss assessment methodologies from HAZUS |
GC |
||
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 |
|
P.1.2.5 |
Implement the assessment of transportation networks under earthquake hazard from HAZUS |
SP |
M |
|
P.1.2.6 |
Implement the assessment of power networks under earthquake hazard from HAZUS |
SP |
M |
|
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 |
|||
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 |
|||
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 |
|||
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 |
|
P.6.2.6 |
Implement high-resolution inundation fragility functions for building components |
SP |
M |
|
P.6.3 |
Lifeline Damage |
|||
P.6.3.1 |
Implement earthquake fragility functions for buried pipelines from HAZUS |
SP |
M |
|
P.6.3.2 |
Implement earthquake fragility functions for bridges from HAZUS |
SP |
M |
|
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 |
|
P.6.3.5 |
Implement high-resolution fragility functions for transportation networks |
SP |
M |
|
P.6.4 |
Cascading Damages |
|||
P.6.4.1 |
Implement fault tree-based cascading damage model |
SP |
M |
|
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 |
|
P.7.1.10 |
Implement functions for high-resolution repair cost and time assessment for wind hazards |
SP |
M |
|
P.7.1.11 |
Implement functions for high-resolution repair cost and time assessment for water hazards |
SP |
M |
|
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 |
|
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 |
|
P.7.2.5 |
Implement high-resolution functions for repair cost and time for buried pipelines |
SP |
M |
4.2. Databases & Files¶
# |
Description |
Source |
Priority |
Version |
|---|---|---|---|---|
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 |