Dati Understat
Understat è la fonte principale per le metriche avanzate (xG, xA) e i dati a livello di singolo tiro.
us_players (~8.200 righe)
Aggregati stagionali per giocatore. Chiave primaria composta: (id, season_id).
| Colonna | Descrizione |
|---|---|
id |
ID giocatore su Understat |
player_id |
FK verso players (può essere NULL se non linkato) |
season_id |
Stagione |
player_name |
Nome su Understat |
games, time |
Partite e minuti |
goals, assists |
Gol e assist reali |
xG, xA |
Expected Goals / Expected Assists |
npg, npxG |
Gol/xG senza rigori |
xGChain |
Coinvolgimento nelle catene offensive che portano a tiro |
xGBuildup |
Contributo nella costruzione del gioco (escluso tiro/assist) |
shots, key_passes |
Tiri e passaggi chiave |
position |
Posizione principale |
team_title |
Nome squadra principale |
us_player_season_clubs (~8.600 righe)
Tabella ponte che collega un giocatore Understat ai club in una stagione. Gestisce i trasferimenti a metà stagione (un giocatore può avere 2 club).
| Colonna | Descrizione |
|---|---|
understat_player_id |
ID Understat |
season_id |
Stagione |
club_id |
FK verso clubs |
ordinal |
1 = club principale, 2 = club secondario |
us_player_shots (~169.000 righe)
Ogni singolo tiro con coordinate e xG. La tabella più granulare del database.
| Colonna | Descrizione |
|---|---|
shot_id |
ID tiro su Understat |
player_id |
FK verso players |
match_id |
FK verso us_matches |
season_id |
Stagione |
minute |
Minuto del tiro |
x_coordinate, y_coordinate |
Posizione sul campo (0-1 normalizzato) |
xG |
Expected Goal per questo singolo tiro |
result |
Goal, SavedShot, MissedShots, BlockedShot, ShotOnPost |
shot_type |
Head, RightFoot, LeftFoot, OtherBodyPart |
situation |
OpenPlay, SetPiece, Corner, DirectFreekick, Penalty |
home_away |
h o a |
player_assisted |
Nome di chi ha fatto l’assist |
last_action |
Ultima azione prima del tiro (es. Cross, ThroughBall) |
us_player_match_details (~184.000 righe)
Prestazione di un giocatore in una singola partita.
| Colonna | Descrizione |
|---|---|
understat_player_id |
ID Understat |
player_id |
FK verso players |
match_id |
ID partita Understat |
season_id |
Stagione |
match_date |
Data |
position |
Posizione giocata in quella partita |
time_played |
Minuti giocati |
goals, assists, shots, key_passes |
Statistiche base |
xG, xA, npg, npxG |
Metriche avanzate |
xGChain, xGBuildup |
Coinvolgimento offensivo |
Tabelle di breakdown
Queste 4 tabelle hanno la stessa struttura (games, goals, shots, xG, assists, xA, key_passes, npg, npxG, xGChain, xGBuildup, time, ecc.) ma scompongono le statistiche per dimensione diversa:
| Tabella | Dimensione | Valori tipici |
|---|---|---|
us_player_stats_by_position |
Posizione giocata | FW, MF, DF, GK, Sub |
us_player_stats_by_situation |
Situazione di gioco | OpenPlay, SetPiece, Corner, DirectFreekick, Penalty |
us_player_stats_by_shot_type |
Tipo di tiro | Head, RightFoot, LeftFoot, OtherBodyPart |
us_player_stats_by_shot_zone |
Zona del campo | zone del tiro (es. area di rigore, fuori area) |
Tutte hanno chiave: (understat_player_id, season_id, <dimensione>).
us_player_info (~2.100 righe)
| Colonna | Descrizione |
|---|---|
understat_id |
PK - ID Understat |
player_id |
FK verso players |
player_name |
Nome |
favorite_position |
Posizione preferita |
us_player_min_max_stats (~67.600 righe)
Valori minimi e massimi storici per posizione e statistica.
| Colonna | Descrizione |
|---|---|
understat_player_id |
ID Understat |
position |
Posizione |
stat_name |
Nome della statistica (es. xG, xA, goals) |
min_value / max_value |
Estremi storici |
us_matches (~17.000 righe)
Partite con xG a livello di squadra.
| Colonna | Descrizione |
|---|---|
id |
ID partita Understat |
home_team_id / away_team_id |
ID squadra Understat |
home_club_id / away_club_id |
FK verso clubs |
home_xG / away_xG |
Expected Goals per squadra |
forecast_w / forecast_d / forecast_l |
Probabilità pre-partita |
us_teams (220 righe)
Associazione squadra-stagione su Understat. PK composta: (id, season_id).
us_team_history (~32.500 righe)
Storico partita-per-partita di ogni squadra. Fondamentale per analisi di pressing e trend stagionali.
| Colonna | Descrizione |
|---|---|
understat_team_id |
ID squadra Understat |
club_id |
FK verso clubs |
season_id |
Stagione |
h_a |
h = casa, a = trasferta |
xG / xGA |
xG fatti / subiti |
npxG / npxGA |
Non-penalty xG fatti / subiti |
ppda_att / ppda_def |
PPDA (Passes Per Defensive Action) — misura di pressing. ppda_att / ppda_def = indice di pressing. Più basso = pressing più aggressivo |
ppda_allowed_att / ppda_allowed_def |
PPDA subito dall’avversario |
deep |
Passaggi completati entro 20m dalla porta avversaria |
deep_allowed |
Deep completions subite |
scored / missed |
Gol fatti / subiti |
xpts |
Expected Points |
result |
w, d, l |
wins, draws, loses, pts |
Cumulativi stagionali |
npxGD |
Differenza xG non-penalty |