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.3 ──
#>  Data updated: 2022-09-23 03:23:09 UTC
#> # A tibble: 1 × 21
#>    year team     confe…¹ divis…² expec…³ total…⁴ total…⁵ total…⁶ total…⁷ confe…⁸
#>   <int> <chr>    <chr>   <chr>     <dbl>   <int>   <int>   <int>   <int>   <int>
#> 1  2018 Notre D… FBS In… ""         10.5      13      12       1       0       0
#> # … with 11 more variables: 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>, and abbreviated variable names
#> #   ¹​conference, ²​division, ³​expected_wins, ⁴​total_games, ⁵​total_wins,
#> #   ⁶​total_losses, ⁷​total_ties, ⁸​conference_games

  try(cfbd_game_records(2013, team = "Florida State"))
#> ── Game records data from CollegeFootballData.com ──────────── cfbfastR 1.9.3 ──
#>  Data updated: 2022-09-23 03:23:10 UTC
#> # A tibble: 1 × 21
#>    year team     confe…¹ divis…² expec…³ total…⁴ total…⁵ total…⁶ total…⁷ confe…⁸
#>   <int> <chr>    <chr>   <chr>     <dbl>   <int>   <int>   <int>   <int>   <int>
#> 1  2013 Florida… ACC     Atlant…    12.3      14      14       0       0       9
#> # … with 11 more variables: 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>, and abbreviated variable names
#> #   ¹​conference, ²​division, ³​expected_wins, ⁴​total_games, ⁵​total_wins,
#> #   ⁶​total_losses, ⁷​total_ties, ⁸​conference_games
# }