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

7.1. General Requirements

Table 7.1.1 Requirements - General

#

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

key:
Source: GC=Needed for Grand Challenges, SP=Senior Personnel, UF=User Feedback
Priority: M=Mandatory, D=Desirable, P=Possible Future
Version: Version number the basic requirement was first met

7.2. Loading Requirements

Table 7.2.1 Requirements - Earthquake Loading

#

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

2.2

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

key:
Source: GC=Needed for Grand Challenges, SP=Senior Personnel, UF=User Feedback
Priority: M=Mandatory, D=Desirable, P=Possible Future
Version: Version number the basic requirement was first met

7.3. UQ Requirements

Table 7.3.1 Requirements - Uncertainty Quantification Methods and Variables

#

Description

Source

Priority

Version

UM

Ability to use various UQ Methods

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

2.1

UM2.1

Ability to use First Order Reliability method

UF

M

2.1

UM2.2

Ability to use Second Order Reliability method

UF

M

2.1

UM2.2

Ability to use Surrogate Based Reliability

UF

M

UM2.3

Ability to use Own External Application to generate Results

UF

M

2.2

UM3

Ability to user various Sensitivity Methods

UF

M

1.0

UM3.1

Ability to obtain Global Sensitivity Sobol’s indices

UF

M

UV

Random Variables

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

2.1

key:
Source: GC=Needed for Grand Challenges, SP=Senior Personnel, UF=User Feedback
Priority: M=Mandatory, D=Desirable, P=Possible Future
Version: Version number the basic requirement was first met

7.4. Modeling Requirements

Table 7.4.1 Requirements - Modeling

#

Description

Source

Priority

Version

BM

Ability to select different Building Model Generators

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

BM6

Ability to define a user-defined moment-rotation response representing the connection details

UF

D

BM7

Ability to incoporate AutoSDA Steel Design Application

UF

M

2.2

key:
Source: GC=Needed for Grand Challenges, SP=Senior Personnel, UF=User Feedback
Priority: M=Mandatory, D=Desirable, P=Possible Future
Version: Version number the basic requirement was first met

7.5. Analysis Requirements

Table 7.5.1 Requirements - Analysis

#

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

D

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

2.1

BA8

Ability to specify damping ratio as a random variable

UF

M

2.1

BA9

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

UF

M

2.1

BA10

Ability to run for more than 60hours at DesignSafe

UF

D

BA11

Ability to specify number of iterations in convergence test

UF

M

2.1

key:
Source: GC=Needed for Grand Challenges, SP=Senior Personnel, UF=User Feedback
Priority: M=Mandatory, D=Desirable, P=Possible Future
Version: Version number the basic requirement was first met