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

Table 5.1.1 Requirements - General

#

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

RTM

EE.2

Ability to select from Building Modeling Options listed in MOD under BM

SP

M

Implemented

RTM

EE.3

Ability to select from nonlinear analysis options listed in ANA

SP

M

Implemented

RTM

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

RTM

EE.4.2

Ability to use Random Variable Distributions defined in RV

SP

M

Implemented

RTM

EE.4.3

Ability to use Reliability Methods listed in UQ under UR

SP

M

Implemented

RTM

EE.4.4

Ability to use Global Sensitivity Methods listed in UQ under UG

SP

M

Implemented

RTM

EE.4.5

Ability to both use and create surrogates listed in UQ under US

SP

M

Implemented

RTM

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

eeuq-0001

EE.5.2

Ability to graphically view the results to show distribution in response

SP

M

Implemented

eeuq-0001

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

RTM

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

eeuq-0003

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)
Implementation: UM=User Manual, DM=Developer Manual, SC=Source Code

5.2. Loading Requirements

Table 5.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

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

UM

EL.2.1.2

Select using all options available at PEER site

UF

D

Implemented

UM

EL.2.1.3

Select using user-supplied spectrum

UF

D

Implemented

eeuq-0003

EL.2.2

Ability to select utilizing PEER NGA_West web service

SP

D

Implemented

eeuq-0003

EL.2.3

Ability to select from a list of user-supplied PEER motions

SP

M

Implemented

eeuq-0001

EL.2.4

Ability to select from a list of SimCenter motions

SP

M

Implemented

UM

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

eeuq-0002

EL.2.7.2

Nonlinear site response with bidirectional loading

SP

M

Implemented

UM

EL.2.7.3

Nonlinear site response with full stochastic characterization of soil layers

SP

M

Implemented

eeuq-0002

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

eeuq-0005

EL.2.8.2

per Dabaghi Der Kiureghian (2017)

UF

D

Implemented

eeuq-0005

EL.2.9

Ability to select from synthetic ground motions

SP

M

Implemented

eeuq-0005

EL.2.10

Ability to select surrogate modeling events

SP

M

Implemented

eeuq-0007

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)
Implementation: UM=User Manual, DM=Developer Manual, SC=Source Code

5.3. Modeling Requirements

Table 5.3.1 Requirements - Modeling

#

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

eeuq-0002

BM.2

Ability to use existing OpenSees model scripts

SP

M

Implemented

eeuq-0001

BM.3

Ability to define a building and use Expert System to generate FE mesh

SP

D

Implemented

eeuq-0004

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

eeuq-0004

BM.8

Ability to use user-supplied Python script to generate mesh

UF

M

InProgress

SC

BM.9

Ability to use multiple models of similar fidelity

SP

M

Implemented

eeuq-0008

BM.10

Ability to use multiple models of different fidelity

SP

M

Implemented

eeuq-0011

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)
Implementation: UM=User Manual, DM=Developer Manual, SC=Source Code

5.4. Analysis Requirements

Table 5.4.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

_

_

ANA.3

Ability to specify Modal Damping

_

_

_

_

ANA.3.1

Ability to specify damping ratio as a random variable

UF

M

Implemented

UM

ANA.3.2

When using Rayleigh Damping, ability to specify the two modes used to calculate damping parameters

UF

M

Implemented

eeuq-0001

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

eeuq-0001

ANA.6

Ability to use multiple analysis options

SP

M

Implemented

eeuq-0008

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)
Implementation: UM=User Manual, DM=Developer Manual, SC=Source Code

5.5. UQ Requirements

Table 5.5.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

eeuq-0001

UF.2

Ability to use Gaussian Process Regression

SP

M

Implemented

UM

UF.3

Ability to use Multi-Scale Monte Carlo

SP

M

_

_

UF.4

Ability to use Multi-Fidelity Models

SP

M

Implemented

eeuq-0011

UF.5

Ability to use Multi-model Forward Propagation

UF

D

Implemented

eeuq-0008

UR.1

Ability to use First Order Reliability method

SP

M

Implemented

UM

UR.2

Ability to use Second Order Reliability method

SP

M

Implemented

UM

UR.3

Ability to use Surrogate Based Reliability

SP

M

Implemented

eeuq-0001

UR.4

Ability to use Importance Sampling

SP

M

Implemented

UM

UG.1

Ability to obtain Global Sensitivity Sobol indices

UF

M

Implemented

UM

UG.2

Ability to use probability model-based global sensitivity analysis (PM-GSA)

SP

M

Implemented

UM

UG.3

Ability to use probability model-based global sensitivity analysis (PM-GSA) for high-dimensional outputs

UF

D

Implemented

UM

US.1

Ability to Construct Gaussian Process (GP) Regression Model from a Simulation Model

SP

M

Implemented

eeuq-0009

US.2

Ability to Construct GP Regression Model from Input-output Dataset

SP

M

Implemented

UM

US.3

Ability to use Surrogate Model for UQ Analysis

SP

M

Implemented

eeuq-0010

US.4

Ability to Save the Surrogate Model

SP

M

Implemented

eeuq-0009

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

eeuq-0009

US.7

Ability to Build Surrogate Under Stochastic Excitation

SP

M

Implemented

eeuq-0009

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

eeuq-0006

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

_

_

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)
Implementation: UM=User Manual, DM=Developer Manual, SC=Source Code

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

UM

RV.1.3

Uniform

SP

M

Implemented

UM

RV.1.4

Beta

SP

M

Implemented

UM

RV.1.5

Weibull

SP

M

Implemented

eeuq-0001

RV.1.6

Gumbel

SP

M

Implemented

UM

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

eeuq-0011

RV.2

User-defined Distribution

SP

M

_

_

RV.3

Define Correlation Matrix

SP

M

Implemented

UM

RV.4

Random Fields

SP

M

_

_

RV.5

Ability to View Graphically the density function when defining the RV

UF

D

Implemented

eeuq-0008

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)
Implementation: UM=User Manual, DM=Developer Manual, SC=Source Code

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

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

EE-UQ

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

EE-UQ

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

eeuq-0003

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

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

EE-UQ

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

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)
Implementation: UM=User Manual, DM=Developer Manual, SC=Source Code