Generates synthetic datasets for training and evaluating vision models on shape symmetry and mirroring tasks. Each sample contains a continuous shape on one half of a grid that must be mirrored symmetrically to create a complete symmetric 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.
| Property | Value |
|---|---|
| Task ID | G-38 |
| Task | Symmetry Shape |
| Category | Abstraction |
| Resolution | 1024×1024 px |
| FPS | 16 fps |
| Duration | ~3 seconds |
| Output | PNG images + MP4 video |
# 1. Clone the repository
git clone https://github.com/VBVR-DataFactory/G-38_symmetry_shape_data-generator.git
cd G-38_symmetry_shape_data-generator
# 2. Create and activate virtual environment
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# 3. Install dependencies
pip install --upgrade pip
pip install -r requirements.txt
pip install -e .# Generate 50 samples
python examples/generate.py --num-samples 50
# Custom output directory
python examples/generate.py --num-samples 100 --output data/my_dataset
# Reproducible generation with seed
python examples/generate.py --num-samples 50 --seed 42
# Without videos (faster)
python examples/generate.py --num-samples 50 --no-videos| Argument | Description |
|---|---|
--num-samples |
Number of tasks to generate (required) |
--output |
Output directory (default: data/questions) |
--seed |
Random seed for reproducibility |
--no-videos |
Skip video generation (images only) |
The scene shows a grid with a continuous shape on the left half. Expand the shape symmetrically to the right half by mirroring it across the vertical axis, creating a complete symmetric shape.
 |
 |
 |
| Initial Frame Continuous shape on left half of grid |
Animation Shape mirrored across vertical axis |
Final Frame Complete symmetric shape |
Create a vertically symmetric shape by mirroring a continuous shape from one half of the grid to the other half.
- Grid structure: Regular grid with vertical center axis
- Initial shape: Continuous connected shape on left half
- Symmetry axis: Vertical center line (left-right mirror)
- Pattern type: Continuous shape (connected regions, not scattered)
- Mirroring direction: Left to right across vertical axis
- Background: White grid with clear axis indication
- Goal: Create perfect mirror symmetry to complete the shape
- Continuous shape pattern (connected regions)
- Vertical axis symmetry (left-right mirroring)
- Pixel-perfect symmetric placement
- Grid-based positioning for precise alignment
- Tests understanding of shape reflection
- Creates aesthetically complete symmetric forms
data/questions/symmetry_shape_task/symmetry_shape_00000000/
├── first_frame.png # Grid with shape on left half
├── final_frame.png # Complete symmetric shape
├── prompt.txt # Shape symmetry expansion instruction
├── ground_truth.mp4 # Animation of shape mirroring
└── question_metadata.json # Task metadata
File specifications:
- Images: 1024×1024 PNG format
- Video: MP4 format, 16 fps
- Duration: ~3 seconds
visual-reasoning symmetry mirroring shape-completion spatial-reasoning reflection