# Sports Analysis Dataset

<!--
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/
-->

## Overview

Sports video dataset with game footage, player tracking, and event annotations for sports analytics and performance analysis.

This dataset contains sports video footage with player tracking, game events, and performance annotations. Perfect for sports analytics, player tracking, event detection, and performance analysis applications.

## Dataset Information

- **ID**: 29
- **Title**: Sports Analysis Dataset
- **Category**: Video Data
- **Difficulty**: Advanced
- **Technologies**: MP4, MOV, OpenCV, Tracking, Video Analysis

## Features

- ✅ Game footage
- ✅ Player tracking
- ✅ Event annotations
- ✅ Multiple sports
- ✅ Ready for sports AI

## Technologies Used

- **MP4**: Standard video format for game footage
- **MOV**: Alternative video format support
- **OpenCV**: Computer vision and image processing
- **Tracking**: Player and object tracking algorithms
- **Video Analysis**: Advanced video processing and analytics

## Installation

1. Download the dataset from the [download section](#download) or use the direct link: `./sports-analysis/sports-analysis.zip`
2. Extract the ZIP file to your desired location
3. Review the documentation included in the dataset

## Usage

This dataset is designed for:

- Sports analytics research
- Player tracking algorithm development
- Event detection and classification
- Performance analysis applications
- Machine learning and AI model training
- Computer vision projects

## File Structure

```
sports-analysis/
├── index.html # Main demo page
├── README.md # This file
├── assets/
│ ├── css/
│ │ └── style.css # Stylesheet
│ └── js/
│ └── main.js # JavaScript functionality
├── sports-analysis.zip # Dataset archive
└── sports-analysis.png # Project image
```

## Demo

Visit the demo page at: `./sports-analysis/`

## Contact

**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/

## License

This dataset is provided by RSK World for research and development purposes.

## Support

For questions, support, or inquiries about this dataset, please contact us at help@rskworld.in or visit https://rskworld.in/

---

© 2026 RSK World. All rights reserved.

# Release Notes - Sports Analysis Dataset v2.0.0

<!--
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/
-->

## 🎉 Version 2.0.0 - Advanced Features Release

**Release Date:** January 15, 2026
**Repository:** https://github.com/rskworld/sports-analysis

---

## 📦 What's New

This release introduces major advanced features including interactive dashboards, data exploration tools, REST API server, and comprehensive documentation.

### ✨ Key Features

#### 🎯 Interactive Analytics Dashboard
- Real-time statistics cards showing key metrics
- Interactive charts (Chart.js):
- Events distribution (doughnut chart)
- Sports coverage (bar chart)
- Player performance metrics (line chart)
- Top performers leaderboard
- Comprehensive games data table
- Export functionality (CSV, JSON)

#### 🔍 Data Explorer
- Advanced search and filter interface
- Multi-filter system (sport, event type, date range)
- Real-time result updates
- Quick statistics sidebar
- Export filtered results to JSON

#### 🚀 REST API Server
- Complete RESTful API with 6 endpoints
- JSON responses with CORS support
- Query parameter filtering
- Express.js server implementation
- Full API documentation

#### 📊 Advanced Statistics Calculator
- Python-based statistics calculator
- Player distance calculation
- Average speed analysis
- Event statistics
- Performance metrics analysis
- Comprehensive report generation

#### 📚 Enhanced Documentation
- Complete installation guide with step-by-step instructions
- File-by-file detailed guide
- API documentation with code examples
- Advanced features documentation
- Troubleshooting guide

---

## 🆕 New Files

### HTML Pages
- `dashboard.html` - Analytics dashboard
- `explorer.html` - Data explorer interface
- `api.html` - API documentation

### JavaScript
- `assets/js/dashboard.js` - Dashboard functionality
- `assets/js/explorer.js` - Explorer functionality

### CSS
- `assets/css/dashboard.css` - Dashboard styles
- `assets/css/explorer.css` - Explorer styles

### Server & Configuration
- `server.js` - Node.js API server

### Documentation
- `ADVANCED_FEATURES.md` - Advanced features guide
- `DATA_SUMMARY.md` - Dataset contents summary
- `ERROR_CHECK_REPORT.md` - Error check documentation
- `PROJECT_SUMMARY.md` - Project overview

### Python Examples
- `examples/statistics_calculator.py` - Advanced statistics calculator

### Scripts
- `scripts/create_dataset_zip.py` - ZIP creation script
- `scripts/create_dataset_zip.bat` - Windows batch script
- `scripts/create_dataset_zip.sh` - Linux/Mac shell script

---

## 🔧 Technical Improvements

- Express.js integration for API server
- Chart.js for data visualization
- Advanced filtering algorithms
- Asynchronous data loading
- Error handling improvements
- Code organization and modularity
- Responsive design enhancements

---

## 📋 Data Files

### Annotations
- `data/annotations/tracking_001.json` - Football tracking data
- `data/annotations/tracking_002.json` - Basketball tracking data
- `data/annotations/events_001.json` - Football events (5 events)
- `data/annotations/events_002.json` - Basketball events (2 events)
- `data/annotations/performance_metrics_001.csv` - Performance data (8 players)

### Metadata
- `data/metadata/games_metadata.json` - Complete game metadata
- `data/structure.json` - Dataset structure definition

---

## 🚀 Getting Started

### Prerequisites
- Node.js (v14 or higher)
- Python 3 (v3.7 or higher)
- Modern web browser

### Installation
```bash
# Clone the repository
git clone https://github.com/rskworld/sports-analysis.git
cd sports-analysis

# Install dependencies
npm install

# Start the API server
npm start
```

### Usage
- **Main Page:** `http://localhost:3000/index.html`
- **Dashboard:** `http://localhost:3000/dashboard.html`
- **Data Explorer:** `http://localhost:3000/explorer.html`
- **API Documentation:** `http://localhost:3000/api.html`
- **API Endpoints:** `http://localhost:3000/api/games`

---

## 📖 Documentation

Complete documentation is available in the repository:
- [README.md](README.md) - Main documentation
- [INSTALLATION GUIDE](index.html#installation) - Step-by-step installation
- [API Documentation](api.html) - API reference
- [Advanced Features](ADVANCED_FEATURES.md) - Feature documentation

---

## 🐛 Bug Fixes

- Fixed file path issues in `games_metadata.json`
- Fixed duplicate scripts in `package.json`
- Improved JavaScript visibility handling
- Enhanced error handling

---

## 🔄 Migration Guide

If you're upgrading from v1.0.0:

1. Run `npm install` to install new dependencies
2. Review `CHANGELOG.md` for breaking changes
3. Check `ADVANCED_FEATURES.md` for new features
4. Update any custom scripts to use new API endpoints

---

## 📝 Changelog

See [CHANGELOG.md](CHANGELOG.md) for detailed version history.

---

## 👥 Contributors

**RSK World**
- **Founder:** Molla Samser
- **Designer & Tester:** Rima Khatun
- **Email:** help@rskworld.in
- **Website:** https://rskworld.in/

---

## 📄 License

MIT License - See [LICENSE](LICENSE) file for details.

---

## 🔗 Links

- **Repository:** https://github.com/rskworld/sports-analysis
- **Website:** https://rskworld.in/
- **Issues:** https://github.com/rskworld/sports-analysis/issues

---

**Thank you for using Sports Analysis Dataset!**

© 2026 RSK World. All rights reserved.