Awesome

SoccerNet - Action Spotting

Welcome to the SoccerNet Development Kit for the Action Spotting and Ball Action Spotting Tasks and Challenges. This kit is meant as a help to get started working with the soccernet data and the proposed task. More information about the dataset can be found on our official website.

SoccerNet Action Spotting is part of the SoccerNet-v2 dataset, which is an extension of SoccerNet-v1 with new and challenging tasks including action spotting, camera shot segmentation with boundary detection, and a novel replay grounding task.

[New] In 2024, we renew the Ball Action Spotting Challenge, including 12 classes: Pass, Drive, Header, High Pass, Out, Cross, Throw In, Shot, Ball Player Block, Player Successful Tackle, Free Kick, Goal. Those events are much more dense and require a higher level of spotting precision. The density of those events, as well as the subtle underlying movement of the ball and players, make this new task even more challenging. For this new challenge, you only have access to 7 annotated games, so you may want to take a look at different training paradigms such as transfer learning, unsupervised learning or semi-supervised learning. Remember that you still have access to the 500 videos from soccernet to help you.

[New] A Baseline code to get started on the 2024 Ball Action spotting Challenge is available here: https://github.com/recokick/ball-action-spotting. It is a fork of the amazing work of last year's Ball Action Spotting Winner, Ruslan Baikulov, adapted to the new classes. Go check out and star his original repo: https://github.com/lRomul/ball-action-spotting.

The Action Spotting dataset consists of 500 complete soccer games including:

• Full untrimmed broadcast videos in both low and high resolution.
• Pre-computed features such as ResNET-152.
• Annotations of actions among 17 classes (Labels-v2.json).

The new Ball Action Spotting dataset consists of 7 complete soccer games including:

• Full untrimmed broadcast videos in both low and high resolution.
• Annotations of actions among 12 classes (Labels-ball.json).

Participate in our upcoming Challenges during the CVPR 2024 International Challenge at the CVSports Workshop! All details are provided on our evaluation server for the ball action spotting task, or on the main soccernet page.

The participation deadline is fixed at the 30th of May 2024. The official rules and guidelines are available on ChallengeRules.md.

2023 Action Spotting Challenge leaderboard

2022 Action Spotting Challenge leaderboard

2021 Action Spotting Challenge leaderboard

This table summarizes the current performances on the 2021 Action Spotting Challenge. For the leaderboard on the 2022 challenge, please visit EvalAI test and challenge leaderboards.

Published Action Spotting research benchmark

This table summarizes the current performances of published methods only. Last update January 2022.

2023 Ball Action Spotting Challenge leaderboard

How to download the dataset

SoccerNet-v2 Action Spotting

A SoccerNet pip package to easily download the data and the annotations is available.

To install the pip package simply run:

<code>pip install SoccerNet</code>

Then use the API to downlaod the data of interest:

from SoccerNet.Downloader import SoccerNetDownloader
mySoccerNetDownloader = SoccerNetDownloader(LocalDirectory="/path/to/SoccerNet")
mySoccerNetDownloader.downloadGames(files=["Labels-v2.json"], split=["train","valid","test"])

If you want to download the videos, you will need to fill a NDA to get the password.

mySoccerNetDownloader.password = input("Password for videos?:\n")
mySoccerNetDownloader.downloadGames(files=["1_224p.mkv", "2_224p.mkv"], split=["train","valid","test","challenge"])
mySoccerNetDownloader.downloadGames(files=["1_720p.mkv", "2_720p.mkv", "video.ini"], split=["train","valid","test","challenge"])

We provide several features including ResNET (used for our benchmarks), and last year's winners features from Baidu Research. Check out our pip package documentation for more features.

mySoccerNetDownloader.downloadGames(files=["1_ResNET_TF2_PCA512.npy", "2_ResNET_TF2_PCA512.npy"], split=["train","valid","test","challenge"])
mySoccerNetDownloader.downloadGames(files=["1_baidu_soccer_embeddings.npy", "2_baidu_soccer_embeddings.npy"], split=["train","valid","test","challenge"])

SoccerNet Ball Action Spotting

The easiest way to download and prepare the data is to use the following python code.

python Download/download_ball_data.py --dataset_dir path/to/SoccerNet --password_videos "password_received_from_NDA"

Alternatively, you may use the same pip package as for SoccerNet-v2.

The following code will download the videos and annotations (except annotations on the challenge set) in separated zip files.

from SoccerNet.Downloader import SoccerNetDownloader as SNdl
mySNdl = SNdl(LocalDirectory="path/to/SoccerNet")
mySNdl.downloadDataTask(task="spotting-ball-2024", split=["train", "valid", "test", "challenge"], password=<PW_FROM_NDA>)

Note that you may have to extract and merge the zip files yourself if you choose the second option.

How to extract video features

As it was one of the most requested features on SoccerNet-V1, this repository provides functions to automatically extract the ResNet-152 features and compute the PCA on your own broadcast videos. These functions allow you to test pre-trained action spotting, camera segmentation or replay grounding models on your own games.

The functions to extract the video features can be found in the Features folder.

Benchmark Implementations

SoccerNet-v2 Action Spotting

This repository contains several benchmarks for action spotting, which are presented in the SoccerNet-V2 paper, or subsequent papers. You can use these codes to build upon our methods and improve the performances.

SoccerNet Ball Action Spotting

The benchmark to beat this year is the E2E-spot method published at ECCV 2022 by J. Hong et. al trained with default parameters and 25fps videos. This method arrived second in the 2022 Action Spotting Challenge The code will be updated on their github repository for anyone to reproduce the baseline results and improve on them.

Evaluation

This repository and the pip package provide evaluation functions for the proposed tasks based on predictions saved in the JSON format. See the Evaluation folder of this repository for more details.

Visualizations

Finally, this repository provides the Annotation tool used to annotate the actions. This tool can be used to visualize the information. Please follow the instruction in the dedicated folder for more details.

Our other Challenges

Check out our other challenges related to SoccerNet!

• Action Spotting
• Replay Grounding
• Calibration
• Re-Identification
• Tracking
• Dense Video Captioning
• Jersey Number Recognition

Citation

For further information check out the paper and supplementary material: https://openaccess.thecvf.com/content/CVPR2021W/CVSports/papers/Deliege_SoccerNet-v2_A_Dataset_and_Benchmarks_for_Holistic_Understanding_of_Broadcast_CVPRW_2021_paper.pdf

Please cite our work if you use our dataset:

@InProceedings{Deliège2020SoccerNetv2,
      title={SoccerNet-v2 : A Dataset and Benchmarks for Holistic Understanding of Broadcast Soccer Videos}, 
      author={Adrien Deliège and Anthony Cioppa and Silvio Giancola and Meisam J. Seikavandi and Jacob V. Dueholm and Kamal Nasrollahi and Bernard Ghanem and Thomas B. Moeslund and Marc Van Droogenbroeck},
      year={2021},
      booktitle = {The IEEE Conference on Computer Vision and Pattern Recognition (CVPR) Workshops},
      month = {June},
}

For further information about the chalklenge check out the paper and supplementary material: https://arxiv.org/abs/2210.02365

@inproceedings{Giancola_2022,
	doi = {10.1145/3552437.3558545},
	url = {https://doi.org/10.1145%2F3552437.3558545},
	year = 2022,
	month = {oct},
	publisher = {{ACM}},
	author = {Silvio Giancola and Anthony Cioppa and Adrien Deli{\`{e}}ge and Floriane Magera and Vladimir Somers and Le Kang and Xin Zhou and Olivier Barnich and Christophe De Vleeschouwer and Alexandre Alahi and Bernard Ghanem and Marc Van Droogenbroeck and Abdulrahman Darwish and Adrien Maglo and Albert Clap{\'{e}}s and Andreas Luyts and Andrei Boiarov and Artur Xarles and Astrid Orcesi and Avijit Shah and Baoyu Fan and Bharath Comandur and Chen Chen and Chen Zhang and Chen Zhao and Chengzhi Lin and Cheuk-Yiu Chan and Chun Chuen Hui and Dengjie Li and Fan Yang and Fan Liang and Fang Da and Feng Yan and Fufu Yu and Guanshuo Wang and H. Anthony Chan and He Zhu and Hongwei Kan and Jiaming Chu and Jianming Hu and Jianyang Gu and Jin Chen and Jo{\~{a}}o V. B. Soares and Jonas Theiner and Jorge De Corte and Jos{\'{e}} Henrique Brito and Jun Zhang and Junjie Li and Junwei Liang and Leqi Shen and Lin Ma and Lingchi Chen and Miguel Santos Marques and Mike Azatov and Nikita Kasatkin and Ning Wang and Qiong Jia and Quoc Cuong Pham and Ralph Ewerth and Ran Song and Rengang Li and Rikke Gade and Ruben Debien and Runze Zhang and Sangrok Lee and Sergio Escalera and Shan Jiang and Shigeyuki Odashima and Shimin Chen and Shoichi Masui and Shouhong Ding and Sin-wai Chan and Siyu Chen and Tallal El-Shabrawy and Tao He and Thomas B. Moeslund and Wan-Chi Siu and Wei Zhang and Wei Li and Xiangwei Wang and Xiao Tan and Xiaochuan Li and Xiaolin Wei and Xiaoqing Ye and Xing Liu and Xinying Wang and Yandong Guo and Yaqian Zhao and Yi Yu and Yingying Li and Yue He and Yujie Zhong and Zhenhua Guo and Zhiheng Li},
	title = {{SoccerNet} 2022 Challenges Results},
	booktitle = {Proceedings of the 5th International {ACM} Workshop on Multimedia Content Analysis in Sports}
}