cfbfastR: Access College Football Play by Play Data

Description

A utility to quickly obtain clean and tidy college football data. Serves as a wrapper around the https://collegefootballdata.com/ API and provides functions to access live play by play and box score data from ESPN https://www.espn.com when available. It provides users the capability to access a plethora of endpoints, and supplement that data with additional information (Expected Points Added/Win Probability added).

A utility to quickly obtain clean and tidy college football data. Serves as a wrapper around the https://collegefootballdata.com/ API and provides functions to access live play by play and box score data from ESPN https://www.espn.com when available. It provides users the capability to access a plethora of endpoints, and supplement that data with additional information (Expected Points Added/Win Probability added).

Author(s)

Maintainer: Saiem Gilani saiem.gilani@gmail.com

Authors:

• Akshay Easwaran akeaswaran@me.com

• Jared Lee 13jaredlee@gmail.com

• Eric Hess eric.hess.13@gmail.com

Other contributors:

• Michael Egle mjegle@iastate.edu [contributor]

• Nate Manzo natem67@gmail.com [contributor]

• Jason DeLoach jdeloach5@gmail.com [contributor]

• Tej Seth tejseth@umich.edu [contributor]

• Conor McQuiston mcqconor@umich.edu [contributor]

• Tan Ho tan@tanho.ca [contributor]

• Keegan Abdoo kabdoo@draft.ly [contributor]

• Matt Spencer maatspencer@gmail.com [contributor]

• Sebastian Carl mrcaseb@gmail.com [contributor]

• John Edwards edwards1860@gmail.com [contributor]

• Brad Hill bradhill119@gmail.com [contributor]

See Also

Useful links:

• https://cfbfastR.sportsdataverse.org/

• https://github.com/sportsdataverse/cfbfastR

• Report bugs at https://github.com/sportsdataverse/cfbfastR/issues

Useful links:

• https://cfbfastR.sportsdataverse.org/

• https://github.com/sportsdataverse/cfbfastR

• Report bugs at https://github.com/sportsdataverse/cfbfastR/issues

CFBD Betting Lines Endpoint Overview

Description

Get betting lines information for games

Usage

cfbd_betting_lines(
  game_id = NULL,
  year = NULL,
  week = NULL,
  season_type = "regular",
  team = NULL,
  home_team = NULL,
  away_team = NULL,
  conference = NULL,
  line_provider = NULL
)

Arguments

Value

Betting information for games with the following columns:

game_id:integer.

Unique game identifier - game_id.

season:integer.

Season parameter.

season_type:character.)

Season Type (regular, postseason, both

week:integer.

Week, values from 1-15, 1-14 for seasons pre-playoff (i.e. 2013 or earlier).

start_date:character.

Start Date

home_team:character.

Home D-I Team.

home_conference:character.

Home D-I Conference.

home_classification:character.

Home Conference classification (fbs,fcs,ii,iii)

home_score:integer.

Home Score.

away_team:character.

Away D-I Team.

away_conference:character.

Away D-I Conference.

away_classification:character.

Away Conference classification (fbs,fcs,ii,iii)

away_score:integer.

Away Score.

provider:character.

Line provider.

spread:character.

Spread for the game.

formatted_spread:character.

Formatted spread for the game.

spread_open:character.

Opening spread for the game.

over_under:character.

Over/Under for the game.

over_under_open:character.

Opening over/under for the game.

home_moneyline:character.

Home team moneyline.

away_moneyline:character.

Away team moneyline.

Examples

   try(cfbd_betting_lines(year = 2018, week = 12, team = "Florida State"))

Get calendar of weeks by season.

Description

Get calendar of weeks by season.

Usage

cfbd_calendar(year)

Arguments

Value

cfbd_calendar() - A data frame with 5 variables:

season: character.

Calendar season.

week: integer.

Calendar game week.

season_type: character

Season type of calendar week.

first_game_start: character.

First game start time of the calendar week.

last_game_start: character.

Last game start time of the calendar week.

See Also

Other CFBD Games: cfbd_game_box_advanced(), cfbd_game_info(), cfbd_game_media(), cfbd_game_player_stats(), cfbd_game_records(), cfbd_game_team_stats(), cfbd_game_weather(), cfbd_live_scoreboard()

Examples

  try(cfbd_calendar(2019))

CFBD Coaches Endpoint Overview

Description

Coach information search A coach search function which provides coaching records and school history for a given coach

Usage

cfbd_coaches(
  first = NULL,
  last = NULL,
  team = NULL,
  year = NULL,
  min_year = NULL,
  max_year = NULL
)

Arguments

Value

first_name:character.

First name of coach.

last_name:character.

Last name of coach.

hire_date:character.

Hire date of coach.

school:character.

School of coach.

year:integer.

Season of record.

games:integer.

Games as coach.

wins:integer.

Wins for the season.

losses:integer.

Losses for the season.

ties:integer.

Ties for the season.

preseason_rank:integer.

Preseason rank for the school of coach.

postseason_rank:integer.

Postseason rank for the school of coach.

srs:character.

Simple Rating System adjustment for team.

sp_overall:character.

Bill Connelly's SP+ overall for team.

sp_offense:character.

Bill Connelly's SP+ offense for team.

sp_defense:character.

Bill Connelly's SP+ defense for team.

Examples

  try(cfbd_coaches(first = "Nick", last = "Saban", team = "alabama"))

CFBD Conferences Endpoint Overview

Description

Get college football conference information Pulls all college football conferences and returns as data frame

Usage

cfbd_conferences()

Value

cfbd_conferences() - A data frame with 94 rows and 5 variables:

conference_id:

Referencing conference id.

name:

Conference name.

long_name:

Long name for Conference.

abbreviation:

Conference abbreviation.

classification:

Conference classification (fbs,fcs,ii,iii)

Examples

  try(cfbd_conferences())

CFBD NFL Draft Endpoint Overview

Description

cfbd_draft_teams():

Get list of NFL teams.

cfbd_draft_positions():

Get list of NFL positions for mapping to college positions.

cfbd_draft_picks():

Get list of NFL Draft picks.

Details

Get list of NFL teams

cfbd_draft_teams()

Get list of NFL positions for mapping to collegiate

cfbd_draft_positions()

Get list of NFL Draft picks

cfbd_draft_picks(year = 2020, college = "Texas")

cfbd_draft_picks(nfl_team = "Cincinatti")

Get list of NFL draft picks

Description

Get list of NFL draft picks

Usage

cfbd_draft_picks(
  year = NULL,
  nfl_team = NULL,
  college = NULL,
  conference = NULL,
  position = NULL
)

Arguments

Value

cfbd_draft_picks() - A data frame with 23 variables:

college_athlete_id: integer.

College athlete referencing id.

nfl_athlete_id: integer

NFL athlete referencing id.

college_id: integer

College team referencing id.

college_team: character

College team name.

college_conference: character

Conference of college team.

nfl_team_id: integer.

NFL team ID.

nfl_team: character

NFL team name of drafted player.

year: integer.

NFL draft class year.

overall: integer.

Overall draft pick number.

round: integer.

Round of NFL draft the draftee was picked in.

pick: integer.

Pick number of the NFL draftee within the round they were picked in.

name: character.

NFL draftee name.

position: character.

NFL draftee position.

height: double.

NFL draftee height.

weight: integer.

NFL draftee weight.

pre_draft_ranking: integer

Pre-draft ranking (ESPN).

pre_draft_position_ranking: integer.

Pre-draft position ranking (ESPN).

pre_draft_grade: double.

Pre-draft scouts grade (ESPN).

hometown_info_city: character.

Hometown of the NFL draftee.

hometown_info_state_province: character.

Hometown state of the NFL draftee.

hometown_info_country: character.

Hometown country of the NFL draftee.

hometown_info_latitude: character.

Hometown latitude of the NFL draftee.

hometown_info_longitude: character.

Hometown longitude of the NFL draftee.

hometown_info_county_fips: character.

Hometown FIPS code of the NFL draftee.

See Also

Other CFBD Draft: cfbd_draft_positions(), cfbd_draft_teams()

Examples

  try(cfbd_draft_picks(year = 2020))

  try(cfbd_draft_picks(year = 2016, position = "PK"))

Get list of NFL positions

Description

Get list of NFL positions

Usage

cfbd_draft_positions()

Value

cfbd_draft_positions() - A data frame with 2 variables:

position_name: character.

NFL Position group name.

position_abbreviation: integer

NFL position group abbreviation.

See Also

Other CFBD Draft: cfbd_draft_picks(), cfbd_draft_teams()

Examples

  try(cfbd_draft_positions())

Get list of NFL teams

Description

Get list of NFL teams

Usage

cfbd_draft_teams()

Value

cfbd_draft_teams() - A data frame with 4 variables:

nfl_location: character.

NFL team location (city).

nfl_nickname: integer

NFL team nickname (mascot).

nfl_display_name: integer

NFL team display name (usually more neat/complete).

nfl_logo: character

URL for NFL team logo.

See Also

Other CFBD Draft: cfbd_draft_picks(), cfbd_draft_positions()

Examples

  try(cfbd_draft_teams())

CFBD Drives Endpoint

Description

Get college football game drives

Usage

cfbd_drives(
  year,
  season_type = "regular",
  week = NULL,
  team = NULL,
  offense_team = NULL,
  defense_team = NULL,
  conference = NULL,
  offense_conference = NULL,
  defense_conference = NULL,
  division = "fbs"
)

Arguments

Value

cfbd_drives() - A data frame with variables as follows:

offense:character.

Drive offense.

offense_conference:character.

Drive offense's conference.

defense:character.

Drive defense.

defense_conference:character.

Drive defense's conference.

game_id:integer.

Unique game identifier - game_id.

drive_id:character.

Unique drive identifier - drive_id.

drive_number:integer.

Drive number in game.

scoring:logical.

Drive ends in a score.

start_period:integer.

Period (or Quarter) in which the drive starts.

start_yardline:integer.

Yard line at the drive start.

start_yards_to_goal:integer.

Yards-to-Goal at the drive start.

end_period:integer.

Period (or Quarter) in which the drive ends.

end_yardline:integer.

Yard line at drive end.

end_yards_to_goal:integer.

Yards-to-Goal at drive end.

plays:integer.

Number of drive plays.

yards:integer.

Total drive yards.

drive_result:character.

Result of the drive description.

is_home_offense:logical.

Flag for if the offense on the field is the home offense

start_offense_score:numeric.

Offense score at the start of the drive.

start_defense_score:numeric.

Defense score at the start of the drive.

end_offense_score:numeric.

Offense score at the end of the drive.

end_defense_score:numeric.

Defense score at the end of the drive.

time_minutes_start:integer.

Minutes at drive start.

time_seconds_start:integer.

Seconds at drive start.

time_minutes_end:integer.

Minutes at drive end.

time_seconds_end:integer.

Seconds at drive end.

time_minutes_elapsed:double.

Minutes elapsed during drive.

time_seconds_elapsed:integer.

Seconds elapsed during drive.

Examples

  try(cfbd_drives(year=2018, week = 1, team = "TCU"))

  try(cfbd_drives(2018, team = "Texas A&M", defense_conference = "SEC"))

Get game advanced box score information.

Description

Get game advanced box score information.

Usage

cfbd_game_box_advanced(game_id, long = FALSE)

Arguments

Value

cfbd_game_box_advanced() - A data frame with 2 rows and 69 variables:

team: character.

Team name.

plays: double.

Number of plays.

ppa_overall_total: double.

Predicted points added (PPA) overall total.

ppa_overall_quarter1: double.

Predicted points added (PPA) overall Q1.

ppa_overall_quarter2: double.

Predicted points added (PPA) overall Q2.

ppa_overall_quarter3: double.

Predicted points added (PPA) overall Q3.

ppa_overall_quarter4: double.

Predicted points added (PPA) overall Q4.

ppa_passing_total: double.

Passing predicted points added (PPA) total.

ppa_passing_quarter1: double.

Passing predicted points added (PPA) Q1.

ppa_passing_quarter2: double.

Passing predicted points added (PPA) Q2.

ppa_passing_quarter3: double.

Passing predicted points added (PPA) Q3.

ppa_passing_quarter4: double.

Passing predicted points added (PPA) Q4.

ppa_rushing_total: double.

Rushing predicted points added (PPA) total.

ppa_rushing_quarter1: double.

Rushing predicted points added (PPA) Q1.

ppa_rushing_quarter2: double.

Rushing predicted points added (PPA) Q2.

ppa_rushing_quarter3: double.

Rushing predicted points added (PPA) Q3.

ppa_rushing_quarter4: double.

Rushing predicted points added (PPA) Q4.

cumulative_ppa_plays: double.

Cumulative predicted points added (PPA) added total.

cumulative_ppa_overall_total: double.

Cumulative predicted points added (PPA) total.

cumulative_ppa_overall_quarter1: double.

Cumulative predicted points added (PPA) Q1.

cumulative_ppa_overall_quarter2: double.

Cumulative predicted points added (PPA) Q2.

cumulative_ppa_overall_quarter3: double.

Cumulative predicted points added (PPA) Q3.

cumulative_ppa_overall_quarter4: double.

Cumulative predicted points added (PPA) Q4.

cumulative_ppa_passing_total: double.

Cumulative passing predicted points added (PPA) total.

cumulative_ppa_passing_quarter1: double.

Cumulative passing predicted points added (PPA) Q1.

cumulative_ppa_passing_quarter2: double.

Cumulative passing predicted points added (PPA) Q2.

cumulative_ppa_passing_quarter3: double.

Cumulative passing predicted points added (PPA) Q3.

cumulative_ppa_passing_quarter4: double.

Cumulative passing predicted points added (PPA) Q4.

cumulative_ppa_rushing_total: double.

Cumulative rushing predicted points added (PPA) total.

cumulative_ppa_rushing_quarter1: double.

Cumulative rushing predicted points added (PPA) Q1.

cumulative_ppa_rushing_quarter2: double.

Cumulative rushing predicted points added (PPA) Q2.

cumulative_ppa_rushing_quarter3: double.

Cumulative rushing predicted points added (PPA) Q3.

cumulative_ppa_rushing_quarter4: double.

Cumulative rushing predicted points added (PPA) Q4.

success_rates_overall_total: double.

Success rates overall total.

success_rates_overall_quarter1: double.

Success rates overall Q1.

success_rates_overall_quarter2: double.

Success rates overall Q2.

success_rates_overall_quarter3: double.

Success rates overall Q3.

success_rates_overall_quarter4: double.

Success rates overall Q4.

success_rates_standard_downs_total: double.

Success rates standard downs total.

success_rates_standard_downs_quarter1: double.

Success rates standard downs Q1.

success_rates_standard_downs_quarter2: double.

Success rates standard downs Q2.

success_rates_standard_downs_quarter3: double.

Success rates standard downs Q3.

success_rates_standard_downs_quarter4: double.

Success rates standard downs Q4.

success_rates_passing_downs_total: double.

Success rates passing downs total.

success_rates_passing_downs_quarter1: double.

Success rates passing downs Q1.

success_rates_passing_downs_quarter2: double.

Success rates passing downs Q2.

success_rates_passing_downs_quarter3: double.

Success rates passing downs Q3.

success_rates_passing_downs_quarter4: double.

Success rates passing downs Q4.

explosiveness_overall_total: double.

Explosiveness rates overall total.

explosiveness_overall_quarter1: double.

Explosiveness rates overall Q1.

explosiveness_overall_quarter2: double.

Explosiveness rates overall Q2.

explosiveness_overall_quarter3: double.

Explosiveness rates overall Q3.

explosiveness_overall_quarter4: double.

Explosiveness rates overall Q4.

rushing_power_success: double.

Rushing power success rate.

rushing_stuff_rate: double.

Rushing stuff rate.

rushing_line_yds: double.

Rushing offensive line yards.

rushing_line_yds_avg: double.

Rushing line yards average.

rushing_second_lvl_yds: double.

Rushing second-level yards.

rushing_second_lvl_yds_avg: double.

Average second level yards per rush.

rushing_open_field_yds: double.

Rushing open field yards.

rushing_open_field_yds_avg: double.

Average rushing open field yards average.

havoc_total: double.

Total havoc rate.

havoc_front_seven: double.

Front-7 players havoc rate.

havoc_db: double.

Defensive back players havoc rate.

scoring_opps_opportunities: double.

Number of scoring opportunities.

scoring_opps_points: double.

Points on scoring opportunity drives.

scoring_opps_pts_per_opp: double.

Points per scoring opportunity drives.

field_pos_avg_start: double.

Average starting field position.

field_pos_avg_starting_predicted_pts: double.

Average starting predicted points (PP) for the average starting field position.

See Also

Other CFBD Games: cfbd_calendar(), cfbd_game_info(), cfbd_game_media(), cfbd_game_player_stats(), cfbd_game_records(), cfbd_game_team_stats(), cfbd_game_weather(), cfbd_live_scoreboard()

Examples

  try(cfbd_game_box_advanced(game_id = 401114233))

Get results information from games.

Description

Get results information from games.

Usage

cfbd_game_info(
  year,
  week = NULL,
  season_type = "regular",
  team = NULL,
  home_team = NULL,
  away_team = NULL,
  conference = NULL,
  division = "fbs",
  game_id = NULL,
  quarter_scores = FALSE
)

Arguments

Value

cfbd_game_info() - A data frame with 22 variables:

game_id: integer.

Referencing game id.

season: integer.

Season of the game.

week: integer.

Game week.

season_type: character.

Season type of the game.

start_date: character.

Game date.

start_time_tbd: logical.

TRUE/FALSE flag for if the game's start time is to be determined.

neutral_site: logical.

TRUE/FALSE flag for the game taking place at a neutral site.

conference_game: logical.

TRUE/FALSE flag for this game qualifying as a conference game.

attendance: integer.

Reported attendance at the game.

venue_id: integer.

Referencing venue id.

venue: character.

Venue name.

home_id: integer.

Home team referencing id.

home_team: character.

Home team name.

home_conference: character.

Home team conference.

home_division: character.

Home team division.

home_points: integer.

Home team points.

home_post_win_prob: character.

Home team post-game win probability.

home_pregame_elo: character.

Home team pre-game ELO rating.

home_postgame_elo: character.

Home team post-game ELO rating.

away_id: integer.

Away team referencing id.

away_team: character.

Away team name.

away_conference: character.

Away team conference.

away_division: character.

Away team division.

away_points: integer.

Away team points.

away_post_win_prob: character.

Away team post-game win probability.

away_pregame_elo: character.

Away team pre-game ELO rating.

away_postgame_elo: character.

Away team post-game ELO rating.

excitement_index: character.

Game excitement index.

highlights: character.

Game highlight urls.

notes: character.

Game notes.

See Also

Other CFBD Games: cfbd_calendar(), cfbd_game_box_advanced(), cfbd_game_media(), cfbd_game_player_stats(), cfbd_game_records(), cfbd_game_team_stats(), cfbd_game_weather(), cfbd_live_scoreboard()

Examples

  try(cfbd_game_info(2018, week = 7, conference = "Ind"))

Get game media information (TV, radio, etc).

Description

Get game media information (TV, radio, etc).

Usage

cfbd_game_media(
  year,
  week = NULL,
  season_type = "both",
  team = NULL,
  conference = NULL,
  media_type = NULL,
  division = "fbs"
)

Arguments

Value

cfbd_game_media() - A data frame with 13 variables:

game_id: integer.

Referencing game id.

season: integer.

Season of the game.

week: integer.

Game week.

season_type: character.

Season type of the game.

start_time: character.

Game start time.

is_start_time_tbd: logical.

TRUE/FALSE flag for if the start time is still to be determined.

home_team: character.

Home team of the game.

home_conference: character.

Conference of the home team.

away_team: character.

Away team of the game.

away_conference: character.

Conference of the away team.

tv: list.

TV broadcast networks.

radio: logical.

Radio broadcast networks.

web: list.

Web viewing platforms carrying the game.

See Also

Other CFBD Games: cfbd_calendar(), cfbd_game_box_advanced(), cfbd_game_info(), cfbd_game_player_stats(), cfbd_game_records(), cfbd_game_team_stats(), cfbd_game_weather(), cfbd_live_scoreboard()

Examples

  try(cfbd_game_media(2019, week = 4, conference = "ACC"))

Get player statistics by game

Description

Get player statistics by game

Usage

cfbd_game_player_stats(
  year,
  week = NULL,
  season_type = "regular",
  team = NULL,
  conference = NULL,
  category = NULL,
  game_id = NULL
)

Arguments

Value

cfbd_game_player_stats() - A data frame with 32 variables:

See Also

Other CFBD Games: cfbd_calendar(), cfbd_game_box_advanced(), cfbd_game_info(), cfbd_game_media(), cfbd_game_records(), cfbd_game_team_stats(), cfbd_game_weather(), cfbd_live_scoreboard()

Examples

  try(cfbd_game_player_stats(year = 2020, week = 15, team = "Alabama"))

  try(cfbd_game_player_stats(2013, week = 1, team = "Florida State", category = "passing"))

Get team records by year

Description

Get team records by year

Usage

cfbd_game_records(year, team = NULL, conference = NULL)

Arguments

Value

cfbd_game_records() - A data frame with 35 variables:

year: integer.

Season of the games.

team_id: integer.

Referencing team id.

team: character.

Team name.

classification: character

Conference classification (fbs,fcs,ii,iii)

conference: character.

Conference of the team.

division: character.

Division in the conference of the team.

expected_wins: numeric

Expected number of wins based on post-game win probability.

total_games: integer.

Total number of games played.

total_wins: integer.

Total wins.

total_losses: integer.

Total losses.

total_ties: integer.

Total ties.

conference_games: integer.

Number of conference games.

conference_wins: integer.

Total conference wins.

conference_losses: integer.

Total conference losses.

conference_ties: integer.

Total conference ties.

home_games: integer.

Total home games.

home_wins: integer.

Total home wins.

home_losses: integer.

Total home losses.

home_ties: integer.

Total home ties.

away_games: integer.

Total away games.

away_wins: integer.

Total away wins.

away_losses: integer.

Total away losses.

away_ties: integer.

Total away ties.

neutral_games: integer.

Total neutral site games.

neutral_wins: integer.

Total neutral site wins.

neutral_losses: integer.

Total neutral site losses.

neutral_ties: integer.

Total neutral site ties.

regular_season_games: integer.

Total regular season games.

regular_season_wins: integer.

Total regular season wins.

regular_season_losses: integer.

Total regular season losses.

regular_season_ties: integer.

Total regular season ties.

postseason_games: integer.

Total postseason games.

postseason_wins: integer.

Total postseason wins.

postseason_losses: integer.

Total postseason losses.

postseason_ties: integer.

Total postseason ties.

See Also

Other CFBD Games: cfbd_calendar(), cfbd_game_box_advanced(), cfbd_game_info(), cfbd_game_media(), cfbd_game_player_stats(), cfbd_game_team_stats(), cfbd_game_weather(), cfbd_live_scoreboard()

Examples

  try(cfbd_game_records(2018, team = "Notre Dame"))

  try(cfbd_game_records(2013, team = "Florida State"))

Get team statistics by game

Description

Get team statistics by game

Usage

cfbd_game_team_stats(
  year,
  week = NULL,
  season_type = "regular",
  team = NULL,
  conference = NULL,
  game_id = NULL,
  division = "fbs",
  rows_per_team = 1
)

Arguments

Value

cfbd_game_team_stats() - A data frame with 78 variables:

game_id: integer.

Referencing game id.

team: character.

Team name.

conference: character.

Conference of the team.

home_away: character.

Home/Away Flag.

opponent: character.

Opponent team name.

opponent_conference: character.

Conference of the opponent team.

points: integer.

Team points.

total_yards: character.

Team total yards.

net_passing_yards: character.

Team net passing yards.

completion_attempts:character.

Team completion attempts.

passing_tds: character.

Team passing touchdowns.

yards_per_pass: character.

Team game yards per pass.

passes_intercepted: character.

Team passes intercepted.

interception_yards: character.

Interception yards.

interception_tds: character.

Interceptions returned for a touchdown.

rushing_attempts: character.

Team rushing attempts. see also: ESTABLISH IT.

rushing_yards: character.

Team rushing yards.

rush_tds: character.

Team rushing touchdowns.

yards_per_rush_attempt: character.

Team yards per rush attempt.

first_downs: character.

First downs earned by the team.

third_down_eff: character.

Third down efficiency.

fourth_down_eff: character.

Fourth down efficiency.

punt_returns: character.

Team punt returns.

punt_return_yards: character.

Team punt return yards.

punt_return_tds: character.

Team punt return touchdowns.

kick_return_yards: character.

Team kick return yards.

kick_return_tds: character.

Team kick return touchdowns.

kick_returns: character.

Team kick returns.

kicking_points: character.

Team points from kicking the ball.

fumbles_recovered: character.

Team fumbles recovered.

fumbles_lost: character.

Team fumbles lost.

total_fumbles: character.

Team total fumbles.

tackles: character.

Team tackles.

tackles_for_loss: character.

Team tackles for a loss.

sacks: character.

Team sacks.

qb_hurries: character.

Team QB hurries.

interceptions: character.

Team interceptions.

passes_deflected: character.

Team passes deflected.

turnovers: character.

Team turnovers.

defensive_tds: character.

Team defensive touchdowns.

total_penalties_yards: character.

Team total penalty yards.

possession_time: character.

Team time of possession.

points_allowed: integer.

Points for the opponent.

total_yards_allowed: character.

Opponent total yards.

net_passing_yards_allowed: character.

Opponent net passing yards.

completion_attempts_allowed: character.

Oppponent completion attempts.

passing_tds_allowed: character.

Opponent passing TDs.

yards_per_pass_allowed: character.

Opponent yards per pass allowed.

passes_intercepted_allowed: character.

Opponent passes intercepted.

interception_yards_allowed: character.

Opponent interception yards.

interception_tds_allowed: character.

Opponent interception TDs.

rushing_attempts_allowed: character.

Opponent rushing attempts.

rushing_yards_allowed: character.

Opponent rushing yards.

rush_tds_allowed: character.

Opponent rushing touchdowns.

yards_per_rush_attempt_allowed: character.

Opponent rushing yards per attempt.

first_downs_allowed: character.

Opponent first downs.

third_down_eff_allowed: character.

Opponent third down efficiency.

fourth_down_eff_allowed: character.

Opponent fourth down efficiency.

punt_returns_allowed: character.

Opponent punt returns.

punt_return_yards_allowed: character.

Opponent punt return yards.

punt_return_tds_allowed: character.

Opponent punt return touchdowns.

kick_return_yards_allowed: character.

Opponent kick return yards.

kick_return_tds_allowed: character.

Opponent kick return touchdowns.

kick_returns_allowed: character.

Opponent kick returns.

kicking_points_allowed: character.

Opponent points from kicking.

fumbles_recovered_allowed: character.

Opponent fumbles recovered.

fumbles_lost_allowed: character.

Opponent fumbles lost.

total_fumbles_allowed:character.

Opponent total number of fumbles.

tackles_allowed:character.

Opponent tackles.

tackles_for_loss_allowed: character.

Opponent tackles for loss.

sacks_allowed: character.

Opponent sacks.

qb_hurries_allowed: character.

Opponent quarterback hurries.

interceptions_allowed: character.

Opponent interceptions.

passes_deflected_allowed: character.

Opponent passes deflected.

turnovers_allowed: character.

Opponent turnovers.

defensive_tds_allowed: character.

Opponent defensive touchdowns.

total_penalties_yards_allowed: character.

Opponent total penalty yards.

possession_time_allowed: character.

Opponent time of possession.

See Also

Other CFBD Games: cfbd_calendar(), cfbd_game_box_advanced(), cfbd_game_info(), cfbd_game_media(), cfbd_game_player_stats(), cfbd_game_records(), cfbd_game_weather(), cfbd_live_scoreboard()

Examples

  try(cfbd_game_team_stats(2022, team = "LSU"))

  try(cfbd_game_team_stats(2013, team = "Florida State"))

Get weather from games.

Description

Get weather from games.

Usage

cfbd_game_weather(
  year,
  week = NULL,
  season_type = "regular",
  team = NULL,
  conference = NULL
)

Arguments

Value

cfbd_game_weather() - A data frame with 23 variables:

game_id: integer.

Referencing game id.

season: integer.

Season of the game.

week: integer.

Game week.

season_type: character.

Season type of the game.

start_date: character.

Game date.

start_time_tbd: logical.

TRUE/FALSE flag for if the game's start time is to be determined.

game_indoors: logical.

TRUE/FALSE flag for if the game is indoors

home_team: character.

Home team name.

home_conference: character.

Home team conference.

away_team: character.

Away team name.

away_conference: character.

Away team conference.

venue_id: integer.

Referencing venue id.

venue: character.

Venue name.

temperature: integer.

Temperature.

dew_point: integer.

Dew Point.

humidity: integer.

Humidity.

precipitation: integer.

Precipitation.

snowfall: integer.

Snowfall.

wind_direction: integer.

Wind direction.

wind_speed: integer.

Wind Speed.

pressure: integer.

Pressure.

weather_condition_code: integer.

Weather condition code.

weather_condition: character.

Weather condition.

See Also

Other CFBD Games: cfbd_calendar(), cfbd_game_box_advanced(), cfbd_game_info(), cfbd_game_media(), cfbd_game_player_stats(), cfbd_game_records(), cfbd_game_team_stats(), cfbd_live_scoreboard()

CFBD Games Endpoint Overview

Description

Get results, statistics and information for games

cfbd_game_box_advanced():

Get game advanced box score information.

cfbd_game_player_stats():

Get results information from games.

cfbd_game_team_stats():

Get team statistics by game.

cfbd_game_info():

Get results information from games.

cfbd_live_scoreboard():

Get live scoreboard information.

cfbd_game_weather():

Get weather from games.

cfbd_game_records():

Get team records by year.

cfbd_calendar():

Get calendar of weeks by season.

cfbd_game_media():

Get game media information (TV, radio, etc).

Details

Get game advanced box score information.

cfbd_game_box_advanced(game_id = 401114233)

Get player statistics by game

cfbd_game_player_stats(2018, week = 15, conference = "Ind")

cfbd_game_player_stats(2013, week = 1, team = "Florida State", category = "passing")

Get team records by year

cfbd_game_records(2018, team = "Notre Dame")

cfbd_game_records(2013, team = "Florida State")

Get team statistics by game

cfbd_game_team_stats(2019, team = "LSU")

cfbd_game_team_stats(2013, team = "Florida State")

Get results information from games.

cfbd_game_info(2018, week = 1)

cfbd_game_info(2018, week = 7, conference = "Ind")

# 7 OTs LSU @ TAMU
cfbd_game_info(2018, week = 13, team = "Texas A&M", quarter_scores = TRUE)

Get weather from games.

cfbd_game_weather(2018, week = 1)

cfbd_game_info(2018, week = 7, conference = "Ind")

Get calendar of weeks by season.

cfbd_calendar(2019)

Get game media information (TV, radio, etc).

cfbd_game_media(2019, week = 4, conference = "ACC")

Get live college football play-by-play data.

Description

Get live college football play-by-play data.

Usage

cfbd_live_plays(game_id)

Arguments

Value

cfbd_live_plays() - A data frame with 94 columns:

See Also

Other CFBD PBP: cfbd_pbp_data(), cfbd_play_stats_player(), cfbd_play_stats_types(), cfbd_play_types(), cfbd_plays()

Examples

  try(cfbd_live_plays(game_id=401520182))

Get live game scoreboard information from games.

Description

Get live game scoreboard information from games.

Usage

cfbd_live_scoreboard(division = "fbs", conference = NULL)

Arguments

Value

cfbd_live_scoreboard() - A data frame with 41 variables:

See Also

Other CFBD Games: cfbd_calendar(), cfbd_game_box_advanced(), cfbd_game_info(), cfbd_game_media(), cfbd_game_player_stats(), cfbd_game_records(), cfbd_game_team_stats(), cfbd_game_weather()

Examples

  try(cfbd_live_scoreboard(division='fbs', conference = "B12"))

CFBD Metrics Endpoint Overview

Description

cfbd_metrics_fg_ep():

Get field goal expected points values.

cfbd_metrics_wepa_team_season():

Get opponent-adjusted team season statistics for predicted points added (PPA).

cfbd_metrics_wepa_players_passing():

Get opponent-adjusted player passing statistics for predicted points added (PPA).

cfbd_metrics_wepa_players_rushing():

Get opponent-adjusted player rushing statistics for predicted points added (PPA).

cfbd_metrics_wepa_players_kicking():

Get Points Added Above Replacement (PAAR) ratings for kickers.

cfbd_metrics_ppa_games():

Get team game averages for predicted points added (PPA).

cfbd_metrics_ppa_players_games():

Get player game averages for predicted points added (PPA).

cfbd_metrics_ppa_players_season():

Get player season averages for predicted points added (PPA).

cfbd_metrics_ppa_predicted():

Calculate predicted points using Down and Distance.

cfbd_metrics_ppa_teams():

Get team averages for predicted points added (PPA).

cfbd_metrics_wp_pregame():

Get pre-game win probability data from CFBD API.

cfbd_metrics_wp():

Get win probability chart data from CFBD API.

Details

Get expected points for field goals by yards to goal and distance

  cfbd_metrics_fg_ep()

Get opponent-adjusted team season statistics for predicted points added (PPA)

 cfbd_metrics_wepa_team_season(year = 2019, team = "TCU")

Get opponent-adjusted player passing statistics for predicted points added (PPA)

cfbd_metrics_wepa_players_passing(year = 2019, team = "TCU")

Get opponent-adjusted player rushing statistics for predicted points added (PPA)

cfbd_metrics_wepa_players_rushing(year = 2019, team = "TCU")

Get Points Added Above Replacement (PAAR) ratings for kickers

cfbd_metrics_wepa_players_kicking(year = 2019, team = "TCU")

Get team game averages for predicted points added (PPA)

  cfbd_metrics_ppa_games(year = 2019, team = "TCU")

Get player game averages for predicted points added (PPA)

  cfbd_metrics_ppa_players_games(year = 2019, week = 3, team = "TCU")

Get player season averages for predicted points added (PPA)

  cfbd_metrics_ppa_players_season(year = 2019, team = "TCU")

Get team averages for predicted points added (PPA)

  cfbd_metrics_ppa_teams(year = 2019, team = "TCU")

Get pre-game and post-game win probability data from CFBD API

  cfbd_metrics_wp_pregame(year = 2019, week = 9, team = "Texas A&M")
  cfbd_metrics_wp(game_id = 401012356)

Calculate predicted points using down and distance

cfbd_metrics_ppa_predicted(down = 1, distance = 10)

Get FG expected points from CFBD API

Description

Get FG expected points from CFBD API

Usage

cfbd_metrics_fg_ep()

Value

cfbd_metrics_fg_ep() - A data frame with 3 variables:

yards_to_goal: integer.

Yards to the goal line (0-100).

distance: integer.

Distance to goal posts from kicking location (17 yds further than yards to goal).

expected_points: double.

Expected points given yards to goal / distance.

See Also

Other CFBD Metrics: cfbd_metrics_ppa_games(), cfbd_metrics_ppa_players_games(), cfbd_metrics_ppa_players_season(), cfbd_metrics_ppa_predicted(), cfbd_metrics_ppa_teams(), cfbd_metrics_wepa_players_kicking(), cfbd_metrics_wepa_players_passing(), cfbd_metrics_wepa_players_rushing(), cfbd_metrics_wepa_team_season(), cfbd_metrics_wp(), cfbd_metrics_wp_pregame()

Examples

  try(cfbd_metrics_fg_ep())

Get team game averages for predicted points added (PPA)

Description

Get team game averages for predicted points added (PPA)

Usage

cfbd_metrics_ppa_games(
  year,
  week = NULL,
  season_type = "both",
  team = NULL,
  conference = NULL,
  excl_garbage_time = FALSE
)

Arguments

Value

cfbd_metrics_ppa_games() - A data frame with 18 variables:

game_id: integer.

Referencing game id.

season: integer.

Season of the game.

week: integer.

Game week of the season.

season_type: character.

Season Type (regular, postseason, etc.

conference: character.

Conference of the team.

team: character.

Team name.

opponent: character.

Team Opponent.

off_overall: character.

Offense overall predicted points added (PPA).

off_passing: character.

Offense passing predicted points added (PPA).

off_rushing: character.

Offense rushing predicted points added (PPA).

off_first_down: character.

Offense 1st down predicted points added (PPA).

off_second_down: character.

Offense 2nd down predicted points added (PPA).

off_third_down: character.

Offense 3rd down predicted points added (PPA).

def_overall: character.

Defense overall predicted points added (PPA).

def_passing: character.

Defense passing predicted points added (PPA).

def_rushing: character.

Defense rushing predicted points added (PPA).

def_first_down: character.

Defense 1st down predicted points added (PPA).

def_second_down: character.

Defense 2nd down predicted points added (PPA).

def_third_down: character.

Defense 3rd down predicted points added (PPA).

See Also

Other CFBD Metrics: cfbd_metrics_fg_ep(), cfbd_metrics_ppa_players_games(), cfbd_metrics_ppa_players_season(), cfbd_metrics_ppa_predicted(), cfbd_metrics_ppa_teams(), cfbd_metrics_wepa_players_kicking(), cfbd_metrics_wepa_players_passing(), cfbd_metrics_wepa_players_rushing(), cfbd_metrics_wepa_team_season(), cfbd_metrics_wp(), cfbd_metrics_wp_pregame()

Examples

  try(cfbd_metrics_ppa_games(year = 2019, team = "TCU"))

Get player game averages for predicted points added (PPA)

Description

Get player game averages for predicted points added (PPA)

Usage

cfbd_metrics_ppa_players_games(
  year = NULL,
  week = NULL,
  season_type = "both",
  team = NULL,
  position = NULL,
  athlete_id = NULL,
  threshold = NULL,
  excl_garbage_time = FALSE
)

Arguments

Value

cfbd_metrics_ppa_players_games() - A data frame with 9 variables:

season: integer.

Season of the game.

week: integer.

Game week of the season.

athlete_id: character.

Athlete referencing id.

name: character.

Athlete name.

position: character.

Athlete position.

team: character.

Team name.

opponent: character.

Team Opponent name.

avg_PPA_all: double.

Average overall predicted points added (PPA).

avg_PPA_pass: double.

Average passing predicted points added (PPA).

avg_PPA_rush: double.

Average rushing predicted points added (PPA).

See Also

Other CFBD Metrics: cfbd_metrics_fg_ep(), cfbd_metrics_ppa_games(), cfbd_metrics_ppa_players_season(), cfbd_metrics_ppa_predicted(), cfbd_metrics_ppa_teams(), cfbd_metrics_wepa_players_kicking(), cfbd_metrics_wepa_players_passing(), cfbd_metrics_wepa_players_rushing(), cfbd_metrics_wepa_team_season(), cfbd_metrics_wp(), cfbd_metrics_wp_pregame()

Examples

  try(cfbd_metrics_ppa_players_games(year = 2019, week = 3, team = "TCU"))

Get player season averages for predicted points added (PPA)

Description

Get player season averages for predicted points added (PPA)

Usage

cfbd_metrics_ppa_players_season(
  year = NULL,
  team = NULL,
  conference = NULL,
  position = NULL,
  athlete_id = NULL,
  threshold = NULL,
  excl_garbage_time = FALSE
)

Arguments

Value

cfbd_metrics_ppa_players_season() - A data frame with 23 variables:

season: integer.

Season.

athlete_id: character.

Athlete referencing id.

name: character.

Athlete name.

position: character.

Athlete Position.

team: character.

Team name.

conference: character.

Team conference.

countable_plays: integer.

DEPRECATED Number of plays which can be counted.

avg_PPA_all: double.

Average overall predicted points added (PPA).

avg_PPA_pass: double.

Average passing predicted points added (PPA).

avg_PPA_rush: double.

Average rushing predicted points added (PPA).

avg_PPA_first_down: double.

Average 1st down predicted points added (PPA).

avg_PPA_second_down: double.

Average 2nd down predicted points added (PPA).

avg_PPA_third_down: double.

Average 3rd down predicted points added (PPA).

avg_PPA_standard_downs: double.

Average standard down predicted points added (PPA).

avg_PPA_passing_downs: double.

Average passing down predicted points added (PPA).

total_PPA_all: double.

Total overall predicted points added (PPA).

total_PPA_pass: double.

Total passing predicted points added (PPA).

total_PPA_rush: double.

Total rushing predicted points added (PPA).

total_PPA_first_down: double.

Total 1st down predicted points added (PPA).

total_PPA_second_down: double.

Total 2nd down predicted points added (PPA).

total_PPA_third_down: double.

Total 3rd down predicted points added (PPA).

total_PPA_standard_downs: double.

Total standard down predicted points added (PPA).

total_PPA_passing_downs: double.

Total passing down predicted points added (PPA).

See Also

Other CFBD Metrics: cfbd_metrics_fg_ep(), cfbd_metrics_ppa_games(), cfbd_metrics_ppa_players_games(), cfbd_metrics_ppa_predicted(), cfbd_metrics_ppa_teams(), cfbd_metrics_wepa_players_kicking(), cfbd_metrics_wepa_players_passing(), cfbd_metrics_wepa_players_rushing(), cfbd_metrics_wepa_team_season(), cfbd_metrics_wp(), cfbd_metrics_wp_pregame()

Examples

  try(cfbd_metrics_ppa_players_season(year = 2019, team = "TCU"))

Calculate predicted points using down and distance

Description

Calculate predicted points using down and distance

Usage

cfbd_metrics_ppa_predicted(down, distance)

Arguments

Value

cfbd_metrics_ppa_predicted() - A data frame with 2 variables:

yard_line: integer.

Yards to goal

predicted_points: character.

Predicted points at in that down-distance-yardline scenario

See Also

Other CFBD Metrics: cfbd_metrics_fg_ep(), cfbd_metrics_ppa_games(), cfbd_metrics_ppa_players_games(), cfbd_metrics_ppa_players_season(), cfbd_metrics_ppa_teams(), cfbd_metrics_wepa_players_kicking(), cfbd_metrics_wepa_players_passing(), cfbd_metrics_wepa_players_rushing(), cfbd_metrics_wepa_team_season(), cfbd_metrics_wp(), cfbd_metrics_wp_pregame()

Examples

  try(cfbd_metrics_ppa_predicted(down = 1, distance = 10))

  try(cfbd_metrics_ppa_predicted(down = 3, distance = 10))

Get team averages for predicted points added (PPA)

Description

Get team averages for predicted points added (PPA)

Usage

cfbd_metrics_ppa_teams(
  year = NULL,
  team = NULL,
  conference = NULL,
  excl_garbage_time = FALSE
)

Arguments

Value

cfbd_metrics_ppa_teams() - A data frame with 21 variables:

season: integer.

.

conference: character.

.

team: character.

.

off_overall: character.

Offense overall predicted points added (PPA).

off_passing: character.

Offense passing predicted points added (PPA).

off_rushing: character.

Offense rushing predicted points added (PPA).

off_first_down: character.

Offense 1st down predicted points added (PPA).

off_second_down: character.

Offense 2nd down predicted points added (PPA).

off_third_down: character.

Offense 3rd down predicted points added (PPA).

off_cumulative_total: character.

Offense cumulative total predicted points added (PPA).

off_cumulative_passing: character.

Offense cumulative total passing predicted points added (PPA).

off_cumulative_rushing: character.

Offense cumulative total rushing predicted points added (PPA).

def_overall: character.

Defense overall predicted points added (PPA).

def_passing: character.

Defense passing predicted points added (PPA).

def_rushing: character.

Defense rushing predicted points added (PPA).

def_first_down: character.

Defense 1st down predicted points added (PPA).

def_second_down: character.

Defense 2nd down predicted points added (PPA).

def_third_down: character.

Defense 3rd down predicted points added (PPA).

def_cumulative_total: character.

Defense cumulative total predicted points added (PPA).

def_cumulative_passing: character.

Defense cumulative total passing predicted points added (PPA).

def_cumulative_rushing: character.

Defense cumulative total rushing predicted points added (PPA).

See Also

Other CFBD Metrics: cfbd_metrics_fg_ep(), cfbd_metrics_ppa_games(), cfbd_metrics_ppa_players_games(), cfbd_metrics_ppa_players_season(), cfbd_metrics_ppa_predicted(), cfbd_metrics_wepa_players_kicking(), cfbd_metrics_wepa_players_passing(), cfbd_metrics_wepa_players_rushing(), cfbd_metrics_wepa_team_season(), cfbd_metrics_wp(), cfbd_metrics_wp_pregame()

Examples

  try(cfbd_metrics_ppa_teams(year = 2019, team = "TCU"))

Get Points Added Above Replacement (PAAR) ratings for kickers

Description

Get Points Added Above Replacement (PAAR) ratings for kickers

Usage

cfbd_metrics_wepa_players_kicking(year = NULL, team = NULL, conference = NULL)

Arguments

Value

cfbd_metrics_wepa_players_kicking() - A data frame with 7 variables:

See Also

Other CFBD Metrics: cfbd_metrics_fg_ep(), cfbd_metrics_ppa_games(), cfbd_metrics_ppa_players_games(), cfbd_metrics_ppa_players_season(), cfbd_metrics_ppa_predicted(), cfbd_metrics_ppa_teams(), cfbd_metrics_wepa_players_passing(), cfbd_metrics_wepa_players_rushing(), cfbd_metrics_wepa_team_season(), cfbd_metrics_wp(), cfbd_metrics_wp_pregame()

Examples

  try(cfbd_metrics_wepa_players_kicking(year = 2019, team = "TCU"))

Get opponent-adjusted player passing statistics for predicted points added (PPA)

Description

Get opponent-adjusted player passing statistics for predicted points added (PPA)

Usage

cfbd_metrics_wepa_players_passing(
  year = NULL,
  team = NULL,
  conference = NULL,
  position = NULL
)

Arguments

Value

cfbd_metrics_wepa_players_passing() - A data frame with 8 variables:

See Also

Other CFBD Metrics: cfbd_metrics_fg_ep(), cfbd_metrics_ppa_games(), cfbd_metrics_ppa_players_games(), cfbd_metrics_ppa_players_season(), cfbd_metrics_ppa_predicted(), cfbd_metrics_ppa_teams(), cfbd_metrics_wepa_players_kicking(), cfbd_metrics_wepa_players_rushing(), cfbd_metrics_wepa_team_season(), cfbd_metrics_wp(), cfbd_metrics_wp_pregame()

Examples

  try(cfbd_metrics_wepa_players_passing(year = 2019, team = "TCU"))

Get opponent-adjusted player rushing statistics for predicted points added (PPA)

Description

Get opponent-adjusted player rushing statistics for predicted points added (PPA)

Usage

cfbd_metrics_wepa_players_rushing(
  year = NULL,
  team = NULL,
  conference = NULL,
  position = NULL
)

Arguments

Value

cfbd_metrics_wepa_players_rushing() - A data frame with 8 variables:

See Also

Other CFBD Metrics: cfbd_metrics_fg_ep(), cfbd_metrics_ppa_games(), cfbd_metrics_ppa_players_games(), cfbd_metrics_ppa_players_season(), cfbd_metrics_ppa_predicted(), cfbd_metrics_ppa_teams(), cfbd_metrics_wepa_players_kicking(), cfbd_metrics_wepa_players_passing(), cfbd_metrics_wepa_team_season(), cfbd_metrics_wp(), cfbd_metrics_wp_pregame()

Examples

  try(cfbd_metrics_wepa_players_rushing(year = 2019, team = "TCU"))

Get opponent-adjusted team season statistics for predicted points added (PPA)

Description

Get opponent-adjusted team season statistics for predicted points added (PPA)

Usage

cfbd_metrics_wepa_team_season(year = NULL, team = NULL, conference = NULL)

Arguments

Value

cfbd_metrics_wepa_team_season() - A data frame with 26 variables:

See Also

Other CFBD Metrics: cfbd_metrics_fg_ep(), cfbd_metrics_ppa_games(), cfbd_metrics_ppa_players_games(), cfbd_metrics_ppa_players_season(), cfbd_metrics_ppa_predicted(), cfbd_metrics_ppa_teams(), cfbd_metrics_wepa_players_kicking(), cfbd_metrics_wepa_players_passing(), cfbd_metrics_wepa_players_rushing(), cfbd_metrics_wp(), cfbd_metrics_wp_pregame()

Examples

  try(cfbd_metrics_wepa_team_season(year = 2019, team = "TCU"))

Get win probability chart data from API

Description

Get win probability chart data from API

Usage

cfbd_metrics_wp(game_id)

Arguments

Value

cfbd_metrics_wp() - A data frame with 16 variables:

play_id: character.

Play referencing id.

play_text: character.

A text description of the play.

home_id: integer.

Home team referencing id.

home: character.

Home team name.

away_id: integer.

Away team referencing id.

away: character.

Away team name.

spread: character.

Betting lines provider spread.

home_ball: logical.

Home team has the ball.

home_score: integer.

Home team score.

away_score: integer.

Away team score.

down: integer.

Down of the play.

distance: integer.

Distance to the sticks (to 1st down marker of goal-line in goal-to-go situations).

home_win_prob: character.

Home team win probability.

away_win_prob: double.

Away team win probability.

play_number: integer.

Game play number.

yard_line: integer.

Yard line of the play (0-100 yards).

See Also

Other CFBD Metrics: cfbd_metrics_fg_ep(), cfbd_metrics_ppa_games(), cfbd_metrics_ppa_players_games(), cfbd_metrics_ppa_players_season(), cfbd_metrics_ppa_predicted(), cfbd_metrics_ppa_teams(), cfbd_metrics_wepa_players_kicking(), cfbd_metrics_wepa_players_passing(), cfbd_metrics_wepa_players_rushing(), cfbd_metrics_wepa_team_season(), cfbd_metrics_wp_pregame()

Examples

  try(cfbd_metrics_wp(game_id = 401012356))

Get pre-game win probability data from API

Description

Get pre-game win probability data from API

Usage

cfbd_metrics_wp_pregame(
  year = NULL,
  week = NULL,
  team = NULL,
  season_type = "both"
)

Arguments

Value

cfbd_metrics_wp_pregame() - A data frame with 9 variables:

season: integer.

Season of game.

season_type: character.

Season type of game.

week: integer.

Game week of the season.

game_id: integer.

Referencing game id.

home_team: character.

Home team name.

away_team: character.

Away team name.

spread: integer.

Betting line provider spread.

home_win_prob: double.

Home win probability - pre-game prediction.

away_win_prob: double.

Away win probability - pre-game prediction.

See Also

Other CFBD Metrics: cfbd_metrics_fg_ep(), cfbd_metrics_ppa_games(), cfbd_metrics_ppa_players_games(), cfbd_metrics_ppa_players_season(), cfbd_metrics_ppa_predicted(), cfbd_metrics_ppa_teams(), cfbd_metrics_wepa_players_kicking(), cfbd_metrics_wepa_players_passing(), cfbd_metrics_wepa_players_rushing(), cfbd_metrics_wepa_team_season(), cfbd_metrics_wp()

Examples

  try(cfbd_metrics_wp_pregame(year = 2019, week = 9, team = "Texas A&M"))

Get college football play by play data with cfbfastR expected points/win probability added

Description

Extract college football (D-I) play by play Data - for plays

Usage

cfbd_pbp_data(
  year,
  season_type = "regular",
  week = 1,
  team = NULL,
  play_type = NULL,
  epa_wpa = FALSE,
  ...
)

Arguments

Details

 # Get play by play data for 2025 regular season week 1
 cfbd_pbp_data(year = 2025, week = 1, season_type = 'regular', epa_wpa = TRUE)

Value

A data frame with 368 variables:

See Also

Other CFBD PBP: cfbd_live_plays(), cfbd_play_stats_player(), cfbd_play_stats_types(), cfbd_play_types(), cfbd_plays()

CFBD Plays Endpoint Overview

Description

College football plays data

cfbd_plays():

CFBD's college football play-by-play.

cfbd_play_stats_player():

Gets player info associated by play.

cfbd_play_stats_types():

Gets CFBD play stat types.

cfbd_play_types():

Gets CFBD play types.

Details

Pull first 3 weeks of 2020 season using cfbd_plays()

 year_vector <- 2020
 week_vector <- 1:3
 weekly_year_df <- expand.grid(year = year_vector, week = week_vector)
 tictoc::tic()
 year_split <- split(weekly_year_df, weekly_year_df$year)
 for (i in 1:length(year_split)) {
   i <- 1

   progressr::with_progress({
      year_split[[i]] <- year_split[[i]] %>%
         dplyr::mutate(
            pbp = purrr::map2(
                .x = year,
                .y = week,
                cfbd_plays,
                season_type = "both"
            )
         )
     Sys.sleep(1)
   })
 }

 tictoc::toc()
 year_split <- lapply(year_split, function(x) {
     x %>% tidyr::unnest(pbp, names_repair = "minimal")
 })

 all_years <- dplyr::bind_rows(year_split)
 glimpse(all_years)

Gets player info associated by play

cfbd_play_stats_player(game_id = 401110722)

Gets CFBD play stat types

cfbd_play_stats_types()

Gets CFBD play types

cfbd_play_types()

Gets player info associated by play

Description

Gets player info associated by play

Usage

cfbd_play_stats_player(
  year = NULL,
  week = NULL,
  team = NULL,
  game_id = NULL,
  athlete_id = NULL,
  stat_type_id = NULL,
  season_type = "regular"
)

Arguments

Value

cfbd_play_stats_player() - A data frame with 54 variables:

play_id: character.

Referencing play id.

game_id: integer.

Referencing game id.

season: integer.

Season of the play.

week: integer.

Week of the play.

opponent: character.

Opponent of the offense on the play.

team_score: integer.

Offense team score.

opponent_score: integer.

Defense team score.

drive_id: character.

Referencing drive id.

period: integer.

Game period (quarter) of the play.

yards_to_goal: integer.

Yards to the goal line (~0-100).

down: integer.

Down of the play.

distance: integer.

Distance to the sticks, i.e. 1st down or goal-line in goal-to-go situations.

reception_player_id: character.

Pass receiver player reference id.

reception_player: character.

Pass receiver player name.

reception_yds: integer.

Reception yards.

completion_player_id: character.

Passing player reference id.

completion_player: character.

Passing player name.

completion_yds: integer.

Passing yards.

rush_player_id: character.

Rushing player reference id.

rush_player: character.

Rushing player name.

rush_yds: integer.

Rushing yards.

interception_player_id: character.

Intercepting player reference id.

interception_player: character.

Intercepting player name.

interception_stat: integer.

Intercepting stat.

interception_thrown_player_id: character.

Interception passing player reference id.

interception_thrown_player: character.

Interception passing player name.

interception_thrown_stat: integer.

Interception thrown stat.

touchdown_player_id: character.

Touchdown scoring player reference id.

touchdown_player: character.

Touchdown scoring player name.

touchdown_stat: integer.

Touchdown scoring stat.

incompletion_player_id: character.

Incomplete receiver player reference id.

incompletion_player: character.

Incomplete receiver player name.

incompletion_stat: integer.

Incomplete stat.

target_player_id: character.

Targeted receiver player reference id.

target_player: character.

Targeted receiver player name.

target_stat: integer.

Target stat.

fumble_recovered_player_id: logical.

Fumble recovering player reference id.

fumble_recovered_player: logical.

Fumble recovering player name.

fumble_recovered_stat: logical.

Fumble recovered stat.

fumble_forced_player_id: logical.

Fumble forcing player reference id.

fumble_forced_player: logical.

Fumble forcing player name.

fumble_forced_stat: logical.

Fumble forced stat.

fumble_player_id: logical.

Fumbling player reference id.

fumble_player: logical.

Fumbling player name.

fumble_stat: logical.

Fumble stat.

sack_player_id: character.

Sacking player(s) reference id.

sack_player: character.

Sacking player(s) name.

sack_stat: integer.

Sack stat.

sack_taken_player_id: character.

Sack taking player reference id.

sack_taken_player: character.

Sack taking player name.

sack_taken_stat: integer.

Sack taken stat.

pass_breakup_player_id: logical.

Pass breakup player reference id.

pass_breakup_player: logical.

Pass breakup player name.

pass_breakup_stat: logical.

Pass breakup (PBU) stat.

field_goal_attempt_player_id: character.

Field goal attempting player reference id.

field_goal_attempt_player: character.

Field goal attempting player name.

field_goal_attempt_stat: integer.

Field goal attempt stat.

field_goal_made_player_id: character.

Field goal making player reference id.

field_goal_made_player: character.

Field goal making player name.

field_goal_made_stat: integer.

Field goal made stat.

field_goal_missed_player_id: character.

Field goal missing player reference id.

field_goal_missed_player: character.

Field goal missing player name.

field_goal_missed_stat: integer.

Field goal missed stat.

field_goal_blocked_player_id: character.

Field goal blocked player reference id.

field_goal_blocked_player: character.

Field goal blocked player name.

field_goal_blocked_stat: integer.

Field goal blocked stat.

See Also

Other CFBD PBP: cfbd_live_plays(), cfbd_pbp_data(), cfbd_play_stats_types(), cfbd_play_types(), cfbd_plays()

Examples

  try(cfbd_play_stats_player(game_id = 401628414))
  try(cfbd_play_stats_player(year = 2025, week = 1))

Get college football mapping for play stats types

Description

Get college football mapping for play stats types

Usage

cfbd_play_stats_types()

Value

cfbd_play_stats_types() - A data frame with 25 rows and 2 variables:

play_stat_type_id: integer

Referencing play stat type ID.

name: character

Type of play stats.

See Also

Other CFBD PBP: cfbd_live_plays(), cfbd_pbp_data(), cfbd_play_stats_player(), cfbd_play_types(), cfbd_plays()

Examples

  try(cfbd_play_stats_types())

Get college football mapping for play types

Description

Get college football mapping for play types

Usage

cfbd_play_types()

Value

cfbd_play_types() - A data frame with 48 rows and 3 variables:

play_type_id: integer

Referencing play type id.

text: character

play type description.

abbreviation: character

play type abbreviation used for function call

See Also

Other CFBD PBP: cfbd_live_plays(), cfbd_pbp_data(), cfbd_play_stats_player(), cfbd_play_stats_types(), cfbd_plays()

Examples

  try(cfbd_play_types())

Player information lookup

Description

Player information lookup

Usage

cfbd_player_info(search_term, position = NULL, team = NULL, year = NULL)

Arguments

Value

cfbd_player_info() - A data frame with 12 variables:

athlete_id:character.

Unique player identifier athlete_id.

team:character.

Team of the player.

name:character.

Player name.

first_name:character.

Player first name.

last_name:character.

Player last name.

weight:integer.

Player weight.

height:integer.

Player height.

jersey:integer.

Player jersey number.

position:character.

Player position.

home_town:character.

Player home town.

team_color:character.

Player team color.

team_color_secondary:character.

Player team secondary color.

See Also

Other CFBD Players: cfbd_player_returning(), cfbd_player_usage()

Examples

  try(cfbd_player_info(search_term = "James", position = "DB", team = "Florida State", year = 2017))

  try(cfbd_player_info(search_term = "Lawrence", team = "Clemson"))

Get player returning production

Description

Get player returning production

Usage

cfbd_player_returning(
  year = most_recent_cfb_season(),
  team = NULL,
  conference = NULL
)

Arguments

Value

cfbd_player_returning() - A data frame with 15 variables:

season:integer.

Returning player season.

team:character.

Team name.

conference:character.

Conference of team.

total_ppa:double.

Total predicted points added returning.

total_passing_ppa:double.

Total passing predicted points added returning.

total_receiving_ppa:double.

Total receiving predicted points added returning.

total_rushing_ppa:double.

Total rushing predicted points added returning.

percent_ppa:double.

Percentage of prior year's predicted points added returning.

percent_passing_ppa:double.

Percentage of prior year's passing predicted points added returning.

percent_receiving_ppa:double.

Percentage of prior year's receiving predicted points added returning.

percent_rushing_ppa:double.

Percentage of prior year's rushing predicted points added returning.

usage:double.

.

passing_usage:double.

.

receiving_usage:double.

.

rushing_usage:double.

.

See Also

Other CFBD Players: cfbd_player_info(), cfbd_player_usage()

Examples

   try(cfbd_player_returning(year = 2019, team = "Florida State"))

Get player usage metrics

Description

Get player usage metrics

Usage

cfbd_player_usage(
  year = most_recent_cfb_season(),
  team = NULL,
  conference = NULL,
  position = NULL,
  athlete_id = NULL,
  excl_garbage_time = FALSE
)

Arguments

Value

cfbd_player_usage() - A data frame with 14 variables:

season: integer.

Player usage season.

athlete_id: character.

Referencing athlete id.

name: character.

Athlete name.

position: character.

Athlete position.

team: character.

Team name.

conference: character.

Conference of team.

usg_overall: double.

Player usage of overall offense.

usg_pass: double.

Player passing usage percentage.

usg_rush: double.

Player rushing usage percentage.

usg_1st_down: double.

Player first down usage percentage.

usg_2nd_down: double.

Player second down usage percentage.

usg_3rd_down: double.

Player third down usage percentage.

usg_standard_downs: double.

Player standard down usage percentage.

usg_passing_downs: double.

Player passing down usage percentage.

See Also

Other CFBD Players: cfbd_player_info(), cfbd_player_returning()

Examples

  try(cfbd_player_usage(year = 2019, position = "WR", team = "Florida State"))

CFBD Players Endpoint Overview

Description

cfbd_player_info():

Player information search.

cfbd_player_returning():

Player returning production.

cfbd_player_usage():

Player usage.

Details

Player information lookup

 cfbd_player_info(search_term = "James", position = "DB", team = "Florida State", year = 2017)

 cfbd_player_info(search_term = "Lawrence", team = "Clemson")

Get player returning production

 cfbd_player_returning(year = 2019, team = "Florida State")

Get player usage metrics

 cfbd_player_usage(year = 2019, position = "WR", team = "Florida State")

Get college football play-by-play data.

Description

Get college football play-by-play data.

Usage

cfbd_plays(
  year = 2020,
  season_type = "regular",
  week = 1,
  team = NULL,
  offense = NULL,
  defense = NULL,
  conference = NULL,
  offense_conference = NULL,
  defense_conference = NULL,
  play_type = NULL,
  division = "fbs"
)

Arguments

Value

cfbd_plays() - A data frame with 29 columns:

play_id: character.

Referencing play id.

offense: character.

Offense on the field.

offense_conference: character.

Conference of the offense on the field.

defense: character.

Defense on the field.

defense_conference: character.

Conference of the defense on the field.

home: character.

Home team.

away: character.

Away team.

offense_score: integer.

Offense's post-play score.

defense_score: integer.

Defense's post-play score.

game_id: integer.

Referencing game id.

drive_id: character.

Referencing drive id.

drive_number: integer.

Drive number in the game.

play_number: integer.

Play number in the game.

period: integer.

Game period (quarter).

offense_timeouts: integer.

Timeouts for the offense at the end of the play.

defense_timeouts: integer.

Timeouts for the defense at the end of the play.

yard_line: integer.

Yard line (~0-50) of the play.

yards_to_goal: integer.

Yards to the goal line (~0-100).

down: integer.

Down of the play.

distance: integer.

Distance to the sticks, i.e. 1st down or goal-line in goal-to-go situations.

scoring: logical.

Scoring play flag.

yards_gained: integer.

Yards net gained by the offense on the play.

play_type: character.

Categorical label of the type of the play.

play_text: character.

A text description of the play.

ppa: character.

Predicted Points Added (calculated by CFBD).

clock_minutes: integer.

Minutes left on the clock.

clock_seconds: integer.

Seconds left on the clock.

See Also

Other CFBD PBP: cfbd_live_plays(), cfbd_pbp_data(), cfbd_play_stats_player(), cfbd_play_stats_types(), cfbd_play_types()

Examples

  try(cfbd_plays(year = 2021, week = 1))

Get historical Coaches and AP poll data

Description

Get historical Coaches and AP poll data

Usage

cfbd_rankings(year, week = NULL, season_type = "both")

Arguments

Value

cfbd_rankings() - A data frame with 9 variables:

See Also

Other CFBD Ratings and Rankings: cfbd_ratings_elo(), cfbd_ratings_fpi(), cfbd_ratings_sp(), cfbd_ratings_sp_conference(), cfbd_ratings_srs()

Examples

  try(cfbd_rankings(year = 2019, week = 12))

  try(cfbd_rankings(year = 2018, week = 14))

  try(cfbd_rankings(year = 2013, season_type = "postseason"))

CFBD Ratings and Rankings Endpoints Overview

Description

cfbd_rankings():

Gets Historical CFB poll rankings at a specific week.

cfbd_ratings_sp():

Get SP historical rating data.

cfbd_ratings_sp_conference():

Get SP conference-level historical rating data.

cfbd_ratings_srs():

Get SRS historical rating data.

cfbd_ratings_elo():

Get Elo historical rating data.

cfbd_ratings_fpi():

Get FPI historical rating data.

Get historical Coaches and AP poll data

cfbd_rankings(year = 2019, week = 12)

cfbd_rankings(year = 2018, week = 14)

cfbd_rankings(year = 2013, season_type = "postseason")

Get SP historical rating data

At least one of year or team must be specified for the function to run

cfbd_ratings_sp(year = 2018)

cfbd_ratings_sp(team = "Texas A&M")

cfbd_ratings_sp(year = 2019, team = "Texas")

Get conference level SP historical rating data

cfbd_ratings_sp_conference(year = 2019)

cfbd_ratings_sp_conference(year = 2012, conference = "SEC")

cfbd_ratings_sp_conference(year = 2016, conference = "ACC")

Get SRS historical rating data

At least one of year or team must be specified for the function to run

cfbd_ratings_srs(year = 2019, team = "Texas")

cfbd_ratings_srs(year = 2018, conference = "SEC")

Get Elo historical rating data

Acquire the CFBD calculated elo ratings data by team, year, week, and conference

cfbd_ratings_elo(year = 2019, team = "Texas")

cfbd_ratings_elo(year = 2018, conference = "SEC")

Get FPI historical rating data

Acquire the ESPN FPI ratings data by team, year, and conference

cfbd_ratings_fpi(year = 2019, team = "Texas")

cfbd_ratings_fpi(year = 2018, conference = "SEC")

Get Elo historical rating data

Description

Acquire the CFBD calculated elo ratings data by team, year, week, and conference

Usage

cfbd_ratings_elo(
  year = NULL,
  week = NULL,
  season_type = "both",
  team = NULL,
  conference = NULL
)

Arguments

Value

cfbd_ratings_elo() - A data frame with 4 variables:

See Also

Other CFBD Ratings and Rankings: cfbd_rankings(), cfbd_ratings_fpi(), cfbd_ratings_sp(), cfbd_ratings_sp_conference(), cfbd_ratings_srs()

Examples

  try(cfbd_ratings_elo(year = 2019, team = "Texas"))

  try(cfbd_ratings_elo(year = 2018, conference = "SEC"))

Get Football Power Index (FPI) historical rating data

Description

Acquire the ESPN calculated FPI ratings data by team, year, and conference

Usage

cfbd_ratings_fpi(year = NULL, team = NULL, conference = NULL)

Arguments

Value

cfbd_ratings_fpi() - A data frame with 14 variables:

See Also

Other CFBD Ratings and Rankings: cfbd_rankings(), cfbd_ratings_elo(), cfbd_ratings_sp(), cfbd_ratings_sp_conference(), cfbd_ratings_srs()

Examples

  try(cfbd_ratings_fpi(year = 2019, team = "Texas"))

  try(cfbd_ratings_fpi(year = 2018, conference = "SEC"))

Get SP historical rating data

Description

At least one of year or team must be specified for the function to run

Usage

cfbd_ratings_sp(year = NULL, team = NULL)

Arguments

Value

cfbd_ratings_sp() - A data frame with 26 variables:

See Also

Other CFBD Ratings and Rankings: cfbd_rankings(), cfbd_ratings_elo(), cfbd_ratings_fpi(), cfbd_ratings_sp_conference(), cfbd_ratings_srs()

Examples

  try(cfbd_ratings_sp(year = 2018))

  try(cfbd_ratings_sp(team = "Texas A&M"))

  try(cfbd_ratings_sp(year = 2019, team = "Texas"))

Get conference level SP historical rating data

Description

Get conference level SP historical rating data

Usage

cfbd_ratings_sp_conference(year = NULL, conference = NULL)

Arguments

Value

cfbd_ratings_sp_conference() - A data frame with 25 variables:

year: integer.

Season of the conference rating.

conference: character.

Conference name.

rating: double.

Conference SP+ rating.

second_order_wins: logical.

Second-order wins for the conference - Not available for recent seasons.

sos: logical.

Strength of schedule for the conference - Not available for recent seasons..

offense_rating: double.

Overall offense rating for the conference.

offense_success: logical.

Offense success rating for the conference - Not available for recent seasons.

offense_explosiveness: logical.

Offense explosiveness rating for the conference - Not available for recent seasons.

offense_rushing: logical.

Offense rushing rating for the conference - Not available for recent seasons.

offense_passing: logical.

Offense passing rating for the conference - Not available for recent seasons.

offense_standard_downs: logical.

Offense standard downs rating for the conference - Not available for recent seasons.

offense_passing_downs: logical.

Offensive passing downs rating for the conference - Not available for recent seasons.

offense_run_rate: logical.

Offense rushing rate for the conference - Not available for recent seasons.

offense_pace: logical.

Offense pace factor for the conference - Not available for recent seasons.

defense_ranking: integer.

Overall defense ranking for the conference.

defense_rating: double.

Overall defense rating for the conference.

defense_success: logical.

Defense success rating for the conference - Not available for recent seasons.

defense_explosiveness: logical.

Defense explosiveness rating for the conference - Not available for recent seasons.

defense_rushing: logical.

Defense rushing rating for the conference - Not available for recent seasons.

defense_passing: logical.

Defense passing rating for the conference - Not available for recent seasons.

defense_standard_downs: logical.

Defense standard downs rating for the conference - Not available for recent seasons.

defense_passing_downs: logical.

Defensive passing downs rating for the conference - Not available for recent seasons.

defense_havoc_total: logical.

Total defensive havoc rate for the conference - Not available for recent seasons.

defense_havoc_front_seven: logical.

Defense havoc rate from front 7 players for the conference - Not available for recent seasons.

defense_havoc_db: logical.

Defense havoc rate from defensive backs for the conference - Not available for recent seasons.

special_teams_rating: double.

Special teams rating for the conference.

See Also

Other CFBD Ratings and Rankings: cfbd_rankings(), cfbd_ratings_elo(), cfbd_ratings_fpi(), cfbd_ratings_sp(), cfbd_ratings_srs()

Examples

  try(cfbd_ratings_sp_conference(year = 2019))

  try(cfbd_ratings_sp_conference(year = 2012, conference = "SEC"))

  try(cfbd_ratings_sp_conference(year = 2016, conference = "ACC"))

Get SRS historical rating data

Description

At least one of year or team must be specified for the function to run

Usage

cfbd_ratings_srs(year = NULL, team = NULL, conference = NULL)

Arguments

Value

cfbd_ratings_srs() - A data frame with 6 variables:

year: integer.

Season of the SRS rating.

team: character.

Team name.

conference: character.

Conference of the team.

division: logical.

Division in the conference for the team.

rating: double.

Simple Rating System (SRS) rating.

ranking: integer.

Simple Rating System ranking within the group returned.

See Also

Other CFBD Ratings and Rankings: cfbd_rankings(), cfbd_ratings_elo(), cfbd_ratings_fpi(), cfbd_ratings_sp(), cfbd_ratings_sp_conference()

Examples

  try(cfbd_ratings_srs(year = 2019, team = "Texas"))

  try(cfbd_ratings_srs(year = 2018, conference = "SEC"))

CFB Recruiting Endpoint Overview

Description

cfbd_recruiting_player():

Get college football player recruiting information for a single year with filters available for team, recruit type, state and position.

cfbd_recruiting_position():

Get college football position group recruiting information .

cfbd_recruiting_team():

Get college football recruiting team rankings information.

Get player recruiting rankings

Get college football player recruiting information for a single year with filters available for team, recruit type, state and position.

cfbd_recruiting_player(2018, team = "Texas")

cfbd_recruiting_player(2016, recruit_type = "JUCO")

cfbd_recruiting_player(2020, recruit_type = "HighSchool", position = "OT", state = "FL")

Get college football position group recruiting information.

cfbd_recruiting_position(2018, team = "Texas")

cfbd_recruiting_position(2016, 2020, team = "Virginia")

cfbd_recruiting_position(2015, 2020, conference = "SEC")

Get college football recruiting team rankings information.

cfbd_recruiting_team(2018, team = "Texas")

cfbd_recruiting_team(2016, team = "Virginia")

cfbd_recruiting_team(2016, team = "Texas A&M")

cfbd_recruiting_team(2011)

Details

Gets CFB team recruiting ranks with filters available for year and team. At least one of year or team must be specified for the function to run

If you would like CFB recruiting information for players, please see the cfbd_recruiting_player() function

If you would like to get CFB recruiting information based on position groups during a time period for all FBS teams, please see the cfbd_recruiting_position() function.

cfbd_recruiting_player() - At least one of year or team must be specified for the function to run

cfbd_recruiting_position() - If only start_year is provided, function will get CFB recruiting information based on position groups during that year for all FBS teams.

Get player recruiting rankings

Description

Get player recruiting rankings

Usage

cfbd_recruiting_player(
  year = NULL,
  team = NULL,
  recruit_type = "HighSchool",
  state = NULL,
  position = NULL
)

Arguments

Value

cfbd_recruiting_player() - A data frame with 14 variables:

id: integer.

Referencing id - 247Sports.

athlete_id

Athlete referencing id.

recruit_type: character.

High School, Prep School, or Junior College.

year: integer.

Recruit class year.

ranking: integer.

Recruit Ranking.

name: character.

Recruit Name.

school: character.

School recruit attended.

committed_to: character.

School the recruit is committed to.

position: character.

Recruit position.

height: double.

Recruit height.

weight: integer.

Recruit weight.

stars: integer.

Recruit stars.

rating: double.

247 composite rating.

city: character.

Hometown of the recruit.

state_province: character.

Hometown state of the recruit.

country: character.

Hometown country of the recruit.

hometown_info_latitude: character.

Hometown latitude.

hometown_info_longitude: character.

Hometown longitude.

hometown_info_fips_code: character.

Hometown FIPS code.

See Also

Other CFBD Recruiting: cfbd_recruiting_position(), cfbd_recruiting_team(), cfbd_recruiting_transfer_portal()

Examples

  try(cfbd_recruiting_player(2018, team = "Texas"))

  try(cfbd_recruiting_player(2016, recruit_type = "JUCO"))

  try(cfbd_recruiting_player(2020, recruit_type = "HighSchool", position = "OT", state = "FL"))

Get college football position group recruiting information.

Description

Get college football position group recruiting information.

Usage

cfbd_recruiting_position(
  start_year = NULL,
  end_year = NULL,
  team = NULL,
  conference = NULL
)

Arguments

Value

cfbd_recruiting_position() - A data frame with 7 variables:

team: character.

Recruiting team.

conference: character.

Recruiting team conference.

position_group: character.

Position group of the recruits.

avg_rating: double.

Average rating of the recruits in the position group.

total_rating: double.

Sum of the ratings of the recruits in the position group.

commits: integer.

Number of commits in the position group.

avg_stars: double.

Average stars of the recruits in the position group.

See Also

Other CFBD Recruiting: cfbd_recruiting_player(), cfbd_recruiting_team(), cfbd_recruiting_transfer_portal()