Update README.md
Browse files
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 |
-
###
|
|
|
|
|
|
|
| 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 |
-
##
|
|
|
|
|
|
|
| 25 |
|
| 26 |
-
|
| 27 |
|
| 28 |
-
|
| 29 |
|
| 30 |
-
-
|
| 31 |
-
-
|
| 32 |
-
-
|
| 33 |
-
-
|
| 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 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
| 42 |
|
| 43 |
-
## π€
|
| 44 |
|
| 45 |
-
|
| 46 |
|
| 47 |
-
###
|
| 48 |
|
| 49 |
| Dataset | Description |
|
| 50 |
|---|---|
|
| 51 |
-
| [SoccerNet_raw_HQ](https://huggingface.co/datasets/SoccerNet/SoccerNet_raw_HQ) |
|
| 52 |
-
| [ActionAnticipation](https://huggingface.co/datasets/SoccerNet/ActionAnticipation) |
|
| 53 |
-
| [SN-
|
| 54 |
-
| [
|
| 55 |
-
|
| 56 |
-
|
| 57 |
-
|
| 58 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 59 |
|
| 60 |
β‘οΈ **[Browse all SoccerNet datasets](https://huggingface.co/SoccerNet/datasets)**
|
| 61 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 62 |
## π SoccerNet Challenges
|
| 63 |
|
| 64 |
-
SoccerNet
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 65 |
|
| 66 |
-
|
| 67 |
|
| 68 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 69 |
|
| 70 |
## π Research
|
| 71 |
|
| 72 |
-
SoccerNet
|
| 73 |
|
| 74 |
-
|
| 75 |
|
| 76 |
-
β‘οΈ **[
|
| 77 |
|
| 78 |
-
|
| 79 |
|
| 80 |
-
|
| 81 |
|
| 82 |
-
**
|
| 83 |
-
**GitHub:** https://github.com/SoccerNet
|
| 84 |
-
**Hugging Face:** https://huggingface.co/SoccerNet
|
| 85 |
|
| 86 |
<div align="center">
|
| 87 |
|
| 88 |
-
|
| 89 |
-
|
| 90 |
-
|
|
|
|
| 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>
|