7. 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.
7.1. General¶
# |
Description |
Source |
Priority |
Version |
---|---|---|---|---|
1 |
Existing Assessment Methods |
|||
1.1 |
Implement the high-fidelity FEMA-P58 loss assessment methodology |
GC |
||
1.1.1 |
Implement the scenario-based assessment from FEMA-P58 |
SP |
M |
1.0 |
1.1.2 |
Implement the time-based assessment from FEMA-P58 |
SP |
D |
|
1.2 |
Implement the efficient loss assessment methodologies from HAZUS |
GC |
||
1.2.1 |
Implement the assessment of buildings under earthquake hazard from HAZUS |
SP |
M |
1.1 |
1.2.4 |
Implement the assessment of buildings under hurricane wind hazard from HAZUS |
SP |
M |
2.0 |
1.2.5 |
Implement the assessment of buildings under storm surge hazard from HAZUS |
SP |
M |
|
1.2.6 |
Implement the assessment of a potable water network under earthquake hazard from HAZUS |
SP |
M |
2.0 |
1.3 |
Implement advanced methods for recovery time estimation |
UF |
||
2 |
Control |
|||
2.1 |
Analysis & Data |
|||
2.1.1 |
Allow users to set the number of realizations |
SP |
M |
1.0 |
2.1.2 |
Allow users to customize fragility and consequence function parameters |
SP |
D |
1.0 |
2.1.3 |
Allow users to specify dependencies between logically similar parts of the stochastic models |
SP |
D |
1.0 |
2.2 |
Response Model |
|||
2.2.1 |
Allow users to specify the added uncertainty to EDPs (increase in log-standard dev.) |
SP |
M |
1.0 |
2.2.2 |
Allow users to specify the EDP ranges that correspond to reliable simulation results |
SP |
D |
1.0 |
2.2.3 |
Allow users to specify the type of distribution they want to fit to the empirical EDP data |
UF |
D |
1.2 |
2.2.4 |
Allow users to choose if they want to fit a distribution only to the non-collapsed EDPs |
UF |
M |
1.2 |
2.3 |
Performance Model |
|||
2.3.1 |
Allow users to prescribe a different number of inhabitants on each floor |
SP |
D |
1.0 |
2.3.2 |
Allow users to customize the temporal distribution of inhabitants |
SP |
D |
1.0 |
2.3.3 |
Allow users to prescribe different component quantities for each floor in each direction |
SP |
D |
1.0 |
2.3.4 |
Allow users to specify the number of component groups and their quantities in each performance group |
UF |
D |
1.0 |
2.4 |
Damage Model |
|||
2.4.1 |
Allow users to specify the residual drift limits that determine irrepairability |
SP |
D |
1.0 |
2.4.2 |
Allow users to specify the yield drift value that is used to estimate residual drifts from peak drifts |
SP |
D |
1.0 |
2.4.3 |
Allow users to specify the EDP limits that are used to determine collapse probability |
SP |
D |
1.0 |
2.4.4 |
Allow users to specify arbitrary collapse modes and their likelihood |
SP |
D |
1.0 |
2.4.5 |
Allow users to prescribe the collapse probability of the structure |
UF |
M |
1.2 |
2.5 |
Loss Model |
|||
2.5.1 |
Allow users to decide which DVs to calculate |
SP |
D |
1.0 |
2.5.2 |
Allow users to specify the likelihood of various injuries in each collapse mode |
SP |
D |
1.0 |
7.2. Databases & Files¶
# |
Description |
Source |
Priority |
Version |
---|---|---|---|---|
3 |
Data Sources |
|||
3.1 |
Make the component fragility and consequence functions from FEMA P58 available |
SP |
M |
|
3.1.1 |
FEMA P58 First Edition |
SP |
M |
1.0 |
3.1.1 |
FEMA P58 Second Edition |
UF |
M |
2.0 |
3.2 |
Make the building fragility and consequence functions from HAZUS available |
SP |
M |
|
3.2.1 |
HAZUS earthquake damage, reconstruction cost and time |
SP |
M |
1.1 |
3.2.2 |
HAZUS hurricane wind damage, reconstruction cost and time |
SP |
M |
2.0 |
3.2.3 |
HAZUS storm surge damage, reconstruction cost and time |
SP |
M |
|
4 |
Data Storage |
|||
4.1 |
Generic JSON format |
SP |
M |
|
4.1.1 |
Develop a generic JSON data format for component fragility and consequence functions |
SP |
D |
1.1 |
4.1.2 |
Store FEMA P58 and HAZUS component data in the new JSON format and make them available |
SP |
D |
1.1 |
4.2 |
UnQLite Database |
SP |
M |
|
4.2.1 |
Store the JSON files in an UnQLite database for each data source |
SP |
M |
2.1 |
7.3. Stochastic Models¶
# |
Description |
Source |
Priority |
Version |
---|---|---|---|---|
5 |
Response Model |
|||
5.1 |
EDP (re-)sampling |
|||
5.1.1 |
Enable coupled assessment by using raw EDP values as-is |
UF |
M |
1.2 |
6 |
Performance Model |
|||
7 |
Damage Model |
|||
7.1 |
Collapse estimation |
|||
7.1.1 |
Estimate collapse probability of the structure using EDP limits and the joint distribution of EDPs |
SP |
D |
1.0 |
7.1.2 |
Estimate the collapse probability of the structure using empirical (raw) EDP data |
UF |
M |
1.2 |
8 |
Loss Model |
|||
8.1 |
Consequence functions for buildings |
|||
8.1.1 |
Implement functions for reconstruction cost and time as per FEMA P58 |
SP |
M |
1.0 |
8.1.2 |
Implement functions for red tag triggering as per FEMA P58 |
SP |
M |
1.0 |
8.1.3 |
Implement functions for injuries and fatalities as per FEMA P58 |
SP |
M |
1.0 |
8.1.4 |
Implement functions for reconstruction cost and time as per HAZUS earthquake |
SP |
M |
1.1 |
8.1.5 |
Implement functions for debris as per HAZUS earthquake |
SP |
D |
|
8.1.6 |
Implement functions for business interruption as per HAZUS earthquake |
SP |
D |
|
8.1.7 |
Implement functions for reconstruction cost and time as per HAZUS wind |
SP |
M |
2.0 |
8.1.8 |
Implement functions for reconstruction cost and time as per HAZUS storm surge |
SP |
M |
2.0 |
8.2 |
Consequence functions for other assets |
|||
8.1.4 |
Implement functions for reconstruction cost and time for potable water pipes as per HAZUS earthquake |
SP |
M |
2.0 |