SoccerNet SDK
Project description
SOCCERNETV2
conda create -n SoccerNet python pip
pip install SoccerNet
Structure of the data data for each game
- SoccerNet main folder
- Leagues (england_epl/europe_uefa-champions-league/france_ligue-1/...)
- Seasons (2014-2015/2015-2016/2016-2017)
- Games (format: "{Date} - {Time} - {HomeTeam} {Score} {AwayTeam}")
-
SoccerNet-v2
- 1_HQ.mkv (HQ video 1st half)
- 2_HQ.mkv (HQ video 2nd half)
- video.ini (information on start/duration for each half of the game in the HQ video, in second)
- 1.mkv (LQ video 1st half - timmed with start/duration from HQ video - resolution 224*398 - 25 fps)
- 2.mkv (LQ video 2nd half - timmed with start/duration from HQ video - resolution 224*398 - 25 fps)
- Labels-v2.json (Labels from SoccerNet-v2 - action spotting)
- Labels-camera.json (Labels from SoccerNet-v1 - camera shot segmentation)
- 1_ResNET_TF2.npy (ResNET features @2fps for 1st half from SoccerNet-v2, extracted using TF2)
- 2_ResNET_TF2.npy (ResNET features @2fps for 2nd half from SoccerNet-v2, extracted using TF2)
- 1_ResNET_TF2_PCA512.npy (ResNET features @2fps for 1st half from SoccerNet-v2, extracted using TF2, with dimensionality reduced to 512 using PCA)
- 2_ResNET_TF2_PCA512.npy (ResNET features @2fps for 2nd half from SoccerNet-v2, extracted using TF2, with dimensionality reduced to 512 using PCA)
- 1_ResNET_5fps_TF2.npy (ResNET features @5fps for 1st half from SoccerNet-v2, extracted using TF2)
- 2_ResNET_5fps_TF2.npy (ResNET features @5fps for 2nd half from SoccerNet-v2, extracted using TF2)
- 1_ResNET_5fps_TF2_PCA512.npy (ResNET features @5fps for 1st half from SoccerNet-v2, extracted using TF2, with dimensionality reduced to 512 using PCA)
- 2_ResNET_5fps_TF2_PCA512.npy (ResNET features @5fps for 2nd half from SoccerNet-v2, extracted using TF2, with dimensionality reduced to 512 using PCA)
- 1_ResNET_25fps_TF2.npy (ResNET features @25fps for 1st half from SoccerNet-v2, extracted using TF2)
- 2_ResNET_25fps_TF2.npy (ResNET features @25fps for 2nd half from SoccerNet-v2, extracted using TF2)
-
Legacy from SoccerNet-v1
- Labels.json (Labels from SoccerNet-v1 - action spotting for goals/cards/subs only)
- 1_C3D.npy (C3D features @2fps for 1st half from SoccerNet-v1)
- 2_C3D.npy (C3D features @2fps for 2nd half from SoccerNet-v1)
- 1_C3D_PCA512.npy (C3D features @2fps for 1st half from SoccerNet-v1, with dimensionality reduced to 512 using PCA)
- 2_C3D_PCA512.npy (C3D features @2fps for 2nd half from SoccerNet-v1, with dimensionality reduced to 512 using PCA)
- 1_I3D.npy (I3D features @2fps for 1st half from SoccerNet-v1)
- 2_I3D.npy (I3D features @2fps for 2nd half from SoccerNet-v1)
- 1_I3D_PCA512.npy (I3D features @2fps for 1st half from SoccerNet-v1, with dimensionality reduced to 512 using PCA)
- 2_I3D_PCA512.npy (I3D features @2fps for 2nd half from SoccerNet-v1, with dimensionality reduced to 512 using PCA)
- 1_ResNET.npy (ResNET features @2fps for 1st half from SoccerNet-v1)
- 2_ResNET.npy (ResNET features @2fps for 2nd half from SoccerNet-v1)
- 1_ResNET_PCA512.npy (ResNET features @2fps for 1st half from SoccerNet-v1, with dimensionality reduced to 512 using PCA)
- 2_ResNET_PCA512.npy (ResNET features @2fps for 2nd half from SoccerNet-v1, with dimensionality reduced to 512 using PCA)
-
- Games (format: "{Date} - {Time} - {HomeTeam} {Score} {AwayTeam}")
- Seasons (2014-2015/2015-2016/2016-2017)
- Leagues (england_epl/europe_uefa-champions-league/france_ligue-1/...)
How to Download Games (Python)
from SoccerNet import SoccerNetDownloader
mySoccerNetDownloader = SoccerNetDownloader(LocalDirectory="/path/to/soccernet")
# Download SoccerNet labels and features
mySoccerNetDownloader.downloadGames(files=["Labels.json"], split=["train","valid","test"]) # download labels
mySoccerNetDownloader.downloadGames(files=["Labels-v2.json"], split=["train","valid","test"]) # download labels SN v2
mySoccerNetDownloader.downloadGames(files=["Labels-cameras.json"], split=["train","valid","test"]) # download labels for camera shot
mySoccerNetDownloader.downloadGames(files=["1_ResNET_TF2.npy", "2_ResNET_TF2.npy"], split=["train","valid","test"]) # download Features
mySoccerNetDownloader.downloadGames(files=["1_ResNET_TF2_PCA512.npy", "2_ResNET_TF2_PCA512.npy"], split=["train","valid","test"]) # download Features reduced with PCA
# Download SoccerNet videos (require password from NDA to download videos)
mySoccerNetDownloader.password = input("Password for videos? (contact the author):\n")
mySoccerNetDownloader.downloadGames(files=["1.mkv", "2.mkv"], split=["train","valid","test"]) # download LQ Videos
mySoccerNetDownloader.downloadGames(files=["1_HQ.mkv", "2_HQ.mkv", "video.ini"], split=["train","valid","test"]) # download HQ Videos
# Download SoccerNet Challenge set (require password from NDA to download videos)
mySoccerNetDownloader.downloadGames(files=["1_ResNET_TF2.npy", "2_ResNET_TF2.npy"], split=["challenge"]) # download Features
mySoccerNetDownloader.downloadGames(files=["1_ResNET_TF2_PCA512.npy", "2_ResNET_TF2_PCA512.npy"], split=["challenge"]) # download Features reduced with PCA
mySoccerNetDownloader.downloadGames(files=["1.mkv", "2.mkv", "video.ini"], split=["challenge"]) # download LQ Videos (require password from NDA)
mySoccerNetDownloader.downloadGames(files=["1_HQ.mkv", "2_HQ.mkv", "video.ini"], split=["challenge"]) # download HQ Videos (require password from NDA)
How to read the list Games (Python)
from SoccerNet import getListGames
print(getListGames(split="train")) # return list of games recommended for training
print(getListGames(split="valid")) # return list of games recommended for validation
print(getListGames(split="test")) # return list of games recommended for testing
print(getListGames(split="challenge")) # return list of games recommended for challenge
print(getListGames(split=["train", "valid", "test", "challenge"])) # return list of games for training, validation and testing
print(getListGames(split="v1")) # return list of games from SoccerNetv1 (train/valid/test)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
SoccerNet-0.0.91.tar.gz
(23.4 kB
view hashes)
Built Distribution
Close
Hashes for SoccerNet-0.0.91-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c245e30696a83d30d4d1c0ebff1975ce48c48e2c353e314c91d8298c756c90f7 |
|
MD5 | 71f131d808b07a91d45b94a24836855f |
|
BLAKE2b-256 | ccdcd901c7c7f0f320f7d7c8ea98e29bcc6fec015e903665ace8d1cd947482c5 |