5. Requirements¶
The following contains the functional requirements for the EE-UQ application. These requirements are broken down into a number of groups, general, earthquake loading, building description, analysis, and UQ.
The purpose of presenting these requirements is to inform the community on the present capabilities of the EE-UQ application 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 through the User Forum, UF. See section Feature Requests if you have additional features you would like to see.
5.1. General Requirements¶
# |
Description |
Source |
Priority |
Status |
Implementation |
|---|---|---|---|---|---|
EE |
Application to determine response of Building Subject to Earthquake hazard including formal treatment of randomness and uncertainty |
GC |
M |
Implemented |
|
EE.1 |
Ability to select from Earthquake Loading Options listed in EL2 |
SP |
M |
Implemented |
|
EE.2 |
Ability to select from Building Modeling Options listed in MOD under BM |
SP |
M |
Implemented |
|
EE.3 |
Ability to select from nonlinear analysis options listed in ANA |
SP |
M |
Implemented |
|
EE.4 |
Ability to use Various UQ Methods and Variable Options** |
||||
EE.4.1 |
Ability to use Forward Propagtion methods listed in UQ under UF |
SP |
M |
Implemented |
|
EE.4.2 |
Ability to use Random Variable Distributions defined in RV |
SP |
M |
Implemented |
|
EE.4.3 |
Ability to use Reliability Methods listed in UQ under UR |
SP |
M |
Implemented |
|
EE.4.4 |
Ability to use Global Sensitivity Methods listed in UQ under UG |
SP |
M |
Implemented |
|
EE.4.5 |
Ability to both use and create surrogates listed in UQ under US |
SP |
M |
Implemented |
|
EE.4.6 |
Ability to use High Dimensional UQ listed in UQ under UH |
SP |
M |
||
EE.5 |
Ability to Visualize the Results |
SP |
M |
Implemented |
|
EE.5.1 |
Ability to view individual sample results |
SP |
M |
Implemented |
|
EE.5.2 |
Ability to graphically view the results to show distribution in response |
SP |
M |
Implemented |
|
EE.6 |
Miscellaneous User Requests |
||||
EE.6.1 |
Add to Standard Earthquake a variable indicating analysis failure |
UF |
D |
||
EE.6.3 |
Run application from command line, include option to run remotely |
UF |
D |
||
EE.7 |
General Software Requirements |
||||
EE.7.1 |
Application to Provide Common SimCenter Research Application Requirements listed in CR |
GC |
M |
InProgress |
|
EE.8 |
Tool should incorporate data from www |
GC |
M |
Implemented |
|
EE.8.1 |
Tool should obtain motion input data from www |
SP |
M |
Implemented |
|
EE.8.2 |
Tool should obtain building modelling info from database through www |
SP |
D |
5.2. Loading Requirements¶
# |
Description |
Source |
Priority |
Status |
Implementation |
|---|---|---|---|---|---|
EL.1 |
Regional Scale Earthquake Hazard Simulation Options |
_ |
_ |
_ |
_ |
EL.1.1 |
Coupling of multi-scale nonlinear models from the point of rupture through rock and soil into structure |
_ |
_ |
_ |
_ |
EL.1.1.1 |
Replacement of empirical linear models with multi-scale nonlinear models |
GC |
D |
_ |
_ |
EL.1.1.2 |
Include both multi-scale and multi-phase (account for liquefaction) |
GC |
M |
InProgress |
_ |
EL.1.1.3 |
Interface between asset and regional simulations using site response method |
SP |
M |
Implemented |
_ |
EL.1.1.4 |
Interface between asset and regional simulations using DRM method |
SP |
M |
InProgress |
_ |
EL.1.2 |
Method to include both the intra-event residual and inter-event residual in simulating spatial correlated ground motion intensity measures with multiple correlation model options. Select site-specific ground motions from PEER to match target intensity |
SP |
M |
Implemented |
_ |
EL.1.3 |
Use GIS-Specified Matrix of Recorded Motions |
SP |
M |
Implemented |
_ |
EL.2 |
Select from Multiple Local Scale Earthquake Hazard Options |
_ |
_ |
_ |
_ |
EL.2.1 |
Interact with PEER NGA |
SP |
M |
Implemented |
_ |
EL.2.1.1 |
Select using default selection options |
SP |
D |
Implemented |
|
EL.2.1.2 |
Select using all options available at PEER site |
UF |
D |
Implemented |
|
EL.2.1.3 |
Select using user-supplied spectrum |
UF |
D |
Implemented |
|
EL.2.2 |
Ability to select utilizing PEER NGA_West web service |
SP |
D |
Implemented |
|
EL.2.3 |
Ability to select from a list of user-supplied PEER motions |
SP |
M |
Implemented |
|
EL.2.4 |
Ability to select from a list of SimCenter motions |
SP |
M |
Implemented |
|
EL.2.5 |
Ability to use OpenSHA and selection methods to generate motions |
UF |
D |
Implemented |
_ |
EL.2.6 |
Ability to Utilize Own Application in Workflow |
SP |
M |
_ |
|
EL.2.7 |
Ability to include Soil-Structure Interaction Effects |
_ |
_ |
_ |
_ |
EL.2.7.1 |
1D nonlinear site response with effective stress analysis |
SP |
M |
Implemented |
|
EL.2.7.2 |
Nonlinear site response with bidirectional loading |
SP |
M |
Implemented |
|
EL.2.7.3 |
Nonlinear site response with full stochastic characterization of soil layers |
SP |
M |
Implemented |
|
EL.2.7.4 |
Nonlinear site response bidirectional different input motions |
SP |
M |
_ |
|
EL.2.8 |
Ability to generate synthetic ground motions |
_ |
_ |
_ |
_ |
EL.2.8.1 |
per Vlachos Papakonstantinou Deodatis (2017) |
SP |
D |
Implemented |
|
EL.2.8.2 |
per Dabaghi Der Kiureghian (2017) |
UF |
D |
Implemented |
|
EL.2.9 |
Ability to select from synthetic ground motions |
SP |
M |
Implemented |
|
EL.2.10 |
Ability to select surrogate modeling events |
SP |
M |
Implemented |
5.3. Modeling Requirements¶
# |
Description |
Source |
Priority |
Status |
Implementation |
|---|---|---|---|---|---|
MOD |
Asset Model Generators for Analysis |
||||
BM |
Asset Model Generators for Buildings |
||||
BM.1 |
Ability to quickly create a simple nonlinear building model |
GC |
D |
Implemented |
|
BM.2 |
Ability to use existing OpenSees model scripts |
SP |
M |
Implemented |
|
BM.3 |
Ability to define a building and use Expert System to generate FE mesh |
SP |
D |
Implemented |
|
BM.4 |
Ability to define a building and use Machine Learning applications to generate FE |
GC |
D |
_ |
_ |
BM.5 |
Ability to specify connection details for member ends |
UF |
D |
_ |
_ |
BM.6 |
Ability to define a user-defined moment-rotation response representing the connection details |
UF |
D |
_ |
_ |
BM.7 |
Ability to incorporate AutoSDA Steel Design Application in Local Applications |
UF |
M |
Implemented |
|
BM.8 |
Ability to use user-supplied Python script to generate mesh |
UF |
M |
InProgress |
|
BM.9 |
Ability to use multiple models of similar fidelity |
SP |
M |
Implemented |
|
BM.10 |
Ability to use multiple models of different fidelity |
SP |
M |
Implemented |
5.4. Analysis Requirements¶
# |
Description |
Source |
Priority |
Status |
Implementation |
|---|---|---|---|---|---|
ANA.1 |
Ability to select from different Nonlinear Analysis options |
_ |
_ |
_ |
_ |
ANA.1.1 |
Ability to specify OpenSees as FEM engine and to specify different analysis options |
SP |
M |
Implemented |
|
ANA.1.2 |
Ability to provide own OpenSees Analysis script to OpenSees engine |
SP |
D |
Implemented |
|
ANA.1.3 |
Ability to provide own Python script and use OpenSeesPy engine |
SP |
D |
_ |
_ |
ANA.1.4 |
Ability to use alternative FEM engines |
SP |
M |
_ |
_ |
ANA.2 |
Ability to know if an analysis run fails |
UF |
M |
_ |
_ |
ANA.3 |
Ability to specify Modal Damping |
_ |
_ |
_ |
_ |
ANA.3.1 |
Ability to specify damping ratio as a random variable |
UF |
M |
Implemented |
|
ANA.3.2 |
When using Rayleigh Damping, ability to specify the two modes used to calculate damping parameters |
UF |
M |
Implemented |
|
ANA.4 |
Ability to run for more than 60 hours at DesignSafe |
UF |
D |
_ |
_ |
ANA.5 |
Ability to specify the number of iterations in convergence test |
UF |
M |
Implemented |
|
ANA.6 |
Ability to use multiple analysis options |
SP |
M |
Implemented |
5.5. UQ Requirements¶
# |
Description |
Source |
Priority |
Status |
Implementation |
|---|---|---|---|---|---|
UF.1 |
Ability to use basic Monte Carlo and LHS methods |
SP |
M |
Implemented |
|
UF.2 |
Ability to use Gaussian Process Regression |
SP |
M |
Implemented |
|
UF.3 |
Ability to use Multi-Scale Monte Carlo |
SP |
M |
_ |
_ |
UF.4 |
Ability to use Multi-Fidelity Models |
SP |
M |
Implemented |
|
UF.5 |
Ability to use Multi-model Forward Propagation |
UF |
D |
Implemented |
|
UR.1 |
Ability to use First Order Reliability method |
SP |
M |
Implemented |
|
UR.2 |
Ability to use Second Order Reliability method |
SP |
M |
Implemented |
|
UR.3 |
Ability to use Surrogate Based Reliability |
SP |
M |
Implemented |
|
UR.4 |
Ability to use Importance Sampling |
SP |
M |
Implemented |
|
UG.1 |
Ability to obtain Global Sensitivity Sobol indices |
UF |
M |
Implemented |
|
UG.2 |
Ability to use probability model-based global sensitivity analysis (PM-GSA) |
SP |
M |
Implemented |
|
UG.3 |
Ability to use probability model-based global sensitivity analysis (PM-GSA) for high-dimensional outputs |
UF |
D |
Implemented |
|
US.1 |
Ability to Construct Gaussian Process (GP) Regression Model from a Simulation Model |
SP |
M |
Implemented |
|
US.2 |
Ability to Construct GP Regression Model from Input-output Dataset |
SP |
M |
Implemented |
|
US.3 |
Ability to use Surrogate Model for UQ Analysis |
SP |
M |
Implemented |
|
US.4 |
Ability to Save the Surrogate Model |
SP |
M |
Implemented |
|
US.5 |
Ability to Use Adaptive Design of Experiments |
SP |
M |
Implemented |
NA |
US.6 |
Ability to Assess Reliability of Surrogate Model |
SP |
M |
Implemented |
|
US.7 |
Ability to Build Surrogate Under Stochastic Excitation |
SP |
M |
Implemented |
|
US.8 |
Ability to Use Physics-Informed Machine Learning |
SP |
M |
_ |
_ |
UN.1 |
Ability to use Gauss-Newton solvers for parameter estimation |
SP |
M |
Implemented |
NA |
UN.2 |
Ability to read calibration data from a file |
UF |
M |
Implemented |
NA |
UN.3 |
Ability to handle non-scalar response quantities |
UF |
M |
Implemented |
NA |
UN.4 |
Ability to run gradient-free parameter estimation |
UF |
D |
Implemented |
NA |
UB.1 |
Ability to use DREAM algorithm for Bayesian inference |
SP |
M |
Implemented |
NA |
UB.2 |
Ability to use TMCMC algorithm for Bayesian inference |
SP |
M |
Implemented |
NA |
UB.3 |
Ability to read calibration data from a file |
UF |
M |
Implemented |
NA |
UB.4 |
Ability to handle non-scalar response quantities |
UF |
M |
Implemented |
NA |
UB.5 |
Ability to calibrate multipliers on error covariance |
UF |
M |
Implemented |
NA |
UB.6 |
Ability to use a default log-likelihood function |
UF |
M |
Implemented |
NA |
UB.7 |
Ability to use Kalman Filtering |
UF |
M |
_ |
_ |
UB.8 |
Ability to use Particle Filtering |
UF |
M |
_ |
_ |
UB.9 |
Ability to perform model-class selection/averaging |
UF |
D |
Implemented |
NA |
UB.10 |
Ability to perform hierarchical Bayesian calibration |
UF |
D |
Implemented |
NA |
UB.11 |
Ability to perform surrogate-aided Bayesian calibration |
UF |
D |
In Progress |
NA |
UH.1 |
Ability to sample from manifold |
SP |
M |
Implemented |
|
UH.2 |
Ability to build Reduced Order Model |
SP |
M |
In Progress |
|
UO.1 |
Ability to use User-Specified External UQ Engine |
SP |
M |
Implemented |
NA |
UO.2 |
Ability to use Own External FEM Application |
UF |
M |
Implemented |
NA |
UO.3 |
Ability to use UQ Engines other than SimCenterUQ, Dakota, or UCSD-UQ |
UF |
P |
_ |
_ |
5.6. RV Requirements¶
# |
Description |
Source |
Priority |
Status |
Implementation |
|---|---|---|---|---|---|
RV.1 |
Various Random Variable Probability Distributions |
||||
RV.1.1 |
Normal |
SP |
M |
Implemented |
|
RV.1.2 |
Lognormal |
SP |
M |
Implemented |
|
RV.1.3 |
Uniform |
SP |
M |
Implemented |
|
RV.1.4 |
Beta |
SP |
M |
Implemented |
|
RV.1.5 |
Weibull |
SP |
M |
Implemented |
|
RV.1.6 |
Gumbel |
SP |
M |
Implemented |
|
RV.1.7 |
Exponential |
SP |
M |
Implemented |
|
RV.1.8 |
Discrete |
SP |
M |
Implemented |
|
RV.1.9 |
Gamma |
SP |
M |
Implemented |
|
RV.1.10 |
Chi-squared |
SP |
M |
Implemented |
|
RV.1.11 |
Truncated Exponential |
SP |
M |
Implemented |
|
RV.2 |
User-defined Distribution |
SP |
M |
_ |
_ |
RV.3 |
Define Correlation Matrix |
SP |
M |
Implemented |
|
RV.4 |
Random Fields |
SP |
M |
_ |
_ |
RV.5 |
Ability to View Graphically the density function when defining the RV |
UF |
D |
Implemented |
5.7. Common Research Application Requirements¶
# |
Description |
Source |
Priority |
Status |
Implementation |
|---|---|---|---|---|---|
CR.1 |
Open-source software where developers can test new data and develop algorithms |
||||
CR.1.1 |
Provide open-source applications utilizing code hosting platforms, e.g. GitHub |
SP |
M |
Implemented |
|
CR.1.2 |
Assign an open-source license that allows free use |
SP |
M |
Implemented |
|
CR.2 |
Ability to use multiple coupled resources (applications, databases, viz tools) by Practicing Engineers |
||||
CR.2.1 |
Allow users to launch scientific workflows |
SP |
M |
Implemented |
|
CR.3 |
Ability to utilize resources beyond the desktop including HPC |
||||
CR.3.1 |
Allow users to utilize HPC resources at TACC through DesignSafe |
SP |
M |
Implemented |
|
CR.4 |
Efficient use of multiple coupled and linked models requiring sharing and inter-operability of databases, computing environments, networks, visualization tools, and analysis systems |
||||
CR.4.1 |
Identify and include external analysis systems |
SP |
M |
InProgress |
_ |
CR.4.2 |
Identify and include external databases |
SP |
M |
InProgress |
|
CR.4.3 |
Identify and include external viz tools |
SP |
M |
InProgress |
_ |
CR.4.4 |
Identify and include external computing env |
SP |
M |
Inprogress |
1.1.2.5.5 |
CR.5 |
Tool available for download from web |
||||
CR.5.1 |
Tool downloadable from DesignSafe website |
GC |
M |
Implemented |
|
CR.6 |
Ability to benefit from programs that move research results into practice and obtain training |
||||
CR.6.1 |
Ability to use educational provisions to gain interdisciplinary education for expertise in earth sciences and physics, engineering mechanics, geotechnical engineering, and structural engineering to be qualified to perform these simulations |
GC |
D |
_ |
_ |
CR.6.2 |
Documentation exists demonstrating application usage |
SP |
M |
Implemented |
_ |
CR.6.3 |
Video exists demonstrating application usage |
SP |
M |
Implemented |
_ |
CR.6.4 |
Tool training through online and in-person training events |
SP |
M |
Implemented |
_ |
CR.7 |
Verification examples exist |
SP |
M |
Implemented |
|
CR.8 |
Validation of proposed analytical models against existing empirical datasets |
||||
CR.8.1 |
Validation examples exist, validated against tests or other software |
GC |
M |
_ |
|
CR.9 |
Tool to allow users to load and save user inputs |
SP |
M |
Implemented |
core |
CR.10 |
Installer which installs the application and all needed software |
UF |
D |
Implemented |