G-221: Outline Innermost Square Data Generator

Generates synthetic tasks where multiple concentric squares are displayed. The goal is to identify the innermost square and outline it with a blue square outline.

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	G-221
Task	Outline Innermost Square
Category	Spatiality
Resolution	1024×1024 px
FPS	16 fps
Duration	~5.3 seconds
Output	PNG images + MP4 video

---

🚀 Usage

Installation

# Clone the repository
git clone https://github.com/VBVR-DataFactory/G-221_outline_innermost_square_data-generator.git
cd G-221_outline_innermost_square_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/questions
--no-videos	flag	Skip video generation	False

---

📖 Task Example

Prompt

The scene shows multiple concentric squares (same center, from largest to smallest). Identify the innermost square and outline it with a blue square outline. Show the solution step by step.

Visual

Initial Frame Concentric squares displayed	Animation Blue outline appears on innermost square	Final Frame Innermost square outlined in blue

---

📖 Task Description

Objective

Identify the innermost (smallest, most central) square among multiple concentric squares and outline it with a blue border.

Task Setup

• Square Count: 3-5 concentric squares per image
• Arrangement: All squares share the same center point
• Size Order: Squares arranged from largest (outer) to smallest (inner)
• Marking Method: Blue square outline appears around the innermost square
• Criterion: Innermost defined as the smallest square at the center
• Unique Solution: Only one innermost square per image

Key Features

• Spatial hierarchy: Tests understanding of nested/concentric arrangements
• Size comparison: Requires identifying the smallest among nested shapes
• Center identification: Finding the most central element in a concentric pattern
• Step-by-step solution: Animation shows blue outline appearing gradually
• Clear visual feedback: Blue outline distinctly marks the target square
• Geometric reasoning: Understanding of concentric square properties

---

📦 Data Format

data/questions/outline_innermost_square_task/outline_innermost_square_00000000/
├── first_frame.png      # Initial state (concentric squares)
├── final_frame.png      # Goal state (innermost square outlined)
├── 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 5.3 seconds long.

---

🏷️ Tags

spatial-reasoning geometry concentric-shapes innermost-selection nested-structures size-comparison geometric-reasoning

---