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 features if you have additional features you would like to see.

5.1. General Requirements

key:

Source: GC=Needed for Grand Challenges, SP=Senior Personnel, UF=User Feedback

Priority: M=Mandatory, D=Desirable, P=Possible Future

Status: Implements, InProgress and Blank (i.e. not started)

5.2. Loading Requirements

Table 5.2.1 Requirements - Earthquake Loading

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	_	_
EL.1.1.3	Interface between asset and regional simulations using site response method	SP	M	InProgress	_
EL.1.1.4	Interface between asset and regional simulations using DRM method	SP	M	_	_
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 grouind 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.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 list of user supplied PEER motions	SP	M	Implemented	_
EL.2.4	Ability to select from list of SimCenter motions	SP	M	Implemented	_
EL.2.5	Ability to use OpenSHA and selection methods to generate motions	UF	D	_	_
EL.2.6	Ability to Utilize Own Application in Workflow	SP	M	Implemented	_
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.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	_

key:

Source: GC=Needed for Grand Challenges, SP=Senior Personnel, UF=User Feedback

Priority: M=Mandatory, D=Desirable, P=Possible Future

Status: Implements, InProgress and Blank (i.e. not started)

5.3. UQ Requirements

Table 5.3.1 Requirements - Uncertainty Quantification Methods and Variables

#	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 Own External UQ Engine”	SP	“M”	_	_
UF.4	“Ability to use Multi-Scale Monte Carlo”	SP	“M”	_	_
UF.5	“Ability to use Multi-Fidelity Models”	SP	“M”	“InProgress”	_
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”	_
US.1	“Ability to Construct Gaussian Process (GP) Regression Model from a Simulation Model”	SP	“M”	“InProgress”	_
US.2	“Ability to Construct GP Regression Model from Input-output Dataset”	SP	“M”	“InProgress”	_
US.3	“Ability to use Surrogate Model for UQ Analysis”	SP	“M”	“InProgress”	_
US.4	“Ability to Save the Surrogate Model”	SP	“M”	“InProgress”	_
US.5	“Ability to Use Adaptive Design of Experiments”	SP	“M”	“InProgress”	_
US.6	“Ability to Asses Reliability of Surrogate Model”	SP	“M”	“Implemented”	_
US.7	“Ability to Build Surrogate Under Stochastic Excitation”	SP	“M”	“InProgress”	_
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”	_
UN.2	“Ability to read calibration data from file”	UF	“M”	“Implemented”	_
UN.3	“Ability to handle non-scalar response quantities”	UF	“M”	“Implemented”	_
UB.1	“Ability to use DREAM algorithm for Bayesian inference”	SP	“M”	“Implemented”	_
UB.2	“Ability to use TMCMC algorithm for Bayesian inference”	SP	“M”	“Implemented”	_
UB.3	“Ability to read calibration data from file”	UF	“M”	“Implemented”	_
UB.4	“Ability to handle non-scalar response quantities”	UF	“M”	“Implemented”	_
UB.5	“Ability to calibrate multipliers on error covariance”	UF	“M”	“Implemented”	_
UB.6	“Ability to use a default log-likelihood function”	UF	“M”	“Implemented”	_
UB.7	“Ability to use Kalman Filtering”	UF	“M”	_	_
UB.8	“Ability to use Particle Filtering”	UF	“M”	_	_
UH.1	“Ability to sample from manifold”	SP	“M”	“Implemented”	_
UH.2	“Ability to build Reduced Order Model”	SP	“M”	_	_
UO.1	“Ability to use User-Specified External UQ Engine”	SP	“M”	“Implemented”	_
UO.2	“Ability to use Own External FEM Application”	UF	“M”	“Implemented”	_
UM.1	“Ability to use various Reliability Methods”	“_”	“_”	“_”	“_”
UM.1.1	“Ability to use First Order Reliability method”	UF	“M”	“Implemented”	_
UM.1.2	“Ability to use Surrogate Based Reliability”	UF	“M”	_	_
UM.1.3	“Ability to use Own External Application to generate Results”	UF	“M”	“Implemented”	_
UM.2	“Ability to user various Sensitivity Methods”	“_”	“_”	“_”	“_”
UM.2.1	“Ability to obtain Global Sensitivity Sobol’s indices”	UF	“M”	“Implemented”	_

key:

Source: GC=Needed for Grand Challenges, SP=Senior Personnel, UF=User Feedback

Priority: M=Mandatory, D=Desirable, P=Possible Future

Status: Implements, InProgress and Blank (i.e. not started)

5.4. Modeling Requirements

Table 5.4.1 Requirements - Modeling

#	Description	Source	Priority	Status	Implementation
BM.1	Ability to quickly create a simple nonlinear building model for simple methods of seismic evaluation	GC	D	Implemented	eeuq-0001/
BM.2	Ability to use existing OpenSees model scripts	SP	M	Implemented	eeuq-0003/
BM.3	Ability to define building and use Expert System to generate FE mesh	SP	D	_	_
BM.4	Ability to define 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 incoporate AutoSDA Steel Design Application in Local Applications	UF	M	Implemented	eeuq-0004/
BM.8	Ability to use user supplied python script to generate mesh	UF	M	Implemented	_

key:

Source: GC=Needed for Grand Challenges, SP=Senior Personnel, UF=User Feedback

Priority: M=Mandatory, D=Desirable, P=Possible Future

Status: Implements, InProgress and Blank (i.e. not started)

5.5. Analysis Requirements

Table 5.5.1 Requirements - Analysis

#	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	eeuq-0001/
ANA.1.2	Ability to provide own OpenSees Analysis script to OpenSees engine.	SP	D	Implemented	eeuq-0001/
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	_	core
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 60hours at DesignSafe	UF	D	_	_
ANA.5	Ability to specify number of iterations in convergence test	UF	M	Implemented	_

key:

Source: GC=Needed for Grand Challenges, SP=Senior Personnel, UF=User Feedback

Priority: M=Mandatory, D=Desirable, P=Possible Future

Status: Implements, InProgress and Blank (i.e. not started)

5.6. RV Requirements

Table 5.6.1 Requirements - Random Variables

#	Description	Source	Priority	Status	Implementation
RV.1	Various Random Variable Probability Distributions	_	_	_	_
RV.1.1	Normal	SP	M	Implemented	eeuq-0001/
RV.1.2	Lognormal	SP	M	Implemented	_
RV.1.3	Uniform	SP	M	Implemented	eeuq-0001/
RV.1.4	Beta	SP	M	Implemented	_
RV.1.5	Weibull	SP	M	Implemented	_
RV.1.6	Gumbel	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	link

key:

Source: GC=Needed for Grand Challenges, SP=Senior Personnel, UF=User Feedback

Priority: M=Mandatory, D=Desirable, P=Possible Future

Status: Implements, InProgress and Blank (i.e. not started)

5.7. Common Research Application Requirements

Table 5.7.1 Requirements - CR

#	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”	“link”
CR.1.2	“Assign an open-source licensce that allows free use.”	SP	“M”	“Implemented”	“link”
CR.2	“**Ability of Practicing Engineers to use multiple coupled resources (applications	databases	viz tools) in engineering practice**”	“_”	“_”
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	“_”
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”	_
CR.5	“Tool available for download from web”	“_”	“_”	“_”	“_”
CR.5.1	“Tool downloadable from DesignSafe website”	GC	“M”	“Implemented”	“link”
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 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”	“D”
CR.6.2	“Documentation exists demonstrainting 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”	“link”
CR.9	“Tool to allow user to load and save user inputs”	SP	“M”	“Implemented”	core
CR.10	“Installer which installs application and all needed software”	UF	“D”	_	“link”

key:

Source: GC=Needed for Grand Challenges, SP=Senior Personnel, UF=User Feedback

Priority: M=Mandatory, D=Desirable, P=Possible Future

Status: Implements, InProgress and Blank (i.e. not started)