Generates synthetic physics simulation tasks involving domino chains that split into two branches. The task is to predict which dominos will fall based on the chain structure and the presence of gaps that stop the chain reaction.
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-23 |
| Task | Domino Chain Branch Path Prediction |
| Category | Knowledge |
| Resolution | 1024×1024 px |
| FPS | 16 fps |
| Duration | varies |
| Output | PNG images + MP4 video |
# Clone the repository
git clone https://github.com/VBVR-DataFactory/O-23_domino_chain_branch_path_prediction_data-generator.git
cd O-23_domino_chain_branch_path_prediction_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 | 100 |
--seed |
int | Random seed for reproducibility | Random |
--output |
str | Output directory | data |
--no-videos |
flag | Skip video generation | False |
Push the green START domino to begin the chain reaction. Show the complete domino falling process. The dominos fall step by step from left to right, turning darker as they fall. The dark gray trunk falls first, then splits into the red Branch A (upward) and blue Branch B (downward). Branch A has a gap marked with a red X that stops the chain reaction in that branch The final state shows Branch A with fallen dominos before the gap and standing dominos after, while Branch B completes fully.
 |
 |
 |
| Initial Frame Domino chain with branch structure |
Animation Dominos falling in sequence through branches |
Final Frame All reachable dominos fallen |
Predict and animate which dominos will fall when a domino chain with branching paths is triggered. Some branches may have gaps (marked with red X) that stop the chain reaction.
- Chain Structure: Linear trunk of 1-3 dominos that splits into two branches
- Branches: Upper branch (Branch A) and lower branch (Branch B), each with 2-4 dominos
- Color Coding: Start domino (green), trunk (gray), Branch A (red/pink), Branch B (blue/cyan)
- Gaps: 30% probability of a gap in one branch, marked with red X
- Physics: Dominos fall left-to-right in sequence, turning darker when fallen
- Branch path prediction: Tests understanding of chain reaction propagation through multiple paths
- Gap detection: Identifies which branches will be blocked by gaps
- Sequential physics: Dominos fall in order, respecting spatial connectivity
- Visual state change: Fallen dominos turn darker (50% opacity) and tilt right
- Color-coded branches: Different colors help distinguish branch paths
- Partial completion: Branches with gaps show which dominos fall before the gap
- Two outcomes: Either both branches complete, or one branch is blocked by a gap
data/questions/domino_chain_branch_path_prediction_task/domino_chain_branch_path_prediction_00000000/
├── first_frame.png # Initial state (all dominos standing)
├── final_frame.png # Final state (fallen dominos after chain reaction)
├── 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, duration varies based on chain length.
physics-simulation domino-effect chain-reaction path-prediction branching sequential-propagation gap-analysis
