Skip to content

Latest commit

 

History

History
228 lines (133 loc) · 18.6 KB

README.md

File metadata and controls

228 lines (133 loc) · 18.6 KB

HydroUQ - Desktop App

Water-borne Hazards Engineering with Uncertainty Quantification

Frank McKenna, Justin Bonus, Ajay Harish, Nicolette Lewis
NHERI SimCenter, 2020-2024


Latest Release DOI Build status License GitHub LinkedIn Follow YouTube Subscribe


Dam Break Animation HydroUQ MPM 3D ViewPort OSULWF

Why Use HydroUQ?

The HydroUQ desktop application is a user-facing portal for cutting-edge engineering workflows targeting tsunami and storm-surge demands on structures. It is a free, open-source, graphical software for simulating a structures's response with uncertainty quantification (UQ) during water-borne natural hazard loading. The application's interchangeable workflow allows you to swap between popular uncertainty quantification methods (e.g. Forward, Sensitivity, Reliability) to upgrade your previously deterministic models to probabilistic ones. Modular design lets you drop-in your own building models (SIM), event types (EVT), nonlinear structural analysis (FEM), engineering demand parameters (EDP), and more.

Capabilities

  • Drop-in uncertainty quantification (UQ) methods like forward propagation, sensitivity, and reliability analysis onto previously deterministic computational fluid dynamics (CFD) models using SimCenter UQ and/or Dakota backends
  • Model experiments from validated wave flume digital twin
  • Bathymetry/topography of the ocean floor and land surface for accurate wave propagation
  • Shallow-water solutions (e.g., GeoClaw) as boundary conditions to 3D CFD (e.g., OpenFOAM)
  • Capture high-fiedlity wave-driven debris motion, impacts, damming, and deposition.
  • User-defined buildings for wave loading input and structural response output
  • Design structures including Multi-degree-of-freedom (MDOF) model, steel building model, OpenSees models, and OpenSeesPy models
  • Output probabilistic building responses, velocities and pressure at any point in the fluid domain
  • Supports multiscale coupling by resolving areas of interest with a 2D shallow water solver (e.g., GeoClaw) and a 3D CFD solver (e.g., OpenFOAM) and bridging them at an interface.
  • Model elasto-plastic, topology-changing debris and/or structures under wave-loads with the Material Point Method (MPM)

Quick Links

Citing HydroUQ

If you use HydroUQ DOI in your research, please cite our software as:

@software{McKennaBonusHarishLewis2024,
  author = {Frank McKenna and Justin Bonus and Ajay Harish and Nicolette Lewis},
  title = {HydroUQ},
  year = {2024},
  month = {4},
  note = {NHERI-SimCenter/HydroUQ: Version 3.1.0 (v3.1.0). Zenodo.},
  url = {https://zenodo.org/records/10902090},
  doi = {10.5281/zenodo.10902090}
}

and include the NHERI SimCenter's workflow architecture DOI using:

@Article{Deierlein2020,
  author={Deierlein, Gregory G. and McKenna, Frank and Zsarnóczay, Adam and Kijewski-Correa, Tracy and Kareem, Ahsan and Elhaddad, Wael and Lowes, Laura and Schoettler, Matthew J. and Govindjee, Sanjay},   
  title={A Cloud-Enabled Application Framework for Simulating Regional-Scale Impacts of Natural Hazards on the Built Environment},      
  journal={Frontiers in Built Environment},      
  volume={6},           
  year={2020},      
  url={https://www.frontiersin.org/articles/10.3389/fbuil.2020.558706},       
  doi={10.3389/fbuil.2020.558706},      
  issn={2297-3362},   
}

SimCenter Eco-System

The challenges of natural hazards engineering are addressed by the NHERI SimCenter through a suite of applications that provide cutting-edge tools for researchers, practitioners, and stakeholders. The applications are designed to work together to provide a comprehensive solution for natural hazards engineering. A puzzle-piece diagram of the SimCenter ecosystem is shown below:

In reality, this is a software workflow representation of the PEER Performance-Based Earthquake Engineering (PBEE) framework that has been extended to include other natural hazards:

HydroUQ is just one part of the NHERI SimCenter ecosystem that provides cutting-edge open-source tools for natural hazards engineering. Tools like quoFEM, EE-UQ, WE-UQ, HydroUQ, PBE, and R2D work together to provide a comprehensive solution for natural hazards engineering. The SimCenter ecosytem forms a modular hierarchy that allows you to pick and choose tools in the workflow for your specific research or engineering problem.

While R2D is the top-level application that provides a regional resilience assessment, EE-UQ, WE-UQ, and HydroUQ provide uncertainty quantified simulations for earthquake, wind, and water-borne natural hazards, respectively. quoFEM is the backend UQ functionality they use.

Additional tools, such as BRAILS and TInF, have special use-cases including AI-augmentation of building stock and creation of turbulent wind inflow for OpenFOAM CFD simulations.

All applications are free, open-source, and available for download on the DesignSafe-CI website. See the table below for more information on each application:

Application Full Title Download GitHub Version
R2D Regional Resilience Determination Application Download R2D GitHub R2D GitHub Latest Release
PBE Performance-Based Engineering Application Download PBE GitHub PBE GitHub Latest Release
EE-UQ Earthquake Engineering with Uncertainty Quantification Application Download EE-UQ GitHub EE-UQ GitHub Latest Release
WE-UQ Wind Engineering with Uncertainty Quantification Application Download WE-UQ GitHub WE-UQ GitHub Latest Release
HydroUQ Water-Borne Natural Hazards Engineering with Uncertainty Quantification Application Download HydroUQ GitHub HydroUQ GitHub Latest Release
quoFEM Quantified Uncertainty with Optimization for the Finite Element Method Application Download quoFEM GitHub quoFEM GitHub Latest Release
TInF Turbulence Inflow Generation for CFD Application Download TInF GitHub TInF GitHub Latest Release
BRAILS Building Recognition with AI at Large-Scales Application pip install BRAILS GitHub BRAILS GitHub Latest Release

Getting Started

The HydroUQ application can be downloaded, installed, built, and launched on Windows, Mac, and Linux operating systems. With a free DesignSafe account, you can run HydroUQ simulations remotely on powerful supercomputers including Frontera, Lonestar6, and Stampede3.

Download HydroUQ

The HydroUQ desktop application is available for download on Windows and Mac operating systems from the DesignSafe-CI website at the HydroUQ Download Link.

Install HydroUQ

The HydroUQ installation instructions are available in the HydroUQ Installation Guide.

Build HydroUQ

The HydroUQ application can be built from source code on Windows, Mac, and Linux operating systems. The source code is available in this repository.

Clone the repository using the following command if the Github CLI is installed on your system:

git clone https://github.com/NHERI-SimCenter/HydroUQ.git

Otherwise, you can clone the repository on this page by clicking on the green Code button and then clicking on Download ZIP. Extract the downloaded ZIP file to a location on your system.

Instructions on building the HydroUQ application from downloaded source code are available in the HydroUQ How-To-Build Guide

Launch HydroUQ

The HydroUQ application can be run by executing the Hydro_UQ executable file. The instructions to run the HydroUQ application are available in the HydroUQ Documentation

Run HydroUQ Remotely

With a free DesignSafe account you can use the HydroUQ desktop app to launch a remote job to run simulations on powerful supercomputers with ease.

Sign-up for DesignSafe

Available systems are the Frontera, Lonestar6, and Stampede3 supercomputers. Systems are located at the Texas Advanced Computing Center (TACC) and made available to you through NSF's NHERI DesignSafe-CI, the cyberinfrastructure provider for NHERI.


Get Involved

HydroUQ is an open-source project developed for practitioners, researchers, students, and stakeholders by our team of experts at the NHERI SimCenter. We welcome contributions from the community to help improve the application and add new features.

Contributing to HydroUQ

Interested in contributing to the HydroUQ project? Find out how in the HydroUQ Contribution Guide.

Contact Us

Message us on the SimCenter Message Board for any questions, feature requests, or issues.

Developer Email Role
Justin Bonus [email protected] Email
Frank McKenna [email protected] Email
Ajay Harish [email protected] Email
NHERI SimCenter [email protected] Email

Sign-up for Updates

Stay up-to-date with the latest news, updates, and releases with the NHERI Newsletter and the SimCenter Newsletter newsletters.


Release License

License

HydroUQ is released as an open-source research application under a BSD 2-Clause License

Acknowledgement

This material is based upon work supported by the National Science Foundation under Grant No. 1612843 and No. 2131111. Any opinions, findings, conclusions or recommendations expressed in this material are those of the author(s) and do not necessarily reflect the views of the U.S. National Science Foundation.