O-27: Move 2 Object to 2 Target Data Generator

Generates synthetic path planning tasks where two objects must be moved to their corresponding target positions via the shortest path. Each object matches its target in color and shape.

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.

---

📌 Basic Information

Property	Value
Task ID	O-27
Task	Move 2 Object to 2 Target
Category	Transformation
Resolution	1024×1024 px
FPS	16 fps
Duration	varies
Output	PNG images + MP4 video

---

🚀 Usage

Installation

# Clone the repository
git clone https://github.com/VBVR-DataFactory/O-27_move_2_object_to_2_target_data-generator.git
cd O-27_move_2_object_to_2_target_data-generator

# Install dependencies
pip install -r requirements.txt

Generate Data

# 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

Command-Line Options

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

---

📖 Task Example

Prompt

In the scene there are two objects and their corresponding target outlines; each outline matches its object in color and shape. Move each object to its matching outline via shortest path. Show the movement step by step.

Visual

Initial Frame Two objects and their target outlines	Animation Objects move to matching targets	Final Frame Objects aligned with targets

---

📖 Task Description

Objective

Plan and execute paths for two objects to move simultaneously to their corresponding target positions, where each object must reach the target outline that matches its color and shape.

Task Setup

• Two Objects: Circular objects with distinct colors (e.g., pink and blue)
• Two Target Outlines: Dashed ring outlines matching each object's color and shape
• Color Correspondence: Each object matches exactly one target by color
• Shape Matching: Target outlines have the same shape (circle) as objects
• Distance Range: Objects start 150-400 px away from their targets
• Minimum Separation: At least 100 px between any two objects/targets

Key Features

• Path planning: Tests ability to plan shortest paths for multiple objects simultaneously
• Color matching: Requires identifying which target corresponds to each object
• Shape recognition: Objects and targets share the same geometric shape
• Shortest path optimization: Animation shows most direct routes to targets
• Simultaneous movement: Both objects move at the same time
• Smooth trajectories: Objects follow straight-line paths to their destinations
• Visual correspondence: Color and shape matching creates clear object-target pairs

---

📦 Data Format

data/questions/move_2_object_to_2_target_task/move_2_object_to_2_target_00000000/
├── first_frame.png      # Initial state (objects + target outlines)
├── final_frame.png      # Final state (objects at targets)
├── 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 distance traveled.

---

🏷️ Tags

path-planning spatial-reasoning object-matching color-correspondence shortest-path simultaneous-movement goal-reaching

---