1. About

1.1. Overview

Water-borne Hazards Engineering with Uncertainty Quantification (HydroUQ app) is an open-source software tool developed by the NHERI SimCenter. It allows for utilization of existing simulation software applications, e.g. OpenSees and OpenFOAM, in uncertainty quantification (UQ) workflows. The application provides popular UQ methods (e.g., forward, inverse, reliability, sensitivity, parameter estimation, and surrogate modeling) to engineers, researchers, and students for tsunamis, hurricane storm-surges, and other water-borne hazards. The SimCenter is part of the Natural Hazards Engineering Research Infrastructure (NHERI) program, funded by the National Science Foundation (see Acknowledgments).

../../../../_images/NHERI_SimCenter_DamBreakAnimation_VelocityPressureVisualized_2.5MParticles_res0.05m_23012023.gif

Fig. 1.1.1 Using HydroUQ to model the text “NHERI SimCenter” during a dam-break simulation. “NHERI” is made of Drucker-Prager sand, “SimCenter” is made of Non-Associative Cam-Clay concrete. The Material Point Method (ClaymoreUW) was used for the simulation within HydroUQ.

To download the HydroUQ desktop application for Windows 10 or Mac OS X, navigate to HydroUQ Download. For Linux systems, e.g. Ubuntu 18.04-LTS, download the source code at HydroUQ Github page and build the program file by following steps provided in the Build Guide. HydroUQ app is released under the 2-Clause BSD license (see HydroUQ’s License).

../../../../_images/HydroUQ_MPM_3DViewPort_OSULWF_2024.04.25.gif

Fig. 1.1.2 The HydroUQ Desktop Application’s User Interface for Oregon State University’s Large Wave Flume Digital Twin.

This is Version 3.1.0 of the tool. Users are encouraged to comment on what additional features and capabilities they would like to see in this application. These requests and feedback can be submitted through an anonymous user survey. We greatly appreciate any input you have. If there are features you want, chances are many of your colleagues also would benefit from them. We encourage you to review the Requirments Traceability Matrix to see what features are planned.

The additional simulations required for uncertainty quantification can be prohibitively expensive. To overcome this impediment, the user has the option to perform the response simulations on the Frontera and Lonestar6 supercomputers, located at the Texas Advanced Computing Center (TACC). These HPC resources are made available to the user through NHERI DesignSafe-CI, the cyberinfrastructure provider for the distributed NSF-funded Natural Hazards Engineering Research Infrastructure (NHERI) facility.

1.2. Capabilities and Limitations

Below are key, modular capabilities and limitations of HydroUQ, categorized by Uncertainty Quantification (UQ), Design Building General Information (GI), Structural Information & Analysis Model (SIM), Natural Hazard Event (EVT), Engineering Demand Parameters (EDP), Finite Element Method (FEM), Random Variables (RV), and Results (RES).

Item

Capabilities

Limitations

UQ

Easy access to different UQ methods. Parallelized UQ algorithms. Multiple alternative algorithms for each method.

No support for optimization under uncertainty and local sensitivity analysis.

GI

Basic interface for user-provided general building information (e.g. location, age, and building type).

No support for sophisticated user-defined building types. Yet to implement a map-style interface for building location so users must type in coordinates manually.

SIM

Easy interface for user-provided structural information and analysis models (e.g. geometry, material properties, and boundary conditions). Provides a multi-degree-of-freedom (MDOF) building model. Allows for OpenSeesPy models defined in user-provided scripts. Supports investigation of multiple potential building models with associated “belief” values for each.

Does not make full use of information (e.g. location of the building and date built influences which ASCE guidelines may have applied) provided in GI for automated structural information and analysis model generation.

EVT

OpenFOAM computational fluid dynamics (CFD) simulations. GeoClaw Shallow-Water Equations (SWE) and OpenFOAM CFD one-way coupled simulations. FOAMySees two-way coupled CFD-FEA simulations. Material Point Method (MPM, ClaymoreUW) simulations. Pre-built and validated digital wave-flume twins.

Most simulation types are limited to remote execution on TACC supercomputers.

FEM

Easy interface for user-provided simulation models (not only FEM models but any model), including Opensees, Python, or any other simulation models (e.g. FEM or non-FEM software) with only a python-scripted interface provided by the user to HydroUQ.

Graphical user-interface support for alternative finite element analysis (FEA) software and non-FEA software is limited.

RV

Twelve different kinds of probability distributions with correlations.

Does not expose which variables support this feature well to the user. No support for random fields, non-Gaussian copular, or user-defined variables.

EDP

Scalar and vector EDP parsing. Hazard specific EDP lists (e.g. tsunami and storm-surge). Support for user-defined EDPs.

Separate Intensity Measures (IMs) and EDPs (load and response), in functionality and GUI presentation, is not fully delineated yet.

RES

Interactive plotting of scatter charts, histograms, and cumulative mass functions. Summary of statistics. Save data into a CSV file.

Limited flexibility for in-app visualization. Results must be ported to external plotting software for more advanced visualization.

General

Graphical user interface. Free and easy one-click remote running option.

Limited guidance on how to effectively contribute to this open-source project.