6. Requirements

The following contains the functional requirements for the WE-UQ application. These requirements are broken down into a number of groups, general, wind loading, building description, analysis, and UQ.

The purpose of presenting these requirements is to inform the community about the present capabilities of the WE-UQ application and the features that could be added. The original set of requirements has 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.

6.1. General Requirements

Table 6.1.1 Requirements - General

#

Description

Source

Priority

Status

Implementation

WE

Application to determine response of Building Subject to Wind Loading including formal treatment of randomness and uncertainty uncertainty

InProgress

Application

WE.1

Adaptation of non-linear analysis methods used in seismic design

GC

M

Implemented

WE.1.1

Include ability to create models incorprating options listed in MOD under BM

SP

M

Implemented

SIM

WE.1.2

Include ability to perform nonlinear analysis on the building models listed in ANA

SP

M

Implemented

SIM

WE.2

Ability to select from Wind Loading Options listed in WL2

SP

M

Implemented

WE.3

Ability to use Various UQ Methods and Variable Options

WE.3.1

Ability to use Forward Propagtion methods listed in UQ under UF

SP

M

Implemented

Example

WE.3.2

Ability to use Reliability Methods listed in UQ under UR

SP

M

Implemented

Example

WE.3.3

Ability to use Global Sensitivity Methods listed in UQ under UG

SP

M

Implemented

Example

WE.3.4

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

SP

M

InProgress

1.2.2.2

WE.3.5

Ability to use High Dimensional UQ listed in UQ under UH

SP

M

InProgress

WE.4

Ability to see pressure distribution on buildings

GC

M

InProgress

1.2.1.1

WE.5

Ability to obtain basic building responses

SP

M

Implemented

EDP

WE.6

Ability to Visualize the Results

SP

M

Implemented

WE.6.1

Ability to view individual sample results

SP

M

Implemented

RES

WE.6.2

Ability to graphically view the results to show distribution in respone

SP

M

Implemented

RES

WE.7

Miscelleneous User Requests

WE.7.1

Ability to Process own Output Parameters

UF

M

Implemented

WE.7.2

Ability to Remove from Results certain Samples,e.g. ones that failed in analysis

UF

M

Implemented

WE.7.3

Create a digital twin of the Wall of Wind facility to allow researchers to simulate experiments

UF

M

Implemented

Example

WE.8

Tool should incorporate data from www

GC

M

Implemented

WE.8.1

Tool could obtain loading from Vortex Winds over www

SP

M

Implemented

Event

WE.8.2

Tool should obtain loading info from TPU wind tunnel tests

SP

D

Implemented

Example

WE.8.3

Tool should obtain building modelling info from database through www

SP

D

WE.9

General Software Requirements

WE.9.1

Application to Provide Common SimCenter Research Application Requirements listed in CR

GC

M

InProgress

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

6.2. Loading Requirements

Table 6.2.1 Requirements - Wind Loading

#

Description

Source

Priority

Status

Implementation

WL.1

Regional Loading due to Wind Hazards

_

_

_

WL.1.1

Regional Hurricane Wind Options

_

_

_

_

WL.1.1.1

Utilize GIS and online to account for wind speed given local terrain, topography and nearby buildings

GC

D

_

_

WL.1.1.2

Multi-scale models for wind and water flows, i.e. lower fidelity regional models with more refined models to capture local flow

SP

D

InProgress

N/A

WL.1.1.3

Multi-scale models for wind and water flows, i.e. lower fidelity regional models with more refined models to capture local flow

SP

D

InProgress

1.1.3.3.2

WL.1.2

Modeling and simulation for determination of wind loads due to non-synoptic winds, including tornadoes

GC

D

_

_

WL.1.3

Interface with NOAA

SP

D

Implemented

_

WL.2

Local Scale Wind Hazard Options

SP

M

Implemented

_

WL.2.1

Utilize Extensive wind tunnel datasets in industry and academia for wide range of building shapes

_

_

_

weuq-0007

WL.2.1.1

Accommodate Range of Low Rise building shapes

_

_

_

_

WL.2.1.1.1

Flat Shaped Roof - TPU dataset

SP

M

Implemented

weuq-0007

WL.2.1.1.2

Gable Shaped Roof - TPU dataset

SP

M

Implemented

weuq-0007

WL.2.1.1.3

Hipped Shaped Roof - TPU dataset

SP

M

Implemented

weuq-0007

WL.2.1.2

Accommodate Range of High Rise building

SP

M

InProgress

UM

WL.2.1.3

Non Isolated Low Rise Buildings - TPU dataset

SP

M

InProgress

_

WL.2.2

Interface with data-driven Interface with Vortex Winds DEDM-HRP Web service

SP

M

Implemented

UM

WL.2.3

Accommodate Data from Wind Tunnel Experiment

SP

M

Implemented

UM

WL.2.4

Simple CFD model generation and turbulence modeling

GC

M

Implemented

weuq-0013

WL.2.5

Computational Fluid Dynamics tool for utilizing open source CFD software for practitioners

_

_

_

_

WL.2.5.1

Uncoupled OpenFOAM CFD model with nonlinear FEM code for building response

SP

M

Implemented

weuq-0013

WL.2.5.2

Coupled OpenFOAM CFD model with linear FEM code for building response

SP

M

InProgress

_

WL.2.5.3

Inflow Conditions for non-synoptic winds

GC

M

_

_

WL.2.6

Quantification of Effects of Wind Borne Debris

GC

D

_

_

WL.2.7

Ability to utilize synthetic wind loading algorithms per Wittig and Sinha

SP

D

Implemented

weuq-0001

WL.2.8

Hazard modification by terrain, topography, and nearby buildings

GC

D

_

_

WL.2.9

Probabilistic methods are needed to enable site-specific and storm-type specific characterization of likely debris types, weights,and speeds

GC

D

_

_

WL.2.10

Joint description for hurricane wind, storm surge, and wave hazards

GC

D

_

_

WL.2.11

Libraries of high-resolution hurricane wind/surge/wave simulations

GC

M

InProgress

_

WL.2.12

Multi-scale models for wind and water flows, i.e. lower fidelity regional models with more refined models to capture local flow

SP

M

InProgress

_

WL.2.13

Ability to select surrogate modeling events

SP

M

_

_

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

6.3. Modeling Requirements

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

weuq-0012

BM.2

Ability to use existing OpenSees model scripts

SP

M

Implemented

weuq-0001

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

SC

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

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

6.4. Analysis Requirements

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

_

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

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

weuq-0001

ANA.6

Ability to use multiple analysis options

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

6.5. UQ Requirements

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

weuq-0001

UF.2

Ability to use Gaussian Process Regression

SP

M

Implemented

NA

UF.3

Ability to use Multi-Scale Monte Carlo

SP

M

_

_

UF.4

Ability to use Multi-Fidelity Models

SP

M

Implemented

UM

UF.5

Ability to use Multi-model Forward Propagation

UF

D

Implemented

weuq-0001

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

UM

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

NA

US.2

Ability to Construct GP Regression Model from Input-output Dataset

SP

M

Implemented

NA

US.3

Ability to use Surrogate Model for UQ Analysis

SP

M

Implemented

NA

US.4

Ability to Save the Surrogate Model

SP

M

Implemented

NA

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

NA

US.7

Ability to Build Surrogate Under Stochastic Excitation

SP

M

Implemented

NA

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

NA

UH.2

Ability to build Reduced Order Model

SP

M

In Progress

NA

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

6.6. RV Requirements

Table 6.6.1 Requirements - Random Variables

#

Description

Source

Priority

Status

Implementation

RV.1

Various Random Variable Probability Distributions

RV.1.1

Normal

SP

M

Implemented

weuq-0001

RV.1.2

Lognormal

SP

M

Implemented

weuq-0000

RV.1.3

Uniform

SP

M

Implemented

weuq-0000

RV.1.4

Beta

SP

M

Implemented

weuq-0000

RV.1.5

Weibull

SP

M

Implemented

weuq-0000

RV.1.6

Gumbel

SP

M

Implemented

weuq-0000

RV.1.7

Exponential

SP

M

Implemented

weuq-0000

RV.1.8

Discrete

SP

M

Implemented

weuq-0000

RV.1.9

Gamma

SP

M

Implemented

weuq-0000

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

weuq-0000

RV.4

Random Fields

SP

M

_

_

RV.5

Ability to View Graphically the density function when defining the RV

UF

D

Implemented

weuq-0013

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

6.7. Common Research Application Requirements

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

WE-UQ

CR.1.2

Assign an open-source license that allows free use

SP

M

Implemented

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

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

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

UM

CR.4.3

Identify and include external viz tools

SP

M

InProgress

SC

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

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

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

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