calculate_player_stats: Get Official Game Stats
In mrcaseb/nflfastR: Functions to Efficiently Access NFL Play by Play Data

calculate_player_stats

R Documentation

Get Official Game Stats

Description

This function was deprecated because we have a new, much better and harmonized approach in calculate_stats().

Build columns that aggregate official passing, rushing, and receiving stats either at the game level or at the level of the entire data frame passed.

Usage

calculate_player_stats(pbp, weekly = FALSE)

Arguments

`pbp`	A Data frame of NFL play-by-play data typically loaded with `load_pbp()` or `build_nflfastR_pbp()`. If the data doesn't include the variable `qb_epa`, the function `add_qb_epa()` will be called to add it.
`weekly`	If `TRUE`, returns week-by-week stats, otherwise, stats for the entire Data frame.

Value

A data frame including the following columns (all ID columns are decoded to the gsis ID format):

player_id: ID of the player. Use this to join to other sources.
player_name: Name of the player
player_display_name: Full name of the player
position: Position of the player
position_group: Position group of the player
headshot_url: URL to a player headshot image
games: The number of games where the player recorded passing, rushing or receiving stats.
recent_team: Most recent team player appears in pbp with.
season: Season if weekly is TRUE
week: Week if weekly is TRUE
season_type: REG or POST if weekly is TRUE
opponent_team: The player's opponent team if weekly is TRUE
completions: The number of completed passes.
attempts: The number of pass attempts as defined by the NFL.
passing_yards: Yards gained on pass plays.
passing_tds: The number of passing touchdowns.
interceptions: The number of interceptions thrown.
sacks: The Number of times sacked.
sack_yards: Yards lost on sack plays.
sack_fumbles: The number of sacks with a fumble.
sack_fumbles_lost: The number of sacks with a lost fumble.
passing_air_yards: Passing air yards (includes incomplete passes).
passing_yards_after_catch: Yards after the catch gained on plays in which player was the passer (this is an unofficial stat and may differ slightly between different sources).
passing_first_downs: First downs on pass attempts.
passing_epa: Total expected points added on pass attempts and sacks. NOTE: this uses the variable qb_epa, which gives QB credit for EPA for up to the point where a receiver lost a fumble after a completed catch and makes EPA work more like passing yards on plays with fumbles.
passing_2pt_conversions: Two-point conversion passes.
pacr: Passing Air Conversion Ratio. PACR = passing_yards / passing_air_yards
dakota: Adjusted EPA + CPOE composite based on coefficients which best predict adjusted EPA/play in the following year.
carries: The number of official rush attempts (incl. scrambles and kneel downs). Rushes after a lateral reception don't count as carry.
rushing_yards: Yards gained when rushing with the ball (incl. scrambles and kneel downs). Also includes yards gained after obtaining a lateral on a play that started with a rushing attempt.
rushing_tds: The number of rushing touchdowns (incl. scrambles). Also includes touchdowns after obtaining a lateral on a play that started with a rushing attempt.
rushing_fumbles: The number of rushes with a fumble.
rushing_fumbles_lost: The number of rushes with a lost fumble.
rushing_first_downs: First downs on rush attempts (incl. scrambles).
rushing_epa: Expected points added on rush attempts (incl. scrambles and kneel downs).
rushing_2pt_conversions: Two-point conversion rushes
receptions: The number of pass receptions. Lateral receptions officially don't count as reception.
targets: The number of pass plays where the player was the targeted receiver.
receiving_yards: Yards gained after a pass reception. Includes yards gained after receiving a lateral on a play that started as a pass play.
receiving_tds: The number of touchdowns following a pass reception. Also includes touchdowns after receiving a lateral on a play that started as a pass play.
receiving_air_yards: Receiving air yards (incl. incomplete passes).
receiving_yards_after_catch: Yards after the catch gained on plays in which player was receiver (this is an unofficial stat and may differ slightly between different sources).
receiving_fumbles: The number of fumbles after a pass reception.
receiving_fumbles_lost: The number of fumbles lost after a pass reception.
receiving_2pt_conversions: Two-point conversion receptions
racr: Receiver Air Conversion Ratio. RACR = receiving_yards / receiving_air_yards
target_share: The share of targets of the player in all targets of his team
air_yards_share: The share of receiving_air_yards of the player in all air_yards of his team
wopr: Weighted Opportunity Rating. WOPR = 1.5 × target_share + 0.7 × air_yards_share
fantasy_points: Standard fantasy points.
fantasy_points_ppr: PPR fantasy points.

Examples


try({# to avoid CRAN test problems
pbp <- nflfastR::load_pbp(2020)

weekly <- calculate_player_stats(pbp, weekly = TRUE)
dplyr::glimpse(weekly)

overall <- calculate_player_stats(pbp, weekly = FALSE)
dplyr::glimpse(overall)
})

mrcaseb/nflfastR documentation built on April 14, 2025, 12:14 a.m.