# PossessionLab

> Advanced basketball analytics platform for EuroLeague and EuroCup, combining advanced metrics, interactive visualizations, and an AI-powered analytics assistant.

PossessionLab goes beyond standard box scores. It covers both EuroLeague and EuroCup across multiple historical seasons in a single interface, and offers tools typically found only in NBA analytics contexts applied to European basketball.

## What Makes It Different

- **AI analytics assistant** — A RAG-based chat interface where users can ask natural-language questions about players, teams, and games and get data-grounded answers
- **Assist heatmaps** — Per-team heatmap showing where assists originate and where they connect on the court
- **Player shot charts** — Visual zone-by-zone shot distribution for individual players
- **Player similarity search** — Find statistically similar players across seasons and competitions
- **Kill Impact Dashboard** — Correlation analysis of scoring dominance ("kills") vs win rate, with scatter plots and Pearson r coefficients per team
- **Radar player profiles** — Per-player radar charts for multi-dimensional skill comparison
- **Head-to-head matchup analysis** — Full breakdown when two specific teams meet
- **Advanced metrics** — Offensive rating, defensive rating, net rating, pace, true shooting %, effective FG%, PIR, and VAL/G — not just points/rebounds/assists
- **Side-by-side player or team comparison** — Overlay any two players or teams on the same chart
- **EuroLeague + EuroCup** — Both competitions switchable from a single interface, same analytical depth

## Pages

- [Dashboard](https://possessionlab.eu/): Season overview, top performers, team ratings
- [Players](https://possessionlab.eu/players): Per-player advanced stats
- [Player Detail](https://possessionlab.eu/players/:id): Shot chart, radar profile, season trends
- [Teams](https://possessionlab.eu/teams): Team advanced stats (off_rtg, def_rtg, net_rtg, pace) with assist heatmaps
- [Leaders](https://possessionlab.eu/leaders): Statistical leaders — PPG, RPG, APG, SPG, BPG, TS%, eFG%, VAL/G
- [Standings](https://possessionlab.eu/standings): Current league standings
- [Games](https://possessionlab.eu/games): Full game log with box scores
- [Schedule](https://possessionlab.eu/schedule): Season schedule
- [Matchup](https://possessionlab.eu/matchup): Head-to-head team analysis
- [Compare](https://possessionlab.eu/compare): Side-by-side player or team comparison
- [Similarity](https://possessionlab.eu/similarity): Statistically similar players or teams
- [Kill Impact](https://possessionlab.eu/kills): Scoring dominance correlation analysis
- [Glossary](https://possessionlab.eu/glossary): Metric definitions and abbreviations
- [AI Chat](https://possessionlab.eu/chat): Natural-language analytics assistant

## Coverage

- Competitions: EuroLeague, EuroCup
- Multiple historical seasons queryable together
- Data refreshed regularly from official sources