soccermatics (version 0.9.5)

soccerxGTimeline: Draw a timeline showing cumulative expected goals (xG) over the course of a match using StatsBomb data.

Description

Draw a timeline showing cumulative expected goals (xG, excluding penalties and own goals) by two teams over the course of a match, as well as plotting the scoreline and goalscorer at goal events. Currently only works with StatsBomb data but compatability with other (non-StatsBomb) shot data will be added soon.

Usage

soccerxGTimeline(
  df,
  homeCol = "red",
  awayCol = "blue",
  adj = TRUE,
  labels = TRUE,
  y_buffer = 0.3
)

Arguments

df

a dataframe containing StatsBomb data from one full match

homeCol, awayCol

colours of the home and away team, respectively

adj

adjust xG using conditional probability to account for multiple shots per possession

labels

include scoreline and goalscorer labels for goals

y_buffer

vertical space to add at the top of the y-axis (a quick and dirty way to ensure text annotations are not cropped).

Value

a ggplot object

Examples

# NOT RUN {
library(dplyr)
data(statsbomb)

# xG timeline of France vs. Argentina
# w/ goalscorer labels, adjusted xG data
statsbomb %>%
  soccerxGTimeline(homeCol = "blue", awayCol = "lightblue", y_buffer = 0.4)

# no goalscorer labels, raw xG data
statsbomb %>%
  soccerxGTimeline(homeCol = "blue", awayCol = "lightblue", adj = FALSE)

# }