FluidVerse/3D_SABW_SSOOSS

---
license: cc-by-nc-4.0
tags:
- CFD
- Multiphase
- CompressibleFlow
- SciML
- Bubbles
- Shock
- 3D
pretty_name: 3D Shock-Induced Air Bubble Collapse in Water
size_categories:
- 1K<n<10K
---

# 3D Shock-Induced Air Bubble Collapse in Water
## Description

The dataset captures the time-evolving behavior of 3D spherical air bubbles subjected to an external shock wave in water.
The interaction with the shock wave results in a collapse of the air bubble.
Here we investigate a scenario with symmetric boundary conditions at the north, south, top and bottom walls.

<div style="display:flex;justify-content:center">
<video style="width:100%;max-width:800px" src="https://huggingface.co/datasets/FluidVerse/3D_SABW_SSOOSS/resolve/main/3D_SABW_SSOOSS_Mas1.30.mp4" loop autoplay muted></video>
</div>

## About the data
|Metadata|Description|
|-----|------|
|Solver|[ALPACA](https://www.sciencedirect.com/science/article/abs/pii/S0010465521003581)|
|PDE|2D compressible Euler equations|
|Dimension|3D|
|Number of Trajectories|180|
|Train-Test-Split|0.8 - 0.2|
|Number of Timesteps|51|
|Simulation End Time|15 \\( \mu s \\)|
|Save Interval|0.3 \\( \mu s \\)|
|Fields| - density_mixed <br/> - density_water <br/> - density_air <br/> - pressure <br/> - velocityX <br/> - velocityY <br/> - velocityZ <br/> - volume_fraction_water|
|Simulation Resolution|512x256x256 (Clipped and Downsampled)|
|Dataset Resolution|256x256x256 & 128x128x128|
|Grid Type|Cartesian Uniform Grid|
|Initial Condition|The bubbles are in equilibrium with the surrounding pre-shock environment.|
|Boundary Conditions| North: Symmetry <br/> South: Symmetry <br/> Top: Symmetry <br/> Bottom: Symmetry <br/> East: Open <br/> West: Open|
|Conditioning Parameters| Shock Mach Number [1.3 - 2.1] <br/> Bubble Count [1 - 5] <br/> Bubble Radius [2mm - 3.5mm] <br/> Bubble Center Position [Random in Domain]

Further metadata information can be found in the corresponding `metadata.json` file.

## Dataset Structure
The train.h5 and test.h5 in this repository are meta hdf5 files that link to multiple subparts inside the corresponding subset folder.
The mentioned train-test-split [0.8 - 0.2] is only valid when all subparts inside the subset folder are present.

## Key Challenges for Surrogate Modelling
- Accurate interface capturing
- Peak pressure in the domain
- Understanding wave dynamics
- Tracking bubble fragments

## How to Download the Dataset

Download the whole dataset:
```
hf download FluidVerse/3D_SABW_SSOOSS --repo-type dataset
```

Download only part of the dataset with resolution 128x128x128:
```
from huggingface_hub import snapshot_download

snapshot_download(
repo_id="FluidVerse/3D_SABW_SSOOSS",
repo_type="dataset",
allow_patterns="3d_shock_multi_air_bubble_collapse_in_water/128x128x128/*",
local_dir="."
)
```