# Player stats

**Job:** `NFL: Lions player season stats` — 7:30 ET daily.
**Command:** `football_sync player_stats [--season YYYY]`

The source is nflverse's league-wide season file (`stats_player_reg_<season>.csv`,
one row per NFL player). For every player on a tracked team it writes one
`PlayerSeasonStats` row per category the player has — passing, rushing,
receiving, defense, kicking — and, because the whole league is in hand,
**`league_rank`**: the player's rank among all NFL players in that category's
headline stat (passing/rushing/receiving yards, combined tackles, kicking
points). That is the "NFL Rank #" badge on the public Stats page.

Details:

- nflverse keys players by GSIS id; `players.csv` maps that to the ESPN id this
  site uses. A tracked-team player who isn't on the current roster (a past
  season, a mid-season departure) is created as a non-roster `Player` so the
  history is complete.
- Passer rating, yards per carry/reception and field-goal percentage are
  computed; combined tackles are solo + assists.
- When nflverse has no file for the season yet, ESPN's per-player splits are
  used instead (no ranks).

Run `rosters` first for the current season so the roster names match.

