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

Table 7.1.1 Requirements - 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

Table 7.2.1 Requirements - 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

Table 7.3.1 Requirements - 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