SoccerNetAdmin commited on
Commit
331eb20
Β·
verified Β·
1 Parent(s): c29d74a

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +132 -45
README.md CHANGED
@@ -6,87 +6,174 @@ colorTo: gray
6
  sdk: static
7
  pinned: false
8
  ---
9
- <div align="center">
10
 
11
  # ⚽ SoccerNet
12
 
13
- ### Large-scale datasets and benchmarks for soccer video understanding
 
 
14
 
15
- [🌐 Website](https://www.soccer-net.org) β€’
16
- [πŸ€— Datasets](https://huggingface.co/SoccerNet) β€’
17
- [πŸ’» GitHub](https://github.com/SoccerNet) β€’
18
  [πŸ’¬ Discord](https://discord.gg/cPbqf2mAwF)
19
 
20
- </div>
21
 
22
  ---
23
 
24
- ## About SoccerNet
 
 
25
 
26
- **SoccerNet** is a large-scale benchmark suite for **soccer video understanding**, providing datasets, annotations, benchmarks, and yearly challenges to advance research in sports artificial intelligence.
27
 
28
- SoccerNet covers a broad range of computer vision and multimodal tasks, including:
29
 
30
- - ⚑ Action Spotting & Anticipation
31
- - ⚽ Ball Action Spotting
32
- - πŸŽ₯ Camera Calibration & Understanding
33
- - πŸ‘₯ Player Detection, Tracking & Re-Identification
34
- - πŸ—ΊοΈ Game State Reconstruction
35
- - πŸ₯… Multi-View Foul Recognition
36
- - πŸ“ Monocular Depth Estimation
37
- - 🧠 Visual Question Answering
38
- - 🎬 Novel View Synthesis
39
- - πŸ–ΌοΈ Broadcast Understanding & Generation
40
 
41
- Our goal is to provide the research community with **large-scale data, standardized evaluation protocols, and open benchmarks** for understanding the game of soccer.
 
 
 
 
42
 
43
- ## πŸ€— SoccerNet on Hugging Face
44
 
45
- This organization hosts the official SoccerNet datasets, including challenge datasets and the original SoccerNet video data.
46
 
47
- ### Featured datasets
48
 
49
  | Dataset | Description |
50
  |---|---|
51
- | [SoccerNet_raw_HQ](https://huggingface.co/datasets/SoccerNet/SoccerNet_raw_HQ) | Original SoccerNet games in high-quality video |
52
- | [ActionAnticipation](https://huggingface.co/datasets/SoccerNet/ActionAnticipation) | Soccer action anticipation |
53
- | [SN-PCBAS-2026](https://huggingface.co/datasets/SoccerNet/SN-PCBAS-2026) | SoccerNet 2026 ball action spotting |
54
- | [SN-NVS-2026](https://huggingface.co/datasets/SoccerNet/SN-NVS-2026) | SoccerNet 2026 novel view synthesis |
55
- | [SN-VQA-2026](https://huggingface.co/datasets/SoccerNet/SN-VQA-2026) | SoccerNet 2026 visual question answering |
56
- | [SN-GSR-2025](https://huggingface.co/datasets/SoccerNet/SN-GSR-2025) | Game state reconstruction |
57
- | [SN-MVFouls-2025](https://huggingface.co/datasets/SoccerNet/SN-MVFouls-2025) | Multi-view foul recognition |
58
- | [SN-Depth-2025](https://huggingface.co/datasets/SoccerNet/SN-Depth-2025) | Soccer monocular depth estimation |
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
59
 
60
  ➑️ **[Browse all SoccerNet datasets](https://huggingface.co/SoccerNet/datasets)**
61
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
62
  ## πŸ† SoccerNet Challenges
63
 
64
- SoccerNet organizes yearly international challenges bringing together researchers from academia and industry to benchmark state-of-the-art methods for soccer understanding.
 
 
 
 
 
 
 
 
 
 
 
65
 
66
- Challenge datasets, development sets, test sets, and evaluation resources are progressively hosted here on Hugging Face.
67
 
68
- ➑️ **[SoccerNet Challenges](https://www.soccer-net.org)**
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
69
 
70
  ## πŸ“š Research
71
 
72
- SoccerNet was introduced as a benchmark for action spotting and has progressively expanded toward holistic understanding of soccer games, including temporal, spatial, player-centric, multi-view, and multimodal reasoning.
73
 
74
- Our datasets and benchmarks have supported research across **computer vision, video understanding, multimodal learning, sports analytics, and generative AI**.
75
 
76
- ➑️ **[Publications](https://www.soccer-net.org/publications)**
77
 
78
- ## 🀝 Join the Community
79
 
80
- Whether you are working on a new benchmark, competing in the SoccerNet Challenges, or building the next generation of sports AI systems, we welcome contributions from the community.
81
 
82
- **Website:** https://www.soccer-net.org
83
- **GitHub:** https://github.com/SoccerNet
84
- **Hugging Face:** https://huggingface.co/SoccerNet
85
 
86
  <div align="center">
87
 
88
- ### ⚽ Understand the Game.
89
-
90
- **Data β€’ Benchmarks β€’ Challenges β€’ Community**
 
91
 
92
  </div>
 
6
  sdk: static
7
  pinned: false
8
  ---
 
9
 
10
  # ⚽ SoccerNet
11
 
12
+ ### Soccer Video Understanding Benchmark Suite
13
+
14
+ **Datasets Β· Benchmarks Β· Challenges Β· Research**
15
 
16
+ [🌐 Website](https://www.soccer-net.org) ·
17
+ [πŸ€— Datasets](https://huggingface.co/SoccerNet/datasets) Β·
18
+ [πŸ’» GitHub](https://github.com/SoccerNet) Β·
19
  [πŸ’¬ Discord](https://discord.gg/cPbqf2mAwF)
20
 
 
21
 
22
  ---
23
 
24
+ ## ⚽ What is SoccerNet?
25
+
26
+ **SoccerNet** is a large-scale benchmark suite for **soccer video understanding**.
27
 
28
+ Started in 2018 with action spotting in broadcast soccer games, SoccerNet has progressively expanded toward a broad range of problems in video understanding, field understanding, player understanding, and game understanding.
29
 
30
+ The data currently includes:
31
 
32
+ - **550 complete broadcast games**
33
+ - **12 single-camera games**
34
+ - **300K+ temporal annotations**
35
+ - **1M+ spatial annotations**
 
 
 
 
 
 
36
 
37
+ Beyond the datasets, SoccerNet organizes yearly international challenges where researchers and practitioners benchmark their methods on common tasks and evaluation protocols.
38
+
39
+ 🌐 **Website:** [soccer-net.org](https://www.soccer-net.org)
40
+
41
+ ---
42
 
43
+ ## πŸ€— Datasets on Hugging Face
44
 
45
+ The official SoccerNet Hugging Face organization currently hosts the following datasets.
46
 
47
+ ### Core and research datasets
48
 
49
  | Dataset | Description |
50
  |---|---|
51
+ | **[SoccerNet_raw_HQ](https://huggingface.co/datasets/SoccerNet/SoccerNet_raw_HQ)** | Gated repository for the SoccerNet raw high-quality data |
52
+ | **[ActionAnticipation](https://huggingface.co/datasets/SoccerNet/ActionAnticipation)** | Action anticipation dataset used for the SoccerNet 2026 Action Anticipation Challenge |
53
+ | **[SN-echoes](https://huggingface.co/datasets/SoccerNet/SN-echoes)** | SoccerNet-Echoes audio commentary dataset |
54
+ | **[BannerReplacement](https://huggingface.co/datasets/SoccerNet/BannerReplacement)** | SoccerNet banner replacement dataset |
55
+
56
+ ### SoccerNet 2026
57
+
58
+ | Dataset | Task |
59
+ |---|---|
60
+ | **[SN-PCBAS-2026](https://huggingface.co/datasets/SoccerNet/SN-PCBAS-2026)** | Player-Centric Ball Action Spotting |
61
+ | **[SN-NVS-2026](https://huggingface.co/datasets/SoccerNet/SN-NVS-2026)** | Novel View Synthesis |
62
+ | **[SN-VQA-2026](https://huggingface.co/datasets/SoccerNet/SN-VQA-2026)** | Visual Question Answering |
63
+
64
+ ### SoccerNet 2025
65
+
66
+ | Dataset | Task |
67
+ |---|---|
68
+ | **[SN-BAS-2025](https://huggingface.co/datasets/SoccerNet/SN-BAS-2025)** | Ball Action Spotting |
69
+ | **[SN-Depth-2025](https://huggingface.co/datasets/SoccerNet/SN-Depth-2025)** | Monocular Depth Estimation |
70
+ | **[SN-MVFouls-2025](https://huggingface.co/datasets/SoccerNet/SN-MVFouls-2025)** | Multi-View Foul Recognition |
71
+ | **[SN-GSR-2025](https://huggingface.co/datasets/SoccerNet/SN-GSR-2025)** | Game State Reconstruction |
72
+
73
+ ### SoccerNet 2024
74
+
75
+ | Dataset | Task |
76
+ |---|---|
77
+ | **[SN-BAS-2024](https://huggingface.co/datasets/SoccerNet/SN-BAS-2024)** | Ball Action Spotting |
78
+ | **[SN-MVFouls-2024](https://huggingface.co/datasets/SoccerNet/SN-MVFouls-2024)** | Multi-View Foul Recognition |
79
+ | **[SN-GSR-2024](https://huggingface.co/datasets/SoccerNet/SN-GSR-2024)** | Game State Reconstruction |
80
 
81
  ➑️ **[Browse all SoccerNet datasets](https://huggingface.co/SoccerNet/datasets)**
82
 
83
+ ---
84
+
85
+ ## 🎯 Benchmark Tasks
86
+
87
+ SoccerNet covers tasks ranging from low-level field and player localization to high-level understanding of complete soccer games.
88
+
89
+ ### πŸ“Ί Broadcast Video Understanding
90
+
91
+ - **Action Spotting** β€” localize actions in time
92
+ - **Replay Grounding** β€” retrieve a replayed action in a broadcast
93
+ - **Camera Shot Segmentation** β€” segment camera shots and localize their boundaries
94
+ - **Ball Action Spotting** β€” localize ball actions in time
95
+ - **Dense Video Captioning** β€” spot salient moments and generate commentaries
96
+ - **Multi-View Foul Recognition** β€” recognize fouls and their severity
97
+
98
+ ### 🏟️ Field Understanding
99
+
100
+ - **Field Localization** β€” localize soccer pitch markings and goal posts
101
+ - **Camera Calibration** β€” estimate camera calibration
102
+ - **Monocular Depth Estimation** β€” estimate depth from a monocular camera
103
+
104
+ ### πŸ‘€ Player Understanding
105
+
106
+ - **Player Tracking** β€” track multiple players through video sequences
107
+ - **Player Re-Identification** β€” re-identify players across views
108
+ - **Jersey Number Recognition** β€” identify player jersey numbers from tracklets
109
+
110
+ ### 🧠 Game Understanding
111
+
112
+ - **Game State Reconstruction** β€” reconstruct the game state by tracking the ball and players in a top-view representation
113
+
114
+ ➑️ **[Explore all SoccerNet tasks](https://www.soccer-net.org/tasks)**
115
+
116
+ ---
117
+
118
  ## πŸ† SoccerNet Challenges
119
 
120
+ The **SoccerNet Challenges** have been organized yearly since 2021 and provide standardized datasets, development kits, evaluation protocols, and leaderboards for soccer understanding research.
121
+
122
+ The **2026 edition**, the sixth SoccerNet Challenges edition, included:
123
+
124
+ - **Spiideo SoccerNet SynLoc**
125
+ - **Ball Action Anticipation**
126
+ - **Visual Question Answering**
127
+ - **Player-Centric Ball Action Spotting**
128
+ - **Novel View Synthesis**
129
+ - **FIFA Innovation Challenge β€” Skeletal Tracking Light** *(guest task)*
130
+
131
+ Challenge resources are available through the SoccerNet website, Hugging Face datasets, GitHub development kits, and Codabench evaluation servers.
132
 
133
+ ➑️ **[Explore the SoccerNet Challenges](https://www.soccer-net.org/challenges)**
134
 
135
+ ---
136
+
137
+ ## πŸ’» Open-Source Code
138
+
139
+ Benchmark implementations, development kits, evaluation code, and research projects are maintained in the official **SoccerNet GitHub organization**.
140
+
141
+ Some of the main repositories include:
142
+
143
+ - [**sn-gamestate**](https://github.com/SoccerNet/sn-gamestate) β€” Game State Reconstruction
144
+ - [**sn-calibration**](https://github.com/SoccerNet/sn-calibration) β€” Camera Calibration
145
+ - [**sn-tracking**](https://github.com/SoccerNet/sn-tracking) β€” Player Tracking
146
+ - [**sn-spotting**](https://github.com/SoccerNet/sn-spotting) β€” Action Spotting
147
+ - [**sn-reid**](https://github.com/SoccerNet/sn-reid) β€” Player Re-Identification
148
+ - [**sn-mvfoul**](https://github.com/SoccerNet/sn-mvfoul) β€” Multi-View Foul Recognition
149
+ - [**sn-depth**](https://github.com/SoccerNet/sn-depth) β€” Monocular Depth Estimation
150
+ - [**sn-echoes**](https://github.com/SoccerNet/sn-echoes) β€” SoccerNet-Echoes
151
+ - [**sn-jersey**](https://github.com/SoccerNet/sn-jersey) β€” Jersey Number Recognition
152
+ - [**sn-nvs**](https://github.com/SoccerNet/sn-nvs) β€” Novel View Synthesis
153
+
154
+ ➑️ **[Browse the SoccerNet GitHub organization](https://github.com/SoccerNet)**
155
+
156
+ ---
157
 
158
  ## πŸ“š Research
159
 
160
+ SoccerNet research spans soccer video understanding, player and field analysis, multimodal understanding, and sports AI.
161
 
162
+ The project has grown from the original **SoccerNet action spotting benchmark released in 2018** to a suite of datasets, tasks, benchmark methods, yearly challenges, and community contributions.
163
 
164
+ ➑️ **[Browse SoccerNet publications](https://www.soccer-net.org/publications)**
165
 
166
+ ---
167
 
168
+ ## 🀝 Join the SoccerNet Community
169
 
170
+ SoccerNet is an open research community bringing together researchers and practitioners working on **computer vision, video understanding, multimodal AI, sports analytics, and soccer**.
 
 
171
 
172
  <div align="center">
173
 
174
+ [🌐 Website](https://www.soccer-net.org) ·
175
+ [πŸ€— Hugging Face](https://huggingface.co/SoccerNet) Β·
176
+ [πŸ’» GitHub](https://github.com/SoccerNet) Β·
177
+ [πŸ’¬ Discord](https://discord.gg/cPbqf2mAwF)
178
 
179
  </div>