Add Athlete ID's to data frame — add_athlete_id

This function attempts to add ESPN athlete ID's to a data frame using the roster data in the cfbfastR-data repo. The function is experimental and not guaranteed to be accurate.

add_athlete_id_col(df, name_col, team_col = NULL, headshot_urls = FALSE)

Arguments

df: a data frame.
name_col: the column in df with the player names to join with the roster data.
team_col: Optional column with team names to join with the roster data to reduce the chance of matching with two players from different teams with the same name. If NULL and df has a column named "team" or "school," the function will use those as team_col. The function also checks df for a column named "season" to match names to rosters going back to 2009.
headshot_urls: logical to return headshot URLs. If TRUE, the output has an additional column called "headshot_url" with links for player headshots.

Value

the original df with extra columns:

athlete_id: athlete ESPN ID.
headshot_url: url of athlete's headshot.

Examples

# \donttest{
x <- data.frame(
  player_name = c("Britain Covey","JT Daniels")
)

cfbplotR::add_athlete_id_col(x, player_name)
#> ℹ No season column, using 2021 rosters
#>     player_name season athlete_id
#> 1 Britain Covey   2021    3926231
#> 2    JT Daniels   2021    4374303


x$season <- c(2021,2021)
cfbplotR::add_athlete_id_col(x, player_name)
#>     player_name season athlete_id
#> 1 Britain Covey   2021    3926231
#> 2    JT Daniels   2021    4374303


x$team = c("Utah","Georgia")
cfbplotR::add_athlete_id_col(x, player_name, team, headshot_urls = TRUE)
#>     player_name season    team athlete_id
#> 1 Britain Covey   2021    Utah    3926231
#> 2    JT Daniels   2021 Georgia    4374303
#>                                                                  headshot_url
#> 1 https://a.espncdn.com/i/headshots/college-football/players/full/3926231.png
#> 2 https://a.espncdn.com/i/headshots/college-football/players/full/4374303.png
# }