DATA_SUMMARY.md

# Sports Analysis Dataset - Data Summary

<!--
RSK World
Founder: Molla Samser
Designer & Tester: Rima Khatun
Email: help@rskworld.in
Phone: +91 93305 39277
Address: Nutanhat, Mongolkote, Purba Burdwan, West Bengal, India, 713147
Website: https://rskworld.in/
-->

## Dataset Contents

This document summarizes the actual data files included in the Sports Analysis Dataset.

### ✅ Created Files

#### Annotations (JSON & CSV)

1. **`data/annotations/tracking_001.json`**
- Football game player tracking data
- 8 player position records
- Ball position tracking
- Timestamps and field positions

2. **`data/annotations/tracking_002.json`**
- Basketball game player tracking data
- 4 player position records
- Ball position tracking
- Court positions

3. **`data/annotations/events_001.json`**
- Football game events
- 5 events: 1 goal, 1 foul, 1 substitution, 1 penalty, 1 timeout
- Event locations and descriptions
- Video timestamps

4. **`data/annotations/events_002.json`**
- Basketball game events
- 2 events: 1 goal (3-point shot), 1 foul
- Event locations and descriptions

5. **`data/annotations/performance_metrics_001.csv`**
- Performance metrics for 8 players
- Distance covered, speed, acceleration, heart rate
- Team and jersey number information

#### Metadata

6. **`data/metadata/games_metadata.json`**
- Complete dataset metadata
- Information about 2 games (Football and Basketball)
- Video file references
- Dataset statistics

7. **`data/structure.json`**
- Dataset structure definition
- Field specifications
- Usage examples

#### Documentation

8. **`data/videos/README.md`**
- Instructions for video files
- Video specifications
- File naming conventions

### 📦 Dataset Archive

**`sports-analysis.zip`** - Created successfully!
- Contains all annotation files
- Contains metadata files
- Contains documentation
- Contains example code
- Size: ~0.01 MB (without video files)

### 📊 Data Statistics

- **Total Games**: 2
- Game 001: Football (90 minutes)
- Game 002: Basketball (48 minutes)

- **Total Annotations**:
- Player tracking records: 12+
- Event records: 7
- Performance metrics: 8 players

- **Sports Covered**: Football, Basketball

- **File Formats**: JSON, CSV

### 🎥 Video Files

**Note**: Video files (MP4/MOV) are not included in the ZIP due to size constraints.

Expected video files:
- `data/videos/game_001.mp4` - Football game (90 min, 1080p, 30fps)
- `data/videos/game_002.mp4` - Basketball game (48 min, 1080p, 30fps)

See `data/videos/README.md` for video specifications.

### 📁 Directory Structure

```
data/
├── annotations/
│ ├── tracking_001.json ✅ Created
│ ├── tracking_002.json ✅ Created
│ ├── events_001.json ✅ Created
│ ├── events_002.json ✅ Created
│ └── performance_metrics_001.csv ✅ Created
├── metadata/
│ └── games_metadata.json ✅ Created
├── videos/
│ └── README.md ✅ Created
└── structure.json ✅ Created
```

### 🔧 Scripts

- **`scripts/create_dataset_zip.py`** - Python script to create ZIP archive
- **`scripts/create_dataset_zip.bat`** - Windows batch script
- **`scripts/create_dataset_zip.sh`** - Linux/Mac shell script

### 📝 Usage

1. **View annotations**: Open JSON files in any text editor or JSON viewer
2. **Analyze data**: Use the example Python scripts in `examples/`
3. **Create ZIP**: Run `python scripts/create_dataset_zip.py`
4. **Add videos**: Place MP4/MOV files in `data/videos/` directory

### 🔄 Regenerating the ZIP

To update the ZIP file after adding new data:

```bash
# Windows
scripts\create_dataset_zip.bat

# Linux/Mac
bash scripts/create_dataset_zip.sh

# Or directly with Python
python scripts/create_dataset_zip.py
```

### 📧 Contact

**RSK World**
- Email: help@rskworld.in
- Phone: +91 93305 39277
- Website: https://rskworld.in/

---

© 2026 RSK World. All rights reserved.