6 tutorials

Soccer

Free event data from StatsBomb plus xG from Understat let you analyse matches like a pro - no paid feed required.

Event data for a real match, summarized into a shots-and-events breakdown.

Soccer Beginner

Pull Your First Match Data with StatsBomb Open Data

Use statsbombpy to load free, event-level data for a real match, understand the events table, and summarize it - with the attribution StatsBomb's license requires.

~7 min

A league table re-ranked by expected goals instead of actual results.

Soccer Intermediate

Build an xG League Table from Understat Data

Pull a season of Understat shot-level xG via its JSON endpoint, aggregate it to a team table, and compare an xG-based table against the real one.

~8 min

A team's completed passes drawn as arrows on a proper pitch with mplsoccer.

Soccer Intermediate

Draw a Pass Map with mplsoccer

Filter a match's passes from StatsBomb event data and draw them as arrows on a correctly-proportioned pitch using mplsoccer, with StatsBomb attribution.

~7 min

Both teams' shots on a pitch, sized by xG and marked for goals.

Soccer Intermediate

Build a Match Shot Map with Expected Goals

Plot every shot from a real match on a pitch with mplsoccer, sizing each by its expected-goals value and highlighting goals - the single most useful soccer viz there is.

~8 min

A heatmap of where one player was involved across a match.

Soccer Intermediate

Draw a Player Heatmap from Event Data

Collect every action a player took from StatsBomb event data and turn the locations into a smooth territory heatmap on the pitch, showing where they did their work.

~7 min

A team's passing network: average positions and who links with whom.

Soccer Advanced

Build a Team Pass Network

Combine players' average positions with their pass combinations to draw a pass network - the chart that reveals a team's shape and its most important connections.

~9 min