cfbd_ratings_sp: *Get SP historical rating data*

In cfbfastR: Access College Football Play by Play Data

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

year	(Integer optional): Year, 4 digit format (YYYY). Required if team not provided Minimum value accepted: 1970
team	(String optional): D-I Team. Required if year not provided

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

  try(cfbd_ratings_sp(year = 2018))

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

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

cfbfastR documentation built on Aug. 24, 2026, 5:13 p.m.