04Events and replay
SoccerNet spotting development kits
The task definitions, data loaders, baselines and evaluators for action spotting and ball-action spotting. The reference frame every football spotter is measured in.
- Video
- Benchmark
- Evaluation code
- Modality
- Broadcast video with timestamped labels
- Output
- Spotting scores: mean average precision at set tolerances
- Evidence
- SoccerNet challenges with public leaderboards
- Code and weights
- Development kit with loaders, baselines and the evaluator
- Licence
- None declared in repository; footage on SoccerNet terms
SoccerNet defines spotting as predicting a timestamp and a class, with no start and no end. Its two tasks sit at different scales. Action spotting covers match events across full broadcasts: goals, cards, substitutions, corners, fouls. Ball-action spotting covers what happens on the ball: passes, drives and the other touches that move play.
The metric is mean average precision at a tolerance. A prediction counts if it falls within a window around a true event. Ball-action spotting is reported at one second, written mAP@1.
The development kit holds the loaders, baseline models and the evaluator the challenge uses.
Where it wins
- Common definitions. A “pass” and a “drive” mean the same thing across papers.
- The evaluator is reusable for any timestamped prediction, possession-change times included.
- Leaderboards show what is achievable for each class, and which classes are hard.
What it costs
- Tolerances are generous by possession standards. mAP@1 forgives an error of 25 frames.
- Spotting has no state. It cannot say who has the ball between events.
- The footage is broadcast, with cuts and replays in the stream.
How it plugs into possession
Read every event-model number through this lens. A spotter’s score describes sparse recall at one-second tolerance on broadcast footage. A possession system needs dense labels at frame tolerance.
The class definitions are the bridge. Each ball action implies something about possession before and after it, and writing that mapping down is the first step in using any spotter as evidence.
The data behind the two tasks is covered under SoccerNet Action Spotting and SoccerNet Ball Action Spotting.
Our read
The shared ruler of event spotting. Know its tolerance before quoting anyone's score.