README.md

In ggfootball: Plotting Football Matches Expected Goals (xG) Stats with 'Understat' Data

ggfootball

It’s Football not Soccer.

Overview

The ggfootball package provides R functions that scrape shots data from understat and visualizes it using interactive plots:

• A detailed shot map displaying the location, type, and expected goals (xG) value of shots taken by both teams.
• An xG timeline chart showing the cumulative expected goals for each team over time, annotated with the details of scored goals.

Installation

You can install ggfootball from CRAN with:

install.packages("ggfootball")

Example

library(ggfootball)

# xG chart
xg_chart(match_id = 26631, 
         home_team_color = "red", 
         away_team_color = "grey", 
         competition = "Premier League",
         bg_color = "#FFF1E5",
         plot_bg_color = "#FFF1E5")

# Shot/xG map
xg_map(match_id = 26631, title = "xG Map")

Acknowledgements

• Ewen Henderson for his amazing {understatr} package which I used to extract data.

• Guangchuang YU for his {hexSticker} package which I used to create the logo for this package.

ggfootball documentation built on April 12, 2025, 2:09 a.m.