Generates synthetic communicating vessels (fluid dynamics) tasks. The goal is to simulate the settling process of liquid in a system of communicating vessels, showing how liquid levels equalize through hydrostatic pressure and viscous resistance until reaching equilibrium.
Each sample pairs a task (first frame + prompt describing what needs to happen) with its ground truth solution (final frame showing the result + video demonstrating how to achieve it). This structure enables both model evaluation and training.
| Property | Value |
|---|---|
| Task ID | O-75 |
| Task | Communicating Vessels |
| Category | Knowledge |
| Resolution | 1024×1024 px |
| FPS | 16 fps |
| Duration | ~3-5 seconds |
| Output | PNG images + MP4 video |
# Clone the repository
git clone https://github.com/Jiaqi-Gong/Gong_VBVR_Data.git
cd Gong_VBVR_Data/O-75_communicating_vessels_data-generator
# Install dependencies
pip install -r requirements.txt# Generate 100 samples
python examples/generate.py --num-samples 100
# Generate with specific seed
python examples/generate.py --num-samples 100 --seed 42
# Generate without videos
python examples/generate.py --num-samples 100 --no-videos
# Custom output directory
python examples/generate.py --num-samples 100 --output data/my_output| Argument | Type | Description | Default |
|---|---|---|---|
--num-samples |
int | Number of samples to generate | Required |
--seed |
int | Random seed for reproducibility | Random |
--output |
str | Output directory | data/questions |
--no-videos |
flag | Skip video generation | False |
A system of 4 communicating vessels with equal-diameter vertical tubes is filled with syrup (syrup-like (very high viscosity)), which appears maroon in color. As shown in the initial frame, the liquid levels in the tubes are [9, 16, 9, 52] cm respectively. Due to pressure differences between the tubes, the liquid begins to flow through the connecting channels at the bottom. The flow is governed by hydrostatic pressure equalization and damped by viscous resistance with coefficient k=0.59. As the liquid redistributes, the height differences gradually decrease, and the system evolves toward equilibrium. Eventually, through conservation of volume, all tubes reach the same final liquid level, which equals the average of the initial heights. Simulate this settling process from the initial unbalanced state to the final stable equilibrium.
 |
 |
 |
| Initial Frame Vessels with different liquid levels |
Animation Liquid flowing and equalizing |
Final Frame All vessels at equilibrium level |
Simulate the settling process of liquid in a system of communicating vessels, showing how liquid levels equalize through hydrostatic pressure and viscous resistance until reaching equilibrium.
- Number of Tubes: 2-5 vertical tubes
- Liquid Types: Water (blue, low viscosity), oil (yellow, medium), honey (orange, high), syrup (maroon, very high)
- Gravity: 9.8 m/s² (Earth standard)
- Viscosity: Damping coefficient k varies by liquid type (0.5-4.5)
- Tube Dimensions: 91px width, 650px max height
- Connecting Base: 91px height horizontal connecting tube
- Initial Levels: Different liquid levels in each tube
- Equilibrium: Final level equals average of initial heights (volume conservation)
- Fluid dynamics: Tests understanding of hydrostatic pressure and fluid flow
- Pressure equalization: Demonstrates how pressure differences drive flow
- Viscous resistance: Models damping effects of different liquid viscosities
- Volume conservation: Final level equals average of initial heights
- Multiple liquid types: Different viscosities and colors for variety
- Smooth animation: Shows gradual equalization process
data/questions/communicating_vessels_task/communicating_vessels_00000000/
├── first_frame.png # Initial state (unequal liquid levels)
├── final_frame.png # Goal state (equalized levels)
├── prompt.txt # Task instructions
├── ground_truth.mp4 # Solution video (16 fps)
└── question_metadata.json # Task metadata
File specifications: Images are 1024×1024 PNG. Videos are MP4 at 16 fps, approximately 3-5 seconds long.
communicating-vessels fluid-dynamics hydrostatic-pressure pressure-equalization viscous-resistance physics fluid-mechanics