Generates synthetic fluid diffusion reasoning tasks. The goal is to simulate the diffusion process of an ink droplet in water, showing how ink forms downward-extending tendrils, diffuses through water creating swirling patterns, and eventually reaches uniform color distribution.
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-87 |
| Task | Fluid Diffusion Reasoning |
| Category | Knowledge |
| Resolution | 1024×1024 px |
| FPS | 16 fps |
| Duration | ~6 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-87_fluid_diffusion_reasoning_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 |
An ink droplet falls from above the center of a glass beaker filled with water. Upon entering the water, the ink forms irregular downward-extending tendrils due to gravity and initial impact. The ink then diffuses through the water, creating swirling patterns and eddies, until it reaches a stable state of uniform color distribution throughout the entire volume of water.
 |
 |
 |
| Initial Frame Ink droplet above water |
Animation Ink diffusing through water |
Final Frame Uniform color distribution |
Simulate the diffusion process of an ink droplet in water, showing how ink forms downward-extending tendrils, diffuses through water creating swirling patterns, and eventually reaches uniform color distribution.
- Ink Volume: 0.5 milliliters
- Water Volume: 200 milliliters
- Number of Particles: 1200 particles for simulation
- Diffusion Coefficient: 1.6 (controls spreading speed)
- Water Temperature: 45°C (affects diffusion speed)
- Video Duration: 6 seconds
- Process Stages: Initial impact → tendril formation → diffusion → uniform distribution
- Fluid dynamics: Tests understanding of diffusion physics
- Particle simulation: Uses particle-based simulation for realistic behavior
- Gravity effects: Ink forms downward tendrils due to gravity
- Swirling patterns: Creates natural swirling patterns and eddies
- Uniform distribution: Eventually reaches stable uniform state
- Realistic physics: Models diffusion, gravity, and fluid behavior
data/questions/fluid_diffusion_reasoning_task/fluid_diffusion_reasoning_00000000/
├── first_frame.png # Initial state (ink droplet above water)
├── final_frame.png # Goal state (uniform color distribution)
├── 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 6 seconds long.
fluid-diffusion ink-diffusion particle-simulation fluid-dynamics diffusion-physics physics fluid-mechanics