cfbfastR 2.0.0

Breaking Changes to Loading Functions

• All load_cfb_*() functions now use sportsdataverse-data releases or the CollegeFootballData.com API as their underlying data source to remain in compliance with CFBD API terms and conditions (See Note below).
• Updated load_cfb_pbp() dataset to include various team- and game-level ID's and flags that were not being included, like home_team_id, away_team_id, season_type, venue_id, some drive_* columns, a half-dozen player stat columns, etc. Essentially, all the leg-work users have undoubtedly had to do while using these datasets is mostly just included now. The downside: this means end users need to check their pipelines which build off these datasets to ensure behavior is as expected and all your joins are doing what is intended.

Now upgraded to the CFBD v2 API

Special thanks are in order for our newest contributor, Brad Hill (@bradisbrad) for providing most of the v2 upgrade via his first PR to cfbfastR!! 🙌🏽 👑 🥇 Your contributions are most appreciated by the community.

Note: The free-tier API key for the CFBD v2 API has a strict 1k calls/month limit, so plan your workflows accordingly! If you receive errors mentioning r Request failed [429], you have most likely run out of API calls for the month in your membership tier.

• Added all new cfbd_*() functions accommodated by the new College Football Data API v2. This includes the following functions:

  • Added cfbd_metrics_fg_ep() function to access the new field goal expected points added metric from the API.
  • Added cfbd_metrics_wepa_team_season() function to access the new opponent adjusted team season predicted points added metric from the API.
  • Added cfbd_metrics_wepa_players_passing() function to access the new opponent adjusted players passing predicted points added metric from the API.
  • Added cfbd_metrics_wepa_players_rushing() function to access the new opponent adjusted players rushing predicted points added metric from the API.
  • Added cfbd_metrics_wepa_players_kicking() function to access the new Points Added Above Replacement (PAAR) ratings for kickers from the API.
  • Added cfbd_ratings_fpi() function to access the new FPI ratings from the API.
  • Added cfbd_live_scoreboard() function to access live scoreboard data from the API.
  • Added cfbd_live_plays() function to access live play-by-play data from the API.
  • Added cfbd_api_key_info() function to get information about your API key, including your Patreon level and usage limits.

• Minor changes to the existing cfbd_*() functions under the hood to accommodate the new API v2 structure. Please see below for a list of all updated functions:

  • Updated cfbd_betting_lines() function
  • Updated cfbd_coaches() function
  • Updated cfbd_conferences() function
  • Updated cfbd_drives() function
  • Updated cfbd_calendar() function
  • Updated cfbd_game_box_advanced() function
  • Updated cfbd_game_info() function
  • Updated cfbd_game_media() function
  • Updated cfbd_game_player_stats() function
  • Updated cfbd_game_records() function
  • Updated cfbd_game_team_stats() function
  • Updated cfbd_metrics_ppa_games() function
  • Updated cfbd_metrics_ppa_players_games() function
  • Updated cfbd_metrics_ppa_players_season() function
  • Updated cfbd_metrics_ppa_predicted() function
  • Updated cfbd_metrics_ppa_teams() function
  • Updated cfbd_metrics_wp() function
  • Updated cfbd_metrics_wp_pregame() function
  • Updated cfbd_pbp_data() function
  • Updated cfbd_play_stats_player() function
  • Updated cfbd_play_stats_types() function
  • Updated cfbd_play_types() function
  • Updated cfbd_plays() function
  • Updated cfbd_player_info() function
  • Updated cfbd_player_returning() function
  • Updated cfbd_player_usage() function
  • Updated cfbd_rankings() function
  • Updated cfbd_ratings_sp() function
  • Updated cfbd_ratings_sp_conference() function
  • Updated cfbd_ratings_srs() function
  • Updated cfbd_recruiting_player() function
  • Updated cfbd_recruiting_position() function
  • Updated cfbd_recruiting_team() function
  • Updated cfbd_stats_categories() function
  • Updated cfbd_stats_game_advanced() function
  • Updated cfbd_stats_season_advanced() function
  • Updated cfbd_stats_season_player() function
  • Updated cfbd_stats_season_team() function
  • Updated cfbd_team_info() function
  • Updated cfbd_team_matchup() function
  • Updated cfbd_team_matchup_records() function
  • Updated cfbd_team_roster() function
  • Updated cfbd_team_talent() function
  • Updated cfbd_venues() function

• Fixed the following functions and/or documentation:

  • Documentation cfbd_team_info() addressing #97
  • Ensuring cfbd_stats_game_advanced() returns an empty data frame when there are no results
  • Documentation cfbd_game_team_stats() updated to reflect all parameter requirement scenarios.
  • Fixed athlete_id parameter cfbd_player_usage() so that it works as users would expect. There was an API query-parameter mismatch
  • Fixed athlete_id parameter for cfbd_play_stats_player() function and added more thorough documentation.
  • Fixed returned position to correct value (instead of NA) from cfbd_stats_season_player()
  • Added more thorough season_type parameter documentation across many functions
  • Changed behavior of cfbd_pbp_data() to substitute 3 timeouts per half when the data is missing from the API.