7. Release Notes

7.1. Version 3

Version 3.0.0 (Current)

Release date: March 20th, 2024

Simulation types:

  1. Added Material Point Method via ClaymoreUW.

  2. Updated Finite Volume Method + Finite Element Method via FOAMySees (OpenFOAM + OpenSees).

  3. Partially deprecating Shallow Water Equations + Finite Volume Method via (GeoClaw + OpenFOAM). Pending an update in an upcoming minor release.

Physics

Broad capabilities of the underlying physics simulation now include:

  1. Large deformations

  2. Nonlinear materials

  3. Multi-material and multi-phase interaction

  4. Debris-fluid-structure interaction

Debris

  1. Added debris modeling to MPM simulations.

  2. Added support for complex debris geomtries (e.g. vehicles, shipping crates, composed primitives).

  3. Added support for advanced debris material models (e.g. Fixed-Corotated, Neo-Hookean, Drucker-Prager, Non-Associative Cam-Clay).

User Interface

Significant overhaul of the Event GUI to allow for a more intuitive and user-friendly experience. Includes backend updates to the schema and application logic to support the new features.

  1. Settings:

    • Added a settings panel for setting simulation parameters (e.g. time step, characteristic length, domain size, CFL number).

    • Added a settings panel for setting computer parameters (e.g. number of cores, number of GPUs, etc.).

    • Added a settings panel for setting similitude parameters (e.g. Froude scale, Cauchy scale, etc.).

  2. Bodies:

    Any entity in a simulation that is not a boundary condition or sensor is considered a Body. Bodies, the collection of Body objects, may be composed of particles, or meshes. Each Body is specified by its Material, Geometry, Algorithm, and Partitions.

    1. Material:

      1. Supports elastic, hyperelastic, and elasto-plastic material models.

      2. New constitutive laws:

        • J-Fluid: Weakly-compressible isotropic fluid with viscous shear stress. Uses the Tait-Murnaghan equation of state.

        • Fixed-Corotated: Hyperelastic material model for plastic and rubber-like materials.

        • Neo-Hookean: Hyperelastic material model for plastic and rubber-like materials.

        • Drucker-Prager: Applicable to granular materials, concrete, and other materials with a yield surface.

        • Non-Associative Cam-Clay: Aplicable to clays, concrete, and other topology changing material bodies

    2. Geometry:

      • Added a composable geometry editor for creating and modifying geometry.

      • Implemented boolean operations for geometry (e.g. union, intersection, difference).

      • Implemented array operations for geometry (e.g. create an array of the same geometry at specified spacings in X, Y, and Z).

      • Implemented rotation operations for geometry (e.g. rotate a geometry about an axis by a specified angle).

      • Implemented translation operations for geometry (e.g. translate a geometry by a specified distance in X, Y, and Z).

      • Implemented geometry file import from .sdf files.

      • Added geometry primitives (e.g. sphere, box, cylinder).

    3. Algorithm:

      • Implemented Affine Particle-in-Cell (APIC) algorithm for MPM

      • Implemented Fluid-Implicit Particles (FLIP) algorithm for MPM

      • Implemented Affine-Separable Fluid-Implicit Particles (ASFIP) algorithm for MPM

      • Implemented F-Bar volumetric antilocking algorithm for MPM

      • Implemented quadratic B-Spline shape functions for MPM

    4. Partitions:

      • Bodies may be split across multiple hardware partitions.

      • Accelerates simulation times by running multiple bodies in parallel.

      • A valid hardware partition may be a core, a GPU, or a node in an HPC cluster.

      • Each partition may hold some maximum number of bodies at once (specific to the system which the simulating tool was compiled on).

  3. Boundaries:

    Any object in a simulation that is not a sensor or body is considered a Boundary. Boundaries, the collection of Boundary objects, are enforced boundary conditions which may apply to parts of the simulation (e.g. on grid-nodes or particles).

    • Added boundaries for geometry primitives (e.g. sphere, box, cylinder).

    • Added selectable contact models (e.g. Sticky, Slip, Separable).

    • Added boundaries for the OSU LWF, OSU DWB, and WU TWB digital twin bathymetries.

    • Added boundaries for the OSU LWF and OSU DWB moving piston wave-makers.

    • Implemnted array operations for boundary conditions (e.g. create an array of the same boundary at specified spacings in X, Y, and Z).

  4. Sensors:

    Any object in a simulation that is not a boundary condition or body is considered a Sensor. Sensors, the collection of Sensor objects, are used to monitor the simulation, collect desired data, reduce said data, and report the aggregated output as a time-series. In effect, they replicate instruments / sensors used in experiments (e.g. load-cells, wave-gauges, piezometers, velocimeters).

    • Sensors may be placed in the simulation (e.g. on particles or grid-nodes) to monitor the simulation.

    • Supports force, pressure, velocity, and elevation sensors by default.

    • Custom sensors may be added to the simulation through the GUI.

    • Supports reduction operations (e.g. sum, average, max, min) for sensor data.

    • Allows specification of sensor output frequency.

  5. Outputs:

    Collection of simulation settings that does not effect the simulation itself, but rather the output it gives to the user.

    • Supports output of simulation geometry data in the form of .bgeo files, .vtk files, and .csv files.

    • Supports output of simulation sensor data in the form of .csv and .txt files.

    • Supports output of simulation state data in the form of .bgeo files.

    • Enable / disable tracking of and output of simulation energy (kinetic, strain, etc.).

    • Enable / disable output of simulation checkpoints (allow for a simulation to be resumed if stopped).

Visualization

  • Enabled visualizationof the Event (EVT) using Qt3D and VTK

  • Implemented a Model-View-Controller (MVC) architecture for the Event GUI.

  • Added support for visualizing simulation Bodies in 3D.

  • Added support for visualizing simulation Boundaries in 3D.

  • Added support for visualizing simulation Sensors in 3D.

Digital Twins

  • Digital twins now allow for debris and floating bodies.

  • Added Oregon State University’s Large Wave Flume (OSU LWF) as a digital twin for MPM.

  • Added Oregon State University’s Directional Wave Basin (OSU DWB) as a digital twin for MPM.

  • Added Waseda University’s Tsunami Wave Basin (WU TWB) as a digital twin for MPM.

DesignSafe Support and Hardware

  • Multi-GPU accelerated simulations now supported in certain simulation types (e.g. ClaymoreUW MPM).

  • Updated support for the TACC Frontera supercomputer:

    1. Access the rtx queue. Includes 4 NVIDIA RTX Quadro 5000 GPUs (16GB memory each).

  • Added support for the TACC Lonestar6 supercomputer:

    1. Access the gpu-h100 queue. Includes 2 NVIDIA H100 GPUs (80GB memory each).

    2. Access the gpu-a100 queue. Includes 3 NVIDIA A100 GPUs (40GB memory each).

    3. Access the gpu-a100-small queue. Includes 1 NVIDIA A100 GPU (40GB memory).

  • Updated support for the Tapis API used to run jobs remotely.

Tools

  • Events (EVT) may now run as standalone tools (i.e. does not require a SimCenter workflow for UQ, etc.)

  • Added Tapis API support for running Tools remotely, allowing for specialized Tapis applications and system/queue selection

Examples

  • Added example simulations for OSU LWF digital twin in FOAMySees

  • Added example simulations for OSU LWF digital twin in ClaymoreUW.

  • Added example simulations for WU TWB digital twin in ClaymoreUW.

7.2. Version 2.0

Version 2.0.0
Release date: November 30th, 2023

  1. Simulation types:

    1. Finite Volume Method + Finite Element Method via FOAMySees (OpenFOAM + OpenSees). Two-way FSI coupling between CFD and structural solvers.

  2. Digital Twin

    1. OSU LWF digital twin now supports FOAMySees (OpenFOAM + OpenSees).

    2. Added options for adjustable bathymetry and flexible two-way coupled structures.

  3. New multi-model and multi-fidelity modeling options

7.3. Version 1.0

Version 1.0.0

Release date: Apr 30th, 2021

  1. Supports run on DesignSafe only. Local run on the user’s desktop is not supported.

  2. HydroUQ app v1.0.0 currently requires the users to ensure that the inputs provided are

  3. Supports two-phase isothermal flows only. Water and air are considered as the two primary phases. However, this can be modified in the material properties to accommodate any other alternative two-phases instead.

  4. Simulation types:

    1. CFD to resolve SW (Using SW results), CFD using bathymetry data, CFD of wave flume is supported.

    2. For simulation type with SW-CFD coupling, v1.0.0 considers one point on the interface. However, if you would like more flexibility, please let us know using the Bugs & Feature Requests.

  5. Geometry:

    1. Geometry can be imported as Bathymetry files (GeoClaw format - type 1), STL files, or the Hydro flume digital twin.

    2. Shallow-water to CFD interface can be imported as a .csv file only.

    3. Buildings of cuboid shapes are supported in v1.0.0. For other shapes, the user can upload them as an STL file. The buildings need to be specified in the table or can be generated parametrically. Importing buildings as a .csv file is not currently supported in v1.0.0 but can be requested using the Bugs & Feature Requests.

    4. Floating bodies and debris modeling are not supported in v1.0.0. Support will be added in upcoming versions. If you are interested in this feature, please write to us at Bugs & Feature Requests.

  6. Meshing:

    1. Supports blockMesh and snappyHexMesh for internal meshing.

    2. Supports import for the following mesh formats: Ansys Fluent (.msh), Ansys I-DEAS (.ans), CFX mesh (.geo), GAMBIT mesh (.neu), Gmsh mesh (.msh).

    3. Supports import of OpenFOAM mesh dictionaries, namely the blockMeshDict and snappyHexMeshDict. Additionally, surfaceFeatureExtractDict is required if STL files are used to define the geometry.

  7. Materials:

    1. Supports Newtonian materials only.

    2. Supports kinematic viscosity and density of the two phases in addition to the surface tension between the fluids.

  8. Initial conditions:

    1. For CFD simulations that resolve the shallow-water solutions, the initial conditions are derived from the shallow-water solutions.

    2. For all other simulation types, the user-specified initial conditions include phase only.

  9. Boundary conditions:

    1. The boundary conditions can be selected based using standard patch names. Here standard patches include entry / exit / inlet / outlet / left / right.

    2. Velocity boundary conditions for inlet conditions include shallow-water solutions, moving wall, and constant velocity; for outlet conditions include zeroGradient and inletOutlet

    3. Pressure boundary conditions include zeroGradient and fixedValue. Alternatively, the user can also leave the default option. An appropriate boundary condition relevant to the velocity boundary will be chosen.

    4. It is recommended to use the wall boundary conditions for walls

  10. Domain decomposition and solver:

    1. Allows simple decomposition techniques from OpenFOAM.

    2. Can set start and end times for simulation

    3. Can set time interval and the write intervals

    4. Restarting facility is supported

  11. Turbulence:

    1. Presently, only RANS is supported for turbulence modeling.

    2. If you would like to use LES, please let us know about it using Bugs & Feature Requests.