cfbd_stats_game_havoc: *Get game havoc statistics*

In cfbfastR: Access College Football Play by Play Data

Get game havoc statistics

Description

Get havoc-rate statistics aggregated by game. Havoc measures defensive disruption – the share of plays that end in a tackle for loss, a forced fumble, a pass defensed, or an interception – split into front-seven and defensive-back contributions. Each row carries both the team's own defensive havoc (⁠def_*⁠) and the havoc the team's offense allowed (⁠off_*⁠) in that game.

Usage

cfbd_stats_game_havoc(
  year = NULL,
  team = NULL,
  week = NULL,
  opponent = NULL,
  season_type = NULL
)

Arguments

year	(Integer optional): Year, 4 digit format (YYYY). Required if team is not specified. Minimum value accepted: 2004
team	(String optional): D-I Team. Required if year is not specified.
week	(Integer optional): Week - values from 1-15, 1-14 for seasons pre-playoff (i.e. 2013 or earlier).
opponent	(String optional): Opponent D-I Team.
season_type	(String optional): Season type - regular, postseason, both, allstar, spring_regular, spring_postseason.

Value

cfbd_stats_game_havoc() - A data frame with 22 variables:

col_name	types	description
game_id	integer	Referencing game id.
season	integer	Season of the game.
season_type	character	Season type of the game.
week	integer	Game week of the season.
team	character	Team name.
conference	character	Conference of the team.
opponent	character	Opponent team name.
opponent_conference	character	Conference of the opponent.
off_total_plays	integer	Offense plays in the game.
off_total_havoc_events	integer	Total havoc events allowed by the offense.
off_front_seven_havoc_events	integer	Front-seven havoc events allowed by the offense.
off_db_havoc_events	integer	Defensive-back havoc events allowed by the offense.
off_havoc_rate	double	Total havoc rate allowed by the offense.
off_front_seven_havoc_rate	double	Front-seven havoc rate allowed by the offense.
off_db_havoc_rate	double	Defensive-back havoc rate allowed by the offense.
def_total_plays	integer	Defense plays in the game.
def_total_havoc_events	integer	Total havoc events created by the defense.
def_front_seven_havoc_events	integer	Front-seven havoc events created by the defense.
def_db_havoc_events	integer	Defensive-back havoc events created by the defense.
def_havoc_rate	double	Total havoc rate created by the defense.
def_front_seven_havoc_rate	double	Front-seven havoc rate created by the defense.
def_db_havoc_rate	double	Defensive-back havoc rate created by the defense.

See Also

Other CFBD Stats: cfbd_stats_categories(), cfbd_stats_game_advanced(), cfbd_stats_season_advanced(), cfbd_stats_season_player(), cfbd_stats_season_team()

Examples

   try(cfbd_stats_game_havoc(year = 2023, team = "Georgia"))

   try(cfbd_stats_game_havoc(2022, week = 1))

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