Requirements¶
The following contains the functional requirements for the pelicun library. These requirements are broken down into a number of groups, and UQ.
The purpose of presenting these requirements is to inform the community on the present capabilities of the pelicun library and features that could be added. The original set of requirements have come from a set of grand challenge reports, GC. These original requirements have been broken into a smaller set of deliverable features by the senior faculty associated with the project, SP. Additional requirements have come from users, U See section features if you have additional features you would like to see.
General Requirements¶
# |
Description |
Source |
Priority |
Version |
---|---|---|---|---|
EE1 |
Ability to determine response of Building Subject to Earthquake hazard including formal treatment of randomness and uncertainty uncertainty |
GC |
M |
1.0 |
EE2 |
Ability of Practicing Engineers to use multiple coupled resources (applications, databases, viz tools) in engineering practice |
GC |
M |
1.0 |
EE3 |
Ability to utilize resources beyond the desktop including HPC |
GC |
M |
1.0 |
EE4 |
Tool should incorporate data from www |
GC |
M |
1.0 |
EE5 |
Tool available for download from web |
GC |
M |
1.0 |
EE6 |
Ability to benefit from programs that move research results into practice and obtain training |
GC |
M |
|
EE7 |
Ability to use educational provisions to gain interdisclipinary education so as to gain expertise in earth sciences and physics, engineering mechanics, geotechnical engineering, and structural engineering in order to be qualified to perform these simulations |
GC |
D |
|
EE8 |
Documentation exists on tool usage |
SP |
M |
1.1 |
EE9 |
Video Exists demonstrating usage |
SP |
M |
1.1 |
EE10 |
Verification Examples Exist |
SP |
M |
1.1 |
EE11 |
Validation Examples Exist, validated against tests or other software |
GC |
M |
|
EE12 |
Tool to allow user to load and save user inputs |
SP |
M |
1.0 |
EE13 |
Add to Standard Earthquake a variable indicating analysis failure |
UF |
D |
|
EE14 |
Installer which installs application and all needed software |
UF |
D |
Loading Requirements¶
# |
Description |
Source |
Priority |
Version |
---|---|---|---|---|
EL |
Ability to select from different Earthquake Input Motion Options |
SP |
M |
1.0 |
EL1 |
Ability to select from Multiple input motions and view UQ due to all the discrete events |
GC |
M |
1.0 |
EL2 |
Ability to select from list of SimCenter motions |
SP |
M |
1.0 |
EL3 |
Ability to select from list of PEER motions |
SP |
D |
1.0 |
EL4 |
Ability to use OpenSHA and selection methods to generate motions |
UF |
D |
1.0 |
EL5 |
Ability to Utilize Own Application in Workflow |
SP |
M |
1.0 |
EL6 |
Ability to use Broadband |
SP |
D |
|
EL7 |
Ability to include Soil Structure Interaction Effects |
GC |
M |
1.1 |
EL7.1 |
1D nonlinear site response with effective stress analysis |
SP |
M |
1.1 |
EL7.2 |
Nonlinear site response with bidirectional loading |
SP |
M |
1.2 |
EL7.3 |
Nonlinear site response with full stochastic characterization of soil layers |
SP |
M |
|
EL7.4 |
Nonlinear site response, bidirectional different input motions |
SP |
M |
|
EL7.5 |
Ability to couple models from point of rupture through rock and soil into structure, which represents future of professional design practice |
GC |
M |
|
EL7.5.1 |
Interface using DRM method |
SP |
M |
|
EL8 |
Utilize PEER NGA www ground motion selection tool |
UF |
D |
2.0 |
EL9 |
Ability to select from synthetic ground motions |
SP |
M |
1.0 |
EL9.1 |
per Vlachos, Papakonstantinou, Deodatis (2017) |
SP |
D |
1.1 |
EL9.2 |
per Dabaghi, Der Kiureghian (2017) |
UF |
D |
2.0 |
UQ Requirements¶
# |
Description |
Source |
Priority |
Version |
---|---|---|---|---|
UM |
Ability to use various UQ Methods |
GC |
M |
|
UM1 |
Forward Propagation Methods |
GC |
M |
1.0 |
UM1.1 |
Ability to use basic Monte Carlo and LHS methods |
SP |
M |
1.0 |
UM1.2 |
Ability to use Importance Sampling |
SP |
M |
2.0 |
UM1.3 |
Ability to use Gaussian Process Regression |
SP |
M |
2.0 |
UM1.4 |
Ability to use Own External UQ Engine |
SP |
M |
|
UM2 |
Ability to use various Reliability Methods |
UF |
M |
1.0 |
UM2.1 |
Ability to use First Order Reliability method |
UF |
M |
|
UM2.2 |
Ability to use Second Order Reliability method |
UF |
M |
|
UM2.2 |
Ability to use Surrogate Based Reliability |
UF |
M |
|
UM2.3 |
Ability to use Own External Application to generate Results |
UF |
M |
|
UM3 |
Ability to user various Sensitivity Methods |
UF |
M |
1.0 |
UM3.1 |
Ability to obtain Global Sensitivity Sobol’s indices |
UF |
M |
|
UV1 |
Various Random Variable Probability Distributions |
SP |
M |
1.0 |
UV1.1 |
Normal |
SP |
M |
1.0 |
UV1.2 |
Lognormal |
SP |
M |
1.0 |
UV1.3 |
Uniform |
SP |
M |
1.0 |
UV1.4 |
Beta |
SP |
M |
1.0 |
UV1.5 |
Weibull |
SP |
M |
1.0 |
UV1.6 |
Gumbel |
SP |
M |
1.0 |
UV2 |
User defined Distribution |
SP |
M |
|
UV3 |
Define Correlation Matrix |
SP |
M |
|
UV4 |
Random Fields |
SP |
M |
|
UV5 |
Ability to View Graphically the density function when defining the RV |
UF |
D |
|
Modeling Requirements¶
# |
Description |
Source |
Priority |
Version |
---|---|---|---|---|
BM |
Ability to select different Building Model Generators |
GC |
M |
1.0 |
BM1 |
Ability to quickly create a simple nonlinear building model for simple methods of seismic evaluation |
GC 2.T13 |
D |
1.1 |
BM2 |
Ability to use existing OpenSees model scripts |
SP |
M |
1.0 |
BM3 |
Ability to define building and use Expert System to generate FE mesh |
SP |
||
BM3.1 |
Expert system for Concrete Shear Walls |
SP |
M |
|
BM3.2 |
Expert system for Moment Frames |
SP |
M |
|
BM3.3 |
Expert system for Braced Frames |
SP |
M |
|
BM4 |
Ability to define building and use Machine Learning applications to generate FE |
GC |
||
BM4.1 |
Machine Learning for Concrete Shear Walls |
SP |
M |
|
BM4.2 |
Machine Learning for Moment Frames |
SP |
M |
|
BM4.3 |
Machine Learning for Braced Frames |
SP |
M |
|
BM5 |
Ability to specify connection details for member ends |
UF |
M |
2.2 |
BM6 |
Ability to define a user-defined moment-rotation response representing the connection details |
UF |
D |
2.2 |
Analysis Requirements¶
# |
Description |
Source |
Priority |
Version |
---|---|---|---|---|
BA1 |
Ability to select from different Nonlinear Analysis options |
GC |
M |
1.0 |
BA2 |
Ability to specify OpenSees as FEM engine and to specify different analysis options |
SP |
M |
1.0 |
BA3 |
Ability to provide own OpenSees Analysis script to OpenSees engine. |
SP |
D |
1.0 |
BA4 |
Ability to provide own Python script and use OpenSeesPy engine. |
SP |
O |
1.2 |
BA5 |
Ability to use alternative FEM engines. |
SP |
M |
|
BA6 |
Ability to know if an analysis run fails. |
UF |
M |
|
BA7 |
Ability to specify Modal Damping. |
UF |
M |
|
BA8 |
Ability to specify damping ratio as a random variable |
UF |
M |
|
BA9 |
When using Rayleigh Damping, ability to specify the two modes used to calculate damping parameters |
UF |
M |
|
BA10 |
Ability to run for more than 60hours at DesignSafe |
UF |
D |
|
BA11 |
Ability to specify number of iterations in convergence test |
UF |
M |