G-167: Select Longest Polygon Side Data Generator

Generates synthetic tasks featuring irregular polygons where the goal is to identify and circle the longest side.

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-167
Task	Select Longest Polygon Side
Category	Perception
Resolution	1024×1024 px
FPS	30 fps
Duration	~0.8 seconds
Output	PNG images + MP4 video

---

🚀 Usage

Installation

# Clone the repository
git clone https://github.com/Jiaqi-Gong/Gong_VBVR_Data.git
cd Gong_VBVR_Data/G-167_select_longest_polygon_side_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 image shows an irregular polygon with 5 sides. First compare the lengths of all polygon edges, then mark the single longest side by drawing a small circle at its midpoint. Do not change anything else. Show the complete solution step by step.

Visual

Initial Frame Irregular polygon displayed	Animation Circle appears on longest side	Final Frame Longest side marked with circle

---

📖 Task Description

Objective

Analyze an irregular polygon to identify which side has the greatest length, then mark it with a circle.

Task Setup

• Polygon Sides: 5-8 sides (randomly selected for each sample)
• Polygon Type: Irregular (all sides have different lengths)
• Polygon Appearance: White fill with black outline
• Marking Method: Red circle placed on the longest side
• Circle Color: Red (#e74c3c) for clear visibility
• Task Variation: Multiple prompt variations to describe the task

Key Features

• Clear visualization: Polygon sides are clearly outlined and distinguishable
• Varying complexity: 5-8 sided polygons provide different difficulty levels
• Unambiguous answer: One side is definitively longest (no ties)
• Simple animation: Quick circle placement animation (less than 1 second)
• High frame rate: 30 fps for smooth visual feedback
• Geometric reasoning: Tests spatial measurement and comparison skills

---

📦 Data Format

data/questions/select_longest_polygon_side_task/select_longest_polygon_side_00000000/
├── first_frame.png      # Initial state (polygon without marking)
├── final_frame.png      # Goal state (longest side circled)
├── prompt.txt           # Task instructions
├── ground_truth.mp4     # Solution video (30 fps)
└── question_metadata.json # Task metadata

File specifications: Images are 1024×1024 PNG. Videos are MP4 at 30 fps, approximately 0.8 seconds long.

---

🏷️ Tags

geometry polygon-analysis length-comparison spatial-reasoning measurement

---