Statistical categories

Andrew Gallant edited this page Sep 14, 2013 · 10 revisions

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.