Skip to contents

Get team records by year

Usage

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

Arguments

year

(Integer optional): Year, 4 digit format (YYYY)

team

(String optional): Team - Select a valid team, D1 football

conference

(String optional): DI Conference abbreviation - Select a valid FBS conference Conference abbreviations P5: ACC, B12, B1G, SEC, PAC Conference abbreviations G5 and FBS Independents: CUSA, MAC, MWC, Ind, SBC, AAC

Value

cfbd_game_records() - A data frame with 21 variables:

year: integer.

Season of the games.

team: character.

Team name.

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.

Examples

# \donttest{
  try(cfbd_game_records(2018, team = "Notre Dame"))
#> ── Game records data from CollegeFootballData.com ──────────── cfbfastR 1.9.5 ──
#>  Data updated: 2024-09-10 01:23:09 UTC
#> # A tibble: 1 × 22
#>    year team_id team    conference division expected_wins total_games total_wins
#>   <int>   <int> <chr>   <chr>      <chr>            <dbl>       <int>      <int>
#> 1  2018      87 Notre … FBS Indep… ""                10.5          13         12
#> # ℹ 14 more variables: total_losses <int>, total_ties <int>,
#> #   conference_games <int>, conference_wins <int>, conference_losses <int>,
#> #   conference_ties <int>, home_games <int>, home_wins <int>,
#> #   home_losses <int>, home_ties <int>, away_games <int>, away_wins <int>,
#> #   away_losses <int>, away_ties <int>

  try(cfbd_game_records(2013, team = "Florida State"))
#> ── Game records data from CollegeFootballData.com ──────────── cfbfastR 1.9.5 ──
#>  Data updated: 2024-09-10 01:23:10 UTC
#> # A tibble: 1 × 22
#>    year team_id team    conference division expected_wins total_games total_wins
#>   <int>   <int> <chr>   <chr>      <chr>            <dbl>       <int>      <int>
#> 1  2013      52 Florid… ACC        Atlantic          12.3          14         14
#> # ℹ 14 more variables: total_losses <int>, total_ties <int>,
#> #   conference_games <int>, conference_wins <int>, conference_losses <int>,
#> #   conference_ties <int>, home_games <int>, home_wins <int>,
#> #   home_losses <int>, home_ties <int>, away_games <int>, away_wins <int>,
#> #   away_losses <int>, away_ties <int>
# }