Skip to content

ahump20/football

v1.0.1MIT

Football fundamentals for the NFL and college: rules, EPA and success rate from nflverse and sportsdataverse play-by-play, quarterback evaluation, passer rating and NCAA efficiency, and free data sources.

football-analytics

Measure and interpret football efficiency correctly — EPA per play, success rate, CPOE, passer rating, NCAA passing efficiency, early-down passing, garbage time, and why yards and points mislead — using nflverse play-by-play for the NFL and sportsdataverse play-by-play for college. Use when ranking offenses or defenses, evaluating a quarterback, explaining why a team's record and its efficiency disagree, or computing a passer rating.

football-data

Pull NFL and college football data from free sources — nflverse play-by-play, weekly player stats, schedules with scores and betting lines, rosters and player ids; sportsdataverse college play-by-play, box scores and opponent-adjusted ratings; College Football Data for rankings, recruiting and the transfer portal — with exact URLs, column meanings, sign conventions and limits. Use when you need real football numbers, are joining data across sources, or are building a pipeline.

football-rules

Answers American football rules questions correctly for the NFL and NCAA FBS, keeping the two codes and their season-by-season changes apart — catch rule, down by contact, overtime, clock and two-minute rules, kickoff and touchback spots, onside kicks, pass interference, intentional grounding, targeting, fumble rules, safeties and touchbacks, untimed downs, replay challenges, tush push, NFL vs college differences, and passer rating vs NCAA passing efficiency. Use when explaining a call, settling a rules dispute, scoring a play, or reading sack and passing stats.