Statistical categories

The following is a list of statistical categories available on nfldb instances of the Play and PlayPlayer classes.

They are listed here to prevent them from cluttering the API documentation. Note that this list complements the instance variables in the API documentation.

Note to contributors: Do not edit this page manually. It is automatically generated by the nfldb-mk-stat-table script.

Play statistics

Field	Description
first_down	A first down or TD occurred due to a penalty. A play can have a first down from a pass or rush and from a penalty.
fourth_down_att	4th down play.
fourth_down_conv	4th down play resulted in a first down or touchdown.
fourth_down_failed	4th down play did not result in a first down or touchdown.
passing_first_down	A first down or TD occurred due to a pass.
penalty	A penalty occurred.
penalty_first_down	A first down or TD occurred due to a penalty.
penalty_yds	The number of yards gained or lost from a penalty.
rushing_first_down	A first down or TD occurred due to a rush.
third_down_att	3rd down play.
third_down_conv	3rd down play resulted in a first down or touchdown.
third_down_failed	3rd down play did not result in a first down or touchdown.
timeout	Team took a time out.
xp_aborted	The extra point was aborted.

Player statistics

Field	Description
defense_ast	Assist to a tackle.
defense_ffum	Defensive player forced a fumble.
defense_fgblk	Defensive player blocked a field goal.
defense_frec	Defensive player recovered a fumble by the opposing team.
defense_frec_tds	Defensive player scored a touchdown after recovering a fumble by the opposing team.
defense_frec_yds	Yards gained by a defensive player after recovering a fumble by the opposing team.
defense_int	An interception.
defense_int_tds	A touchdown scored after an interception.
defense_int_yds	Yards gained after an interception.
defense_misc_tds	A touchdown scored on miscellaneous yardage (e.g., on a missed field goal or a blocked punt).
defense_misc_yds	Miscellaneous yards gained by a defensive player (e.g., yardage on a missed field goal or blocked punt).
defense_pass_def	Incomplete pass was due primarily to a defensive player's action.
defense_puntblk	Defensive player blocked a punt.
defense_qbhit	Defensive player knocked the quarterback to the ground and the quarterback was not the ball carrier.
defense_safe	Tackle by a defensive player that resulted in a safety. This is in addition to a tackle.
defense_sk	Defensive player sacked the quarterback. Note that this is the only field that is a floating point number. Namely, there can be half-credit sacks.
defense_sk_yds	Yards lost as a result of a sack.
defense_tkl	A defensive player tackle. (This include defense_tkl_primary.)
defense_tkl_loss	Defensive player tackled the runner behind the line of scrimmage. Play must have ended, player must have received a tackle stat, has to be an offensive player tackled.
defense_tkl_loss_yds	The number of yards lost caused by a defensive tackle behind the line of scrimmage.
defense_tkl_primary	Defensive player was the primary tackler.
defense_xpblk	Defensive player blocked the extra point.
fumbles_forced	Player fumbled the ball, fumble was forced by another player.
fumbles_lost	Player fumbled the ball and the opposing team recovered it.
fumbles_notforced	Player fumbled the ball that was not caused by a defensive player.
fumbles_oob	Player fumbled the ball, and the ball went out of bounds.
fumbles_rec	Fumble recovery from a player on the same team.
fumbles_rec_tds	A touchdown after a fumble recovery from a player on the same team.
fumbles_rec_yds	Yards gained after a fumble recovery from a player on the same team.
fumbles_tot	Total number of fumbles by a player. Includes forced, not forced and out-of-bounds.
kicking_all_yds	Kickoff and length of kick. Includes end zone yards for all kicks into the end zone, including kickoffs ending in a touchback.
kicking_downed	A downed kickoff. A kickoff is downed when touched by an offensive player within the 10 yard free zone, and the ball is awarded to the receivers at the spot of the touch.
kicking_fga	A field goal attempt, including blocked field goals. Unlike a punt, a field goal is statistically blocked even if the ball does go beyond the line of scrimmage.
kicking_fgb	Field goal was blocked. Unlike a punt, a field goal is statistically blocked even if the ball does go beyond the line of scrimmage.
kicking_fgm	A field goal.
kicking_fgm_yds	The length of a successful field goal.
kicking_fgmissed	The field goal was unsuccessful, including blocked field goals. Unlike a punt, a field goal is statistically blocked even if the ball does go beyond the line of scrimmage.
kicking_fgmissed_yds	The length of an unsuccessful field goal, including blocked field goals. Unlike a punt, a field goal is statistically blocked even if the ball does go beyond the line of scrimmage.
kicking_i20	Kickoff and length of kick, where return ended inside opponent's 20 yard line.
kicking_rec	Recovery of own kickoff, whether or not the kickoff is onside.
kicking_rec_tds	Touchdown resulting from direct recovery in endzone of own kickoff, whether or not the kickoff is onside.
kicking_tot	A kickoff.
kicking_touchback	A kickoff that resulted in a touchback.
kicking_xpa	An extra point attempt.
kicking_xpb	Extra point was blocked.
kicking_xpmade	Extra point good.
kicking_xpmissed	Extra point missed. This includes blocked extra points.
kicking_yds	The length of a kickoff.
kickret_fair	A fair catch kickoff return.
kickret_oob	Kicked ball went out of bounds.
kickret_ret	A kickoff return.
kickret_tds	A kickoff return touchdown.
kickret_touchback	A kickoff return that resulted in a touchback.
kickret_yds	Yards gained by a kickoff return.
passing_att	A pass attempt.
passing_cmp	A pass completion.
passing_cmp_air_yds	Length of a pass, not including the yards gained by the receiver after the catch.
passing_incmp	Pass was incomplete.
passing_incmp_air_yds	Length of the pass, if it would have been a completion.
passing_int	Pass attempt that resulted in an interception.
passing_sk	The player was sacked.
passing_sk_yds	The yards lost by a player that was sacked.
passing_tds	A pass completion that resulted in a touchdown.
passing_twopta	A passing two-point conversion attempt.
passing_twoptm	A successful passing two-point conversion.
passing_twoptmissed	An unsuccessful passing two-point conversion.
passing_yds	Total yards resulting from a pass completion.
punting_blk	Punt was blocked. A blocked punt is a punt that is touched behind the line of scrimmage, and is recovered, or goes out of bounds, behind the line of scrimmage. If the impetus of the punt takes it beyond the line of scrimmage, it is not a blocked punt.
punting_i20	A punt where the punt return ended inside the opponent's 20 yard line.
punting_tot	A punt.
punting_touchback	A punt that results in a touchback.
punting_yds	The length of a punt.
puntret_downed	Punt return where the ball was downed by kicking team.
puntret_fair	Punt return resulted in a fair catch.
puntret_oob	Punt went out of bounds.
puntret_tds	A punt return touchdown.
puntret_tot	A punt return.
puntret_touchback	A punt return that resulted in a touchback.
puntret_yds	Yards gained by a punt return.
receiving_rec	A reception.
receiving_tar	Player was the target of a pass attempt.
receiving_tds	A reception that results in a touchdown.
receiving_twopta	A receiving two-point conversion attempt.
receiving_twoptm	A successful receiving two-point conversion.
receiving_twoptmissed	An unsuccessful receiving two-point conversion.
receiving_yac_yds	Yardage from where the ball was caught until the player's action was over.
receiving_yds	Yards resulting from a reception.
rushing_att	A rushing attempt.
rushing_loss	Ball carrier was tackled for a loss behind the line of scrimmage, where at least one defensive player is credited with ending the rush with a tackle, or tackle assist.
rushing_loss_yds	Yards lost from the ball carrier being tackled for a loss behind the line of scrimmage, where at least one defensive player is credited with ending the rush with a tackle, or tackle assist.
rushing_tds	A touchdown resulting from a rush attempt.
rushing_twopta	A rushing two-point conversion attempt.
rushing_twoptm	A successful rushing two-point conversion.
rushing_twoptmissed	An unsuccessful rushing two-point conversion.
rushing_yds	Yards resulting from a rush.

The following fields are derived statistics computed from a combination of some of the fields above. They may be used just like regular fields in searching and sorting criteria.

Field	Description
offense_yds	Corresponds to any yardage that is manufactured by the offense. Namely, the following fields: nfldb.PlayPlayer.passing_yds, nfldb.PlayPlayer.rushing_yds, nfldb.PlayPlayer.receiving_yds and nfldb.PlayPlayer.fumbles_rec_yds. This field is useful when searching for plays by net yardage regardless of how the yards were obtained.
offense_tds	Corresponds to any touchdown manufactured by the offense via a passing, reception, rush or fumble recovery.
defense_tds	Corresponds to any touchdown manufactured by the defense. e.g., a pick-6, fumble recovery TD, punt/FG block TD, etc.