{"schema":"draftadynasty.nfl-visual-lenses/v1","updatedAt":"2026-09-26","governingIssue":"JalenBuildsHub/sleeper-dynasty#293","purpose":"Versioned football visualization definitions. Definitions are not measured results, forecasts, rankings, or recommendations.","productionInfluence":false,"publicationRequires":"exact frozen dataset receipt with source, cutoff, identity, units, denominator, sample and rights evidence","lenses":[{"id":"rb-rush-attempts-vs-target-share","title":"RB rushing workload vs passing involvement","entity":"player","positions":["RB"],"question":"Who combines rushing workload with passing involvement?","mechanism":"Carries measure ground workload; target share measures pass-game involvement.","evidenceState":"descriptive","dataState":"planned","x":{"key":"rush_attempts","label":"Rush attempts","unit":"attempts","metricRef":null},"y":{"key":"target_share","label":"Target share","unit":"percent","metricRef":null},"sample":{"minimum":10,"unit":"rush_attempts","rule":"Declare target-share denominator; denominator must be nonzero."},"sourceRefs":["nflverse"],"artifactState":"definition_only","productionInfluence":false,"governingWork":["#293","#286"]},{"id":"wr-routes-vs-targets-per-route","title":"WR route opportunity vs target earning","entity":"player","positions":["WR"],"question":"Who is running routes and earning targets on them?","mechanism":"Routes measure participation; targets per route measures conditional demand.","evidenceState":"hypothesis","dataState":"research_only","x":{"key":"routes_run","label":"Routes run","unit":"routes","metricRef":null},"y":{"key":"targets_per_route","label":"Targets per route run","unit":"rate","metricRef":"targets-per-route"},"sample":{"minimum":20,"unit":"routes","rule":"At least 20 charted routes."},"sourceRefs":["nflverse"],"artifactState":"definition_only","productionInfluence":false,"governingWork":["#293","#286"]},{"id":"te-routes-vs-targets-per-route","title":"TE route opportunity vs target earning","entity":"player","positions":["TE"],"question":"Who pairs receiving opportunity with target earning?","mechanism":"Routes separate receiving participation from target earning.","evidenceState":"hypothesis","dataState":"research_only","x":{"key":"routes_run","label":"Routes run","unit":"routes","metricRef":null},"y":{"key":"targets_per_route","label":"Targets per route run","unit":"rate","metricRef":"targets-per-route"},"sample":{"minimum":15,"unit":"routes","rule":"At least 15 charted routes."},"sourceRefs":["nflverse"],"artifactState":"definition_only","productionInfluence":false,"governingWork":["#293","#286"]},{"id":"qb-pass-attempts-vs-rush-attempts","title":"QB passing volume vs rushing involvement","entity":"player","positions":["QB"],"question":"Who combines passing opportunity with rushing involvement?","mechanism":"Pass and rush attempts expose two opportunity channels without touchdown efficiency.","evidenceState":"descriptive","dataState":"planned","x":{"key":"pass_attempts","label":"Pass attempts","unit":"attempts","metricRef":null},"y":{"key":"rush_attempts","label":"Rush attempts","unit":"attempts","metricRef":null},"sample":{"minimum":20,"unit":"pass_attempts","rule":"Declare consistent scramble and kneel treatment."},"sourceRefs":["nflverse"],"artifactState":"definition_only","productionInfluence":false,"governingWork":["#293","#286"]},{"id":"qb-pressure-rate-vs-pressure-to-sack","title":"QB pressure exposure vs sack conversion","entity":"player","positions":["QB"],"question":"Who faces pressure, and who turns pressure into sacks?","mechanism":"Separates protection/environment from sack conversion under pressure.","evidenceState":"hypothesis","dataState":"research_only","x":{"key":"pressure_rate","label":"Pressure rate","unit":"percent","metricRef":null},"y":{"key":"pressure_to_sack_rate","label":"Pressure-to-sack rate","unit":"percent","metricRef":"pressure-to-sack"},"sample":{"minimum":10,"unit":"pressured_dropbacks","rule":"At least 10 charted pressured dropbacks."},"sourceRefs":["nflverse"],"artifactState":"definition_only","productionInfluence":false,"governingWork":["#293","#286"]},{"id":"team-epa-vs-success-rate","title":"Team efficiency vs consistency","entity":"team","positions":[],"question":"Which offenses create value consistently?","mechanism":"EPA/play measures average situational value; success rate measures positive-play frequency.","evidenceState":"descriptive","dataState":"planned","x":{"key":"epa_per_play","label":"EPA per play","unit":"expected_points","metricRef":"epa-per-play"},"y":{"key":"success_rate","label":"Success rate","unit":"percent","metricRef":"success-rate"},"sample":{"minimum":40,"unit":"offensive_plays","rule":"At least 40 plays under one declared filter."},"sourceRefs":["nflverse"],"artifactState":"definition_only","productionInfluence":false,"governingWork":["#293","#286"]},{"id":"team-neutral-proe-vs-pace","title":"Team passing tendency vs pace","entity":"team","positions":[],"question":"Which offenses create pass volume through tendency and pace?","mechanism":"Neutral PROE measures pass tendency; pace measures opportunity creation.","evidenceState":"hypothesis","dataState":"research_only","x":{"key":"neutral_proe","label":"Neutral pass rate over expected","unit":"percentage_points","metricRef":"neutral-proe"},"y":{"key":"seconds_per_play","label":"Seconds per play","unit":"seconds","metricRef":null},"sample":{"minimum":30,"unit":"neutral_plays","rule":"Declare neutral-state and clock filters."},"sourceRefs":["nflverse"],"artifactState":"definition_only","productionInfluence":false,"governingWork":["#293","#286"]},{"id":"defense-pressure-vs-explosives","title":"Defense pressure vs explosive-pass prevention","entity":"team","positions":[],"question":"Which defenses pressure without allowing explosives?","mechanism":"Pressure measures disruption; explosive rate measures downside exposure.","evidenceState":"hypothesis","dataState":"research_only","x":{"key":"pressure_rate","label":"Pressure rate","unit":"percent","metricRef":null},"y":{"key":"explosive_pass_rate_allowed","label":"Explosive pass rate allowed","unit":"percent","metricRef":null},"sample":{"minimum":30,"unit":"opponent_dropbacks","rule":"Declare pressure charting and explosive threshold."},"sourceRefs":["nflverse"],"artifactState":"definition_only","productionInfluence":false,"governingWork":["#293","#286"]},{"id":"receiver-target-share-vs-air-yard-share","title":"Receiver target share vs air-yard share","entity":"player","positions":["WR","TE"],"question":"Who commands both volume and downfield opportunity?","mechanism":"Target share measures selection frequency; air-yard share measures intended depth allocation.","evidenceState":"hypothesis","dataState":"research_only","x":{"key":"target_share","label":"Target share","unit":"percent","metricRef":null},"y":{"key":"air_yard_share","label":"Air-yard share","unit":"percent","metricRef":null},"sample":{"minimum":10,"unit":"targets","rule":"At least 10 targets and a positive team air-yard denominator."},"sourceRefs":["nflverse"],"artifactState":"definition_only","productionInfluence":false,"governingWork":["#293","#286"]},{"id":"rb-carries-vs-inside-10","title":"RB carries vs inside-10 opportunities","entity":"player","positions":["RB"],"question":"Who combines broad workload with high-leverage scoring opportunities?","mechanism":"Carries measure workload; inside-10 opportunities isolate high-leverage usage.","evidenceState":"hypothesis","dataState":"research_only","x":{"key":"rush_attempts","label":"Rush attempts","unit":"attempts","metricRef":null},"y":{"key":"inside_10_opportunities","label":"Inside-10 opportunities","unit":"opportunities","metricRef":null},"sample":{"minimum":10,"unit":"rush_attempts","rule":"Declare whether receiving opportunities use targets or receptions."},"sourceRefs":["nflverse"],"artifactState":"definition_only","productionInfluence":false,"governingWork":["#293","#286"]},{"id":"wr-first-read-share-vs-ppr","title":"WR first-read role vs fantasy production","entity":"player","positions":["WR"],"question":"Does scoring match the receiver's charted first-read role?","mechanism":"First-read share describes a charted role; PPR per game describes results. A mismatch is a research question, not a regression forecast.","evidenceState":"hypothesis","dataState":"rights_blocked","x":{"key":"first_read_target_share","label":"First-read target share","unit":"percent","metricRef":"first-read-target-share"},"y":{"key":"ppr_points_per_game","label":"PPR points per game","unit":"points_per_game","metricRef":null},"sample":{"minimum":30,"unit":"charted_team_first_read_targets","rule":"At least 30 charted team first-read targets and two completed games; declare all-team or on-player-route denominator, charting definition and scoring. This display floor is not a reliability threshold."},"sourceRefs":["fantasy_points_data","nflverse"],"artifactState":"definition_only","productionInfluence":false,"governingWork":["#293","#114","#139","#286"]},{"id":"rb-ryoe-vs-rush-td-rate","title":"RB rushing performance vs touchdown rate","entity":"player","positions":["RB"],"question":"Are rushing results and touchdown conversion telling different stories?","mechanism":"Tracking-model RYOE per carry and rushing touchdown rate describe different components. Goal-line role and explosive plays must be reviewed before a sustainability claim.","evidenceState":"hypothesis","dataState":"research_only","x":{"key":"ryoe_per_carry","label":"Rushing yards over expected per carry","unit":"yards_per_carry","metricRef":"ryoe"},"y":{"key":"rush_td_rate","label":"Rushing touchdowns per carry","unit":"percent","metricRef":null},"sample":{"minimum":20,"unit":"modeled_rush_attempts","rule":"At least 20 modeled carries and two completed games; retain modeled and TD-rate denominators separately. Never mix NGS week-0 summaries with weekly rows. This display floor is not a reliability threshold."},"sourceRefs":["nfl_ngs","nflverse"],"artifactState":"definition_only","productionInfluence":false,"governingWork":["#293","#114","#139","#286"]},{"id":"qb-cpoe-vs-pass-td-rate","title":"QB completion performance vs touchdown rate","entity":"player","positions":["QB"],"question":"Do completion execution and touchdown production support the same interpretation?","mechanism":"CPOE is source-model-relative completion execution, not pure QB skill or a forecast. Keep nflverse and NGS models separate and review depth, pressure, receivers and red-zone opportunities.","evidenceState":"hypothesis","dataState":"research_only","x":{"key":"cpoe","label":"Completion percentage over expected","unit":"percentage_points","metricRef":"cpoe"},"y":{"key":"pass_td_rate","label":"Passing touchdowns per attempt","unit":"percent","metricRef":null},"sample":{"minimum":40,"unit":"cpoe_eligible_attempts","rule":"At least 40 valid CPOE attempts and two completed games; report missing CPOE attempts and the separate passing-TD denominator. This display floor is not a reliability threshold."},"sourceRefs":["nfl_ngs","nflverse"],"artifactState":"definition_only","productionInfluence":false,"governingWork":["#293","#114","#139","#286"]}],"summary":{"lensCount":13,"playerLensCount":10,"teamLensCount":3,"evidenceStates":{"descriptive":3,"hypothesis":10,"validated":0},"dataStates":{"available":0,"planned":3,"researchOnly":9,"rightsBlocked":1}},"authority":{"readOnly":true,"canChangeRankings":false,"canPromoteModels":false,"canPublish":false,"canChangeProviders":false},"usage":{"purpose":"Discover DraftADynasty's governed NFL visualization questions, axis definitions, sample rules, evidence state and data readiness.","humanPage":"/football/lab","pollAfterSeconds":3600}}