At least one of year or team must be specified for the function to run
Value
cfbd_ratings_sp() - A data frame with 26 variables:
| col_name | types | description |
| year | integer | Four-digit season year (e.g. 2018). |
| team | character | Full team name (e.g. "Texas A&M"). |
| conference | character | Conference affiliation for the team in the given season. |
| rating | numeric | Overall SP+ rating (Bill Connelly methodology, in points per game). |
| ranking | integer | National rank of the team's overall SP+ rating (1 = best). |
| second_order_wins | numeric | Estimated wins based on opponent-adjusted efficiency rather than actual results. |
| sos | numeric | Strength of schedule rating (SP+ scale). |
| offense_ranking | integer | National rank of the team's offensive SP+ rating (1 = best). |
| offense_rating | numeric | Offensive SP+ rating (points per drive adjusted for opponent). |
| offense_success | numeric | Offensive success rate component of SP+ (probability 0-1). |
| offense_explosiveness | numeric | Offensive explosiveness component of SP+ (EqPts/play on successful plays). |
| offense_rushing | numeric | Offensive rushing efficiency component of SP+. |
| offense_passing | numeric | Offensive passing efficiency component of SP+. |
| offense_standard_downs | numeric | Offensive SP+ on standard downs (1st, 2nd & <= 7, 3rd/4th & <= 4). |
| offense_passing_downs | numeric | Offensive SP+ on passing downs (2nd & >= 8, 3rd/4th & >= 5). |
| offense_run_rate | numeric | Share of offensive snaps that are designed runs (0-1). |
| offense_pace | numeric | Average seconds per play for the offense. |
| defense_ranking | integer | National rank of the team's defensive SP+ rating (1 = best). |
| defense_rating | numeric | Defensive SP+ rating (points per drive allowed, opponent-adjusted). |
| defense_success | numeric | Defensive success rate component of SP+ (probability 0-1). |
| defense_explosiveness | numeric | Defensive explosiveness component of SP+ (EqPts/play allowed on successes). |
| defense_rushing | numeric | Defensive rushing efficiency component of SP+. |
| defense_passing | numeric | Defensive passing efficiency component of SP+. |
| defense_standard_downs | numeric | Defensive SP+ on standard downs. |
| defense_passing_downs | numeric | Defensive SP+ on passing downs. |
| defense_havoc_total | numeric | Total havoc rate (TFLs + PBUs + forced fumbles divided by plays). |
| defense_havoc_front_seven | numeric | Havoc rate contributed by the defensive front seven. |
| defense_havoc_db | numeric | Havoc rate contributed by defensive backs. |
| special_teams_rating | numeric | Special teams SP+ rating (points per game). |
See also
Other CFBD Ratings and Rankings:
cfbd_rankings(),
cfbd_ratings_elo(),
cfbd_ratings_fpi(),
cfbd_ratings_sp_conference(),
cfbd_ratings_srs()
Examples
# \donttest{
try(cfbd_ratings_sp(year = 2018))
#> ── SP+ data from CollegeFootballData.com ───────────────────── cfbfastR 2.3.0 ──
#> ℹ Data updated: 2026-06-09 20:00:44 UTC
#> # A tibble: 131 × 29
#> year team conference rating ranking second_order_wins sos offense_ranking
#> <int> <chr> <chr> <dbl> <int> <dbl> <dbl> <int>
#> 1 2018 Alab… SEC 36.3 1 13.8 0.795 2
#> 2 2018 Geor… SEC 32.9 2 11.5 0.794 3
#> 3 2018 Clem… ACC 29.7 3 14 0.912 5
#> 4 2018 Okla… SEC 24.9 4 11.7 0.909 1
#> 5 2018 LSU SEC 24.2 5 9.1 0.75 30
#> 6 2018 Ohio… Big Ten 24.1 6 10.9 0.899 4
#> 7 2018 Aubu… SEC 23.6 7 8.2 0.761 19
#> 8 2018 Miss… SEC 23.2 8 8.7 0.791 32
#> 9 2018 Flor… SEC 23 9 9.7 0.813 15
#> 10 2018 Mich… Big Ten 22 10 10.3 0.867 25
#> # ℹ 121 more rows
#> # ℹ 21 more variables: offense_rating <dbl>, offense_success <dbl>,
#> # offense_explosiveness <dbl>, offense_rushing <dbl>, offense_passing <dbl>,
#> # offense_standard_downs <dbl>, offense_passing_downs <dbl>,
#> # offense_run_rate <dbl>, offense_pace <dbl>, defense_ranking <int>,
#> # defense_rating <dbl>, defense_success <dbl>, defense_explosiveness <dbl>,
#> # defense_rushing <dbl>, defense_passing <dbl>, …
try(cfbd_ratings_sp(team = "Texas A&M"))
#> ── SP+ data from CollegeFootballData.com ───────────────────── cfbfastR 2.3.0 ──
#> ℹ Data updated: 2026-06-09 20:00:44 UTC
#> # A tibble: 112 × 29
#> year team conference rating ranking second_order_wins sos offense_ranking
#> <int> <chr> <chr> <dbl> <int> <dbl> <dbl> <int>
#> 1 1970 Texa… SEC -1.7 52 NA NA 50
#> 2 1971 Texa… SEC -3.5 54 NA NA 56
#> 3 1972 Texa… SEC 3.7 48 NA NA 53
#> 4 1973 Texa… SEC 8.9 42 NA NA 37
#> 5 1974 Texa… SEC 14.9 27 NA NA 49
#> 6 1975 Texa… SEC 19.1 17 NA NA 44
#> 7 1976 Texa… SEC 20.8 10 NA NA 23
#> 8 1977 Texa… SEC 11.8 34 NA NA 11
#> 9 1978 Texa… SEC 8.2 43 NA NA 45
#> 10 1979 Texa… SEC 21.4 7 NA NA 39
#> # ℹ 102 more rows
#> # ℹ 21 more variables: offense_rating <dbl>, offense_success <dbl>,
#> # offense_explosiveness <dbl>, offense_rushing <dbl>, offense_passing <dbl>,
#> # offense_standard_downs <dbl>, offense_passing_downs <dbl>,
#> # offense_run_rate <dbl>, offense_pace <dbl>, defense_ranking <int>,
#> # defense_rating <dbl>, defense_success <dbl>, defense_explosiveness <dbl>,
#> # defense_rushing <dbl>, defense_passing <dbl>, …
try(cfbd_ratings_sp(year = 2019, team = "Texas"))
#> ── SP+ data from CollegeFootballData.com ───────────────────── cfbfastR 2.3.0 ──
#> ℹ Data updated: 2026-06-09 20:00:44 UTC
#> # A tibble: 2 × 29
#> year team conference rating ranking second_order_wins sos offense_ranking
#> <int> <chr> <chr> <dbl> <int> <lgl> <lgl> <int>
#> 1 2019 Texas SEC 12 1 NA NA 1
#> 2 2019 natio… NA 0.760 NA NA NA NA
#> # ℹ 21 more variables: offense_rating <dbl>, offense_success <lgl>,
#> # offense_explosiveness <lgl>, offense_rushing <lgl>, offense_passing <lgl>,
#> # offense_standard_downs <lgl>, offense_passing_downs <lgl>,
#> # offense_run_rate <lgl>, offense_pace <lgl>, defense_ranking <int>,
#> # defense_rating <dbl>, defense_success <lgl>, defense_explosiveness <lgl>,
#> # defense_rushing <lgl>, defense_passing <lgl>, defense_standard_downs <lgl>,
#> # defense_passing_downs <lgl>, defense_havoc_total <lgl>, …
# }