{
 "product_version": "0.5",
 "coverage": "NFL regular season 2016-2025, weeks 5 onward (2016-2020 through week 17, 2021-2025 through week 18)",
 "as_of_rule": "State entering week W: the team's form over up to its last 6 games played before week W (fewer early in a season). The week W game itself is never included in any field.",
 "percentile_rule": "Percentile = share of the comparison set at or below this team's value after orienting so that 1.0 is best (direction -1 flips the sign; direction 0 is left unoriented). pct_week compares the 32 teams entering that week (teams without a game that week included). pct_pooled compares every team-week 2016-2025.",
 "seasons": [
  2016,
  2017,
  2018,
  2019,
  2020,
  2021,
  2022,
  2023,
  2024,
  2025
 ],
 "week_range": {
  "2016": [
   5,
   17
  ],
  "2017": [
   5,
   17
  ],
  "2018": [
   5,
   17
  ],
  "2019": [
   5,
   17
  ],
  "2020": [
   5,
   17
  ],
  "2021": [
   5,
   18
  ],
  "2022": [
   5,
   18
  ],
  "2023": [
   5,
   18
  ],
  "2024": [
   5,
   18
  ],
  "2025": [
   5,
   18
  ]
 },
 "teams": [
  "ARI",
  "ATL",
  "BAL",
  "BUF",
  "CAR",
  "CHI",
  "CIN",
  "CLE",
  "DAL",
  "DEN",
  "DET",
  "GNB",
  "HOU",
  "IND",
  "JAX",
  "KAN",
  "LAC",
  "LAR",
  "LVR",
  "MIA",
  "MIN",
  "NOR",
  "NWE",
  "NYG",
  "NYJ",
  "PHI",
  "PIT",
  "SEA",
  "SFO",
  "TAM",
  "TEN",
  "WAS"
 ],
 "input_spellings": {
  "GB": "GNB",
  "KC": "KAN",
  "LV": "LVR",
  "NO": "NOR",
  "NE": "NWE",
  "SF": "SFO",
  "TB": "TAM",
  "LA": "LAR",
  "OAK": "LVR",
  "SD": "LAC"
 },
 "groups": {
  "pass": "pass offense / defense, per pass play (attempt + sack)",
  "rush": "rush offense / defense, per rush play",
  "sit": "3rd down, red zone, drive start field position, FG",
  "gs": "share of game time by score state",
  "pen": "penalties per game",
  "td": "touchdowns per drive, offense / defense",
  "bal": "pass share"
 },
 "attributes": [
  {
   "name": "pass_off_yds_play",
   "group": "pass",
   "direction": 1,
   "definition": "yards per pass play (incompletions 0, sacks negative)"
  },
  {
   "name": "pass_def_yds_play",
   "group": "pass",
   "direction": -1,
   "definition": "yards allowed per pass play"
  },
  {
   "name": "pass_off_expl_rate",
   "group": "pass",
   "direction": 1,
   "definition": "share of pass plays gaining 20+ yards"
  },
  {
   "name": "pass_def_expl_rate",
   "group": "pass",
   "direction": -1,
   "definition": "share of pass plays allowed gaining 20+ yards"
  },
  {
   "name": "pass_off_sack_rate",
   "group": "pass",
   "direction": -1,
   "definition": "sacks taken per pass play"
  },
  {
   "name": "pass_def_sack_rate",
   "group": "pass",
   "direction": 1,
   "definition": "sacks made per pass play"
  },
  {
   "name": "pass_off_td_rate",
   "group": "pass",
   "direction": 1,
   "definition": "passing TDs per pass play"
  },
  {
   "name": "pass_def_td_rate",
   "group": "pass",
   "direction": -1,
   "definition": "passing TDs allowed per pass play"
  },
  {
   "name": "pass_off_int_rate",
   "group": "pass",
   "direction": -1,
   "definition": "interceptions thrown per pass play"
  },
  {
   "name": "pass_def_int_rate",
   "group": "pass",
   "direction": 1,
   "definition": "interceptions made per pass play"
  },
  {
   "name": "rush_off_yds_play",
   "group": "rush",
   "direction": 1,
   "definition": "yards per rush play"
  },
  {
   "name": "rush_def_yds_play",
   "group": "rush",
   "direction": -1,
   "definition": "yards allowed per rush play"
  },
  {
   "name": "rush_off_expl_rate",
   "group": "rush",
   "direction": 1,
   "definition": "share of rushes gaining 10+ yards"
  },
  {
   "name": "rush_def_expl_rate",
   "group": "rush",
   "direction": -1,
   "definition": "share of rushes allowed gaining 10+ yards"
  },
  {
   "name": "rush_off_td_rate",
   "group": "rush",
   "direction": 1,
   "definition": "rushing TDs per rush play"
  },
  {
   "name": "rush_def_td_rate",
   "group": "rush",
   "direction": -1,
   "definition": "rushing TDs allowed per rush play"
  },
  {
   "name": "rush_off_fum_rate",
   "group": "rush",
   "direction": -1,
   "definition": "fumbles (occurrence, not lost) per rush play"
  },
  {
   "name": "rush_def_fum_rate",
   "group": "rush",
   "direction": 1,
   "definition": "fumbles forced per rush play"
  },
  {
   "name": "sit_td3_off",
   "group": "sit",
   "direction": 1,
   "definition": "3rd-down conversion rate"
  },
  {
   "name": "sit_td3_def",
   "group": "sit",
   "direction": -1,
   "definition": "3rd-down conversion rate allowed"
  },
  {
   "name": "sit_rz_off",
   "group": "sit",
   "direction": 1,
   "definition": "red-zone TD rate (drives reaching the 20 that end in an offensive TD)"
  },
  {
   "name": "sit_rz_def",
   "group": "sit",
   "direction": -1,
   "definition": "red-zone TD rate allowed"
  },
  {
   "name": "sit_fp_own",
   "group": "sit",
   "direction": -1,
   "definition": "average own drive start, yards from the opponent goal (lower = closer)"
  },
  {
   "name": "sit_fp_forced",
   "group": "sit",
   "direction": 1,
   "definition": "average opponent drive start, yards from the goal they attack (higher = farther away)"
  },
  {
   "name": "sit_fg",
   "group": "sit",
   "direction": 1,
   "definition": "field-goal make rate"
  },
  {
   "name": "gs_trail_9plus",
   "group": "gs",
   "direction": -1,
   "definition": "share of game time trailing by 9 or more"
  },
  {
   "name": "gs_trail_4_8",
   "group": "gs",
   "direction": -1,
   "definition": "share of game time trailing by 4 to 8"
  },
  {
   "name": "gs_trail_1_3",
   "group": "gs",
   "direction": -1,
   "definition": "share of game time trailing by 1 to 3"
  },
  {
   "name": "gs_tied",
   "group": "gs",
   "direction": 0,
   "definition": "share of game time tied"
  },
  {
   "name": "gs_lead_1_3",
   "group": "gs",
   "direction": 1,
   "definition": "share of game time leading by 1 to 3"
  },
  {
   "name": "gs_lead_4_8",
   "group": "gs",
   "direction": 1,
   "definition": "share of game time leading by 4 to 8"
  },
  {
   "name": "gs_lead_9plus",
   "group": "gs",
   "direction": 1,
   "definition": "share of game time leading by 9 or more"
  },
  {
   "name": "pen_total_g",
   "group": "pen",
   "direction": -1,
   "definition": "penalties per game"
  },
  {
   "name": "td_off_q1",
   "group": "td",
   "direction": 1,
   "definition": "offensive TDs per drive, drives starting in the 1st quarter"
  },
  {
   "name": "td_off_q2",
   "group": "td",
   "direction": 1,
   "definition": "offensive TDs per drive, drives starting in the 2nd quarter"
  },
  {
   "name": "td_off_q3",
   "group": "td",
   "direction": 1,
   "definition": "offensive TDs per drive, drives starting in the 3rd quarter"
  },
  {
   "name": "td_off_q4",
   "group": "td",
   "direction": 1,
   "definition": "offensive TDs per drive, drives starting in the 4th quarter"
  },
  {
   "name": "td_off_all",
   "group": "td",
   "direction": 1,
   "definition": "offensive TDs per drive, all regulation drives"
  },
  {
   "name": "td_def_q1",
   "group": "td",
   "direction": -1,
   "definition": "TDs allowed per drive, drives starting in the 1st quarter"
  },
  {
   "name": "td_def_q2",
   "group": "td",
   "direction": -1,
   "definition": "TDs allowed per drive, drives starting in the 2nd quarter"
  },
  {
   "name": "td_def_q3",
   "group": "td",
   "direction": -1,
   "definition": "TDs allowed per drive, drives starting in the 3rd quarter"
  },
  {
   "name": "td_def_q4",
   "group": "td",
   "direction": -1,
   "definition": "TDs allowed per drive, drives starting in the 4th quarter"
  },
  {
   "name": "td_def_all",
   "group": "td",
   "direction": -1,
   "definition": "TDs allowed per drive, all regulation drives"
  },
  {
   "name": "bal_pass_rate",
   "group": "bal",
   "direction": 0,
   "definition": "pass share of all offensive plays"
  }
 ],
 "counts": [
  {
   "name": "pass_n_off",
   "group": "pass",
   "kind": "count",
   "definition": "pass plays in the window, offense"
  },
  {
   "name": "pass_n_def",
   "group": "pass",
   "kind": "count",
   "definition": "pass plays in the window, defense"
  },
  {
   "name": "rush_n_off",
   "group": "rush",
   "kind": "count",
   "definition": "rush plays in the window, offense"
  },
  {
   "name": "rush_n_def",
   "group": "rush",
   "kind": "count",
   "definition": "rush plays in the window, defense"
  },
  {
   "name": "td_n_off",
   "group": "td",
   "kind": "count",
   "definition": "regulation drives in the window, offense"
  },
  {
   "name": "td_n_def",
   "group": "td",
   "kind": "count",
   "definition": "regulation drives in the window, defense"
  },
  {
   "name": "bal_n_all",
   "group": "bal",
   "kind": "count",
   "definition": "offensive plays in the window"
  }
 ],
 "files": {
  "team_state_2016_2025.parquet": "one row per team per week: season, week, team, played_this_week, 44 attributes, 7 counts",
  "matchup_2016_2025.parquet": "one row per game: season, week, home, away, neutral_site, home_/away_ copies of the 51 state fields",
  "team_rank_2016_2025.parquet": "one row per team per week: season, week, team, then value, __pct_week, __pct_pooled for each of the 44 attributes"
 },
 "not_included": "game results"
}