G-223: Highlight Horizontal Lines Data Generator

Generates synthetic tasks where a set of lines with various orientations is displayed. The goal is to identify and circle all horizontal lines.

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-223
Task	Highlight Horizontal Lines
Category	Perception
Resolution	1024×1024 px
FPS	16 fps
Duration	~3.8 seconds
Output	PNG images + MP4 video

---

🚀 Usage

Installation

# Clone the repository
git clone https://github.com/VBVR-DataFactory/G-223_highlight_horizontal_lines_data-generator.git
cd G-223_highlight_horizontal_lines_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

A set of lines is shown. Circle all horizontal lines. Do not change anything else.

Visual

Initial Frame Multiple lines with various orientations	Animation Red circles appear around horizontal lines	Final Frame All horizontal lines circled in red

---

📖 Task Description

Objective

Identify all lines that are perfectly horizontal (parallel to the x-axis) and circle each one with a red circle.

Task Setup

• Line Count: Multiple lines (typically 5-10) with various orientations
• Line Types: Mix of horizontal, vertical, diagonal, and oblique lines
• Horizontal Criterion: Lines parallel to the x-axis (0° angle)
• Marking Method: Red circle appears around each horizontal line
• Multiple Targets: May have zero, one, or multiple horizontal lines per image
• Precision: Only perfectly horizontal lines should be circled

Key Features

• Orientation recognition: Tests ability to identify horizontal orientation
• Multiple identification: May require circling several horizontal lines
• Angle discrimination: Distinguishing horizontal from near-horizontal lines
• Classification task: Separating one orientation category from others
• Visual analysis: Identifying line orientation without explicit angle measurements
• Step-by-step solution: Animation shows each horizontal line being circled sequentially

---

📦 Data Format

data/questions/highlight_horizontal_lines_task/highlight_horizontal_lines_00000000/
├── first_frame.png      # Initial state (lines without marking)
├── final_frame.png      # Goal state (horizontal lines circled)
├── 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 3.8 seconds long.

---

🏷️ Tags

orientation-recognition line-classification horizontal-lines angle-identification visual-discrimination geometric-reasoning

---