Add Athlete ID's to data frame

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.

Usage

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")
)

add_athlete_id_col(x, player_name)
#> ℹ No season column, using "most_recent_cfb_season()" rosters
#>     player_name season athlete_id
#> 1 Britain Covey     NA       <NA>
#> 2    JT Daniels   2022    4374303


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


x$team = c("Utah","Georgia")
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
# }