xshot-occurrence-position-only-v1

xShotOccurrence v1 (sc_extended_position_only) — Shot Propensity for Velocity-less Frames

Read this first. This repo serves the sc_extended_position_only (owner-tier, position-only) variant — the owner-tier xShot model with velocity features dropped, for scoring velocity-less snapshots such as StatsBomb-360 freeze-frames. It is NOT bundled with the wheel (restricted owner-tier training data — a licensing constraint). If you do not have owner-tier access, use the bundled position_only variant. Reachable ONLY via from_variant("sc_extended_position_only"); asking for sc_extended returns the faithful (velocity-bearing) model (ADR-070).

Model Description

XShotOccurrenceModel (position-only) estimates P(a shot is attempted by the in-possession team within ~1 s of a tracking frame) using position-only features — the 5 velocity-derived features are dropped (not NaN-filled), so the model scores frames that carry no per-player velocity at all (e.g. a single freeze-frame).

• 26 features (position_only), goal-relative coordinates via the shared _geometry helper
• Domain filter: alive-ball, attacking third
• Trained on 964,264 rows / 12,884 positives (1.34% positive rate) — same owner-tier corpus as the faithful sc_extended variant

Re-fit 2026-10-18 (ADR-126 + ADR-120). The prior artifact (1ce63ef, 18.9%, PR-AUC 0.528) was defective — a bypassed type_name guard counted any action as a shot. Re-fit on the corrected type_id label (1.34%) + corrected velocities; PR-AUC 0.528 → 0.115 because the old number measured the wrong label.

When to use this vs the bundled position_only

Use this when your frames genuinely lack velocity. For velocity-bearing tracking, prefer the faithful sc_extended model (silly-kicks/xshot-occurrence-v1) — velocity features carry real signal.

Why this variant is HF-only

HF-only for licensing, not quality: trained on restricted owner-tier SkillCorner data that cannot be redistributed in the wheel (ADR-038). Only learned parameters are published — no raw provider tracking data. Produced by a two-provider (IDSSE + SkillCorner) single-candidate run; the corpus is the owner-tier tier. training_commit: 4095251.

Held-out CV (5 folds, out-of-fold)

All four acceptance gates pass. Estimates are CV, not the shipped fit. As expected, dropping velocity costs some discrimination vs the faithful model (PR-AUC 0.124 → 0.115) — the trade is that this model runs at all on velocity-less frames.

Usage

from silly_kicks.tracking import XShotOccurrenceModel

model = XShotOccurrenceModel.from_variant("sc_extended_position_only")  # this repo, Hub download

Requires pip install silly-kicks[xshot] and silly-kicks >= 4.94.0 (the release that introduced this variant key — ADR-070). The >= 4.74.0 geometry floor (goal-relative-2) also applies; load() is fail-closed on the feature contract + chirality fingerprint (ADR-040). from_hub() takes no revision argument yet — treat the library version as the pin.

Integrity and load-time guards

load() is fail-closed on SHA256SUMS and the chirality fingerprint (ADR-040), plus a base_score guard for xgboost 3.x serialization. The position-only feature contract raises on a non-finite (NaN-filled) velocity feature — this model expects those columns absent, not imputed.

Limitations

• Not the bundled model (restricted corpus). Redistribution limit, not a performance one.
• Weaker than the faithful sc_extended by construction (velocity dropped) — use only when frames lack velocity.
• No GK measurement exists for the xS arm (the TF-19 xS probe is blocked; unmeasured, not validated).
• Trained on 115 matches, heavily one-club; club/style confounding is real and unquantified.
• Estimates are cross-validated, not a held-out test of the shipped fit.

References

See the NOTICE file in the silly-kicks repository for full bibliographic citations.

• Attribution: arXiv:2512.00203.
• Decisions: ADR-011 (trained-model lifecycle), ADR-038 (corpus + visibility), ADR-040 (chirality enforcement), ADR-063 (velocity-less lift), ADR-067 (position-only variants + velocity auto-select), ADR-070 (position-only Hub variant), ADR-071 (owner-tier archive).

Model Files

More Information

https://github.com/karsten-s-nielsen/silly-kicks

Wheel sibling (4.138.0)

In silly-kicks 4.138.0 the wheel's bundled position_only was re-fit on the corrected type_id shot label (ADR-126, training_commit=4095251). This Hub owner-tier sc_extended_position_only artifact is re-fit this cycle as well — the same type_id label fix (18.9% → 1.34% positive rate) plus the ADR-120 floor-velocity correction. The re-fit weights are pushed by the ADR-088 model-publish step; that re-publish is the point at which the Hub artifact state changes.