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 on the present capabilities of the WE-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.

6.1. General Requirements

Table 6.1.1 Requirements - General

#	Description	Source	Priority	Version	WBS
WE	Application to determine response of Building Subject to Wind Loading including formal treatment of randomness and uncertainty uncertainty			InProgress
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
WE.1.2	Include ability to perform nonlinear analysis on the building models listed in ANA	SP	M	Implemented
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
WE.3.2	Ability to use Reliability Methods listed in UQ under UR	SP	M	Implemented
WE.3.3	Ability to use Global Sensitivity Methods listed in UQ under UG	SP	M	Implemented
WE.3.4	Ability to both use and create surrogates listed in UQ under US	SP	M
WE.3.5	Ability to use High Dimensional UQ listed in UQ under UH	SP	M
WE.4	Ability to see pressure distribution on buildings	GC	M
WE.5	Ability to obtain basic building responses	SP	M
WE.6	Ability to Visualize the Results	SP	M	Implemented
WE.6.1	Ability to view individual sample results	SP	M	Implemented
WE.6.2	Ability to graphically view the results to show distribution in respone	SP	M	Implemented
WE.7	Misc 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
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
WE.8.2	Tool should obtain loading info from TPU wind tunnel tests	SP	D	Implemented
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: Implements, InProgress and Blank (i.e. not started)

6.2. Loading Requirements

Table 6.2.1 Requirements - Wind Loading

#	Description	Source	Priority	Version
WL	Loading from Wind Hazards (Hurricane, Downbursts, Tornados) on Local and Regional Assets	GC	M	InProgress
WL.1	Regional Loading due to Wind Hazards	GC	M	InProgress
WL.1.1	Regional Hurricane Wind Options	GC	M	InProgress
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	MultiScale Wind Models	SP	D
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
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 Open-Source Applications that can provide Hazard loading	GC	D
WL.1.3.1	Interface with NOAA	SP	D
WL.2	Local Scale Wind Hazard Options
WL.2.1	Utilize Extensive wind tunnel datasets in industry and academia for wide range of building shapes	GC	M	Implemented
WL.2.1.1	Accommodate Range of Low Rise building shapes	SP	M
WL.2.1.1.1	Flat Shaped Roof - TPU dataset	SP	M	Implemented
WL.2.1.1.2	Gable Shaped Roof - TPU dataset	SP	M
WL.2.1.1.3	Hipped Shaped Roof - TPU dataset	SP	M
WL.2.1.2	Accommodate Range of High Rise building	SP	M	InProgress
WL.2.1.3	Non Isolated Low Rise Buildings - TPU dataset	SP	M	InProgress
WL.2.2	Interface with data driven	GC	M	InProgress
WL.2.2.1	Interface with Vortex Winds DEDM-HRP Web service	SP	M	Implemented
WL.2.3	Accommodate Data from Wind Tunnel Experiment	SP	M	Implemented
WL.2.4	Simple CFD model generation and turbulence modeling	GC	M	Implemented
WL.2.5	Computational Fluid Dynamics tool for utilizing open source CFD software for practitioners	GC	M	Implemented
WL.2.5.1	Uncoupled OpenFOAM CFD model with nonlinear FEM code for building response	SP	M	Implemented
WL.2.5.1	Coupled OpenFOAM CFD model with linear FEM code for building response	SP	M	InProgress
WL.2.5.2	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	SP	M	Implemented
WL.2.7.1	per Wittig and Sinha	SP	D	Implemented
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
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
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: Implements, InProgress and Blank (i.e. not started)

6.3. UQ Requirements

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

6.4. Modeling Requirements

Table 6.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	_
BM.2	Ability to use existing OpenSees model scripts	SP	M	Implemented	_
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	_
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)

6.5. Analysis Requirements

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

6.6. Common Research Application Requirements

Table 6.6.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”	_
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”	_
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)