Docs
Progressive Pass
Progressive Pass
Rewarding Game-Changing Ball Movement
The Progressive Pass System
is designed to identify and reward passes that significantly advance the ball down the field. By recognizing key moments in ball progression, this system highlights the contributions of players who help their team move closer to scoring opportunities.
What Is a Progressive Pass?
A progressive pass is a completed pass that:
- Covers a significant distance (greater than
13.3 yards
). - Ends in an advantageous field position (beyond the halfway line or a relative improvement compared to previous passes).
- Meets all other completion criteria.
Key Concepts of the Progressive Pass System
Pass Length
The distance covered by the pass is calculated as:
- If the
passLength
is greater than the Progressive Pass Threshold (13.3 yards), it qualifies as a candidate for being progressive.
Pass Completion
A pass must have an outcome
of "complete"
to be considered progressive. Incomplete passes are excluded from evaluation.
End Location
To qualify as a progressive pass, the pass must end in a meaningful offensive position:
- Absolute Rule: The pass ends in a location where
end_x > 60
. - Relative Rule: If there are previous passes in the possession, the pass must end at least
13.3 yards
further downfield than the furthestend_x
of prior passes.
How It Works
Pass Evaluation Logic
Step 1: Initial Check
- If the
player_id
,end_x
, oroutcome
of the pass is invalid, the pass is ignored.
Step 2: Progressive Pass Criteria
The system evaluates whether the pass qualifies as progressive based on:
- Pass Length: The pass must cover a distance greater than
13.3 yards
. - Completion: The pass must have an
outcome
of"complete"
. - End Location:
- For the first pass in a possession,
end_x > 60
. - For subsequent passes,
end_x
must exceed the furthest previousend_x
by at least13.3 yards
.
- For the first pass in a possession,
Step 3: Logging and Feedback
- Detailed debug logs are generated to track pass evaluation, including:
- Pass length.
- Comparison with prior passes in the possession.
- Whether the pass satisfies progressive pass criteria.
Step 4: Assign Reward
- If the pass qualifies as progressive, it is rewarded with the
ProgressivePass
type. If not, no reward is assigned.