https://github.com/marco210210/football-analytics
Football Analytics is a project that collects, analyzes, and visualizes performance data for football teams and players during the Serie A 2017/18 season, using database structures and machine learning models to provide insights into match events and player actions.
https://github.com/marco210210/football-analytics
data-analytics data-preprocessing data-visualization football-analytics football-performance-analysis machine-learning mongodb mplsoccer python sports-data
Last synced: 4 months ago
JSON representation
Football Analytics is a project that collects, analyzes, and visualizes performance data for football teams and players during the Serie A 2017/18 season, using database structures and machine learning models to provide insights into match events and player actions.
- Host: GitHub
- URL: https://github.com/marco210210/football-analytics
- Owner: Marco210210
- Created: 2025-04-30T17:47:48.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-06T15:25:29.000Z (about 1 year ago)
- Last Synced: 2025-07-27T00:37:22.078Z (12 months ago)
- Topics: data-analytics, data-preprocessing, data-visualization, football-analytics, football-performance-analysis, machine-learning, mongodb, mplsoccer, python, sports-data
- Language: Python
- Homepage:
- Size: 33.1 MB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Football Analytics – Serie A 2017/18
**Football Analytics** is a comprehensive project designed to collect, analyze, and visualize performance data for football teams and players during the Serie A 2017/18 season. The project uses a sophisticated database structure and machine learning models to provide insights into match events, player actions, and team performance.
---
## 🌐 Project Overview
The goal of this project is to build a system that allows for detailed analysis of football events, focusing on Serie A 2017/18 matches. By utilizing Kaggle's Soccer Match Event Dataset and additional data from FBref via web scraping, this project offers:
- **Data Preprocessing**: Cleaning and transforming raw football data.
- **Database Design**: Creating a robust database to store match events, player stats, and more.
- **Analysis**: Detailed analysis of events like passes, shots, and actions during the match.
- **Visualization**: Interactive visualizations of player movements, actions, and performance metrics.
---
## 🛠️ Technologies & Tools
- **Languages**: Python
- **Libraries**: Pandas, NumPy, Scikit-learn, mplsoccer, Electron
- **Database**: MongoDB (NoSQL)
- **Data Sources**: Kaggle, FBref
- **Machine Learning Models**: Not specified in the current document
- **Visualizations**: mplsoccer for football-specific data visualizations
---
## 📁 Repository Structure
```
Football_Analytics/
├── code/ → Source code and implementation files
│
├── dataset.r → Compressed dataset (ZIP file, includes all relevant datasets)
│
├── docs/ → Documentation
│ ├── Football_Analytics.pptx → PowerPoint presentation about the project
│ ├── Football_Analytics_RAD.pdf → Requirement Analysis Document
│ └── Project_Documentation_Football_Analytics.pdf → Final project documentation
│
└── README.md → Project documentation (this file)
```
---
## 🚀 How to Use
1. Clone the repository:
```bash
git clone https://github.com/Marco210210/Football-Analytics.git
```
2. Download the dataset from Kaggle or via the provided link in the `dataset/` directory. The dataset is not included in this repository due to size limitations.
3. Explore the code in the `code/` directory for the data preprocessing and analysis scripts.
4. The `Football_Analytics.pptx` file provides an overview of the project, while the PDF documents in `docs/` offer detailed documentation and requirement analysis.
---
## 📄 Documentation
- [Project Report (PDF)](docs/Project_Documentation_Football_Analytics.pdf)
- [Requirement Analysis Document (PDF)](docs/Football_Analytics_RAD.pdf)
---
## 👥 Contributors
- [Arcangeli Giovanni](https://github.com/GiovanniArcangeli)
- [Ciancio Vittorio](https://github.com/VittorioCiancio)
- Di Maio Marco
---
## 📄 License
This project is licensed under the [CC BY-NC-SA 4.0 License](https://creativecommons.org/licenses/by-nc-sa/4.0/)
[](https://creativecommons.org/licenses/by-nc-sa/4.0/)
You may share and adapt this work for non-commercial purposes only, **as long as you give appropriate credit** and **distribute your contributions under the same license**.
For commercial use, **explicit permission from the authors is required**.