3. Response of Building to Earthquake

The following are the requirements for response of single structure to earthquake hazards. The requirements are being met by the EE-UQ application. AAll requirements in this section are related to work in WBS 1.3.8. These requirements are broken down into a number of groups, general, earthquake loading, building description, analysis, and UQ.

3.1. General Requirements

Table 3.1.1 Requirements - General

#	Description	Source	Priority	Status
EE	Application to determine response of Building Subject to Earthquake hazard including formal treatment of randomness and uncertainty	GC	M	InProgress
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
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
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

Key:

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

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

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

3.2. Loading Requirements

Table 3.2.1 Requirements - Earthquake Loading

#	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	_	_
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 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	Coupling of multi-scale nonlinear models from the point of rupture through rock and soil into structure	_	_	_	_
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	_	_
EL.2.6	Ability to Utilize Own Application in Workflow	SP	M	Implemented	_
EL.2.7	Ability to use Broadband	_	_	_	_
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 include Soil-Structure Interaction Effects	_	_	_	_
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: Implemented, InProgress and Blank (i.e. not started)

3.3. UQ Requirements

Table 3.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 Assess 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 a 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 a 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: Implemented, InProgress and Blank (i.e. not started)

3.4. Modeling Requirements

Table 3.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 a building and use Expert System to generate FE mesh	SP	D	_	_
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 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: Implemented, InProgress and Blank (i.e. not started)

3.5. Analysis Requirements

Table 3.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 the 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: Implemented, InProgress and Blank (i.e. not started)

3.6. RV Requirements

Table 3.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	Documentation

Key:

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

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

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

3.7. Common Research Application Requirements

Table 3.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	Implemented	EE-UQ
CR.1.2	Assign an open-source license that allows free use	SP	M	Implemented	EE-UQ
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	_
CR.5	Tool available for download from web
CR.5.1	Tool downloadable from DesignSafe website	GC	M	Implemented	EE-UQ
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	_	EE-UQ
CR.9	Tool to allow users to load and save user inputs	SP	M	Implemented	core
CR.10	Installer which installs application and all needed software	UF	D	_	EE-UQ

Key:

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

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

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