Skip to content

VBVR-DataFactory/G-221_outline_innermost_square_data-generator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

Image Image Image
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


About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages