Skip to main content

OpenSTARLab Event Modeling package

Documentation Status dm ArXiv Discord

Introduction

The OpenSTARLab Event package is the fundamental package for event modeling. It is designed to provide a simple and efficient way to train, inference, and simulate events. This package supports the data preprocessed by the OpenSTARLab PreProcessing package.

This package is continuously evolving to support future OpenSTARLab projects. If you have any suggestions or encounter any bugs, please feel free to open an issue.

Soccer Event Modeling

Table: Comparison of model performance on soccer event prediction

Note: Arrows indicate whether a higher (↑) or lower (↓) value is better.
Models are ranked by publication year. Bold values indicate the best performance (unrounded). For more details refer to our paper ArXiv

Wyscout Dataset

Model (Year) Action Acc. ↑ Action F1 ↑ Time-MAE ↓ X-MAE ↓ Y-MAE ↓ FLOPs Num Params
MAJ 0.57 0.08 3.60 18.97 52.55 - -
Seq2Event (2022) 0.67 0.16 3.41 7.11 15.72 112M 135K
NMSTPP (2023) 0.67 0.17 3.34 6.94 15.08 296M 121K
LEM_1 (2024) 0.67 0.17 3.07 8.34 21.44 50M 98K
LEM_3 (2024) 0.67 0.20 2.69 7.62 21.83 20M 39K
FMS (2024) 0.67 0.16 3.27 11.27 24.19 930M 782K

StatsBomb Dataset

Model (Year) Action Acc. ↑ Action F1 ↑ Time-MAE ↓ X-MAE ↓ Y-MAE ↓ FLOPs Num Params
MAJ 0.40 0.06 2.76 20.72 33.32 - -
Seq2Event (2022) 0.65 0.23 2.43 7.22 6.86 4.03B 413K
NMSTPP (2023) 0.65 0.23 2.53 7.38 6.86 2.02B 217K
LEM_1 (2024) 0.65 0.24 2.23 7.36 8.21 66M 128K
LEM_3 (2024) 0.66 0.25 2.07 7.07 8.32 19M 38K
FMS (2024) 0.65 0.24 2.35 7.77 8.82 3.66B 1.29M

Installation

  • Install pytorch (recommended version 2.4.0 linux pip python3.8 cuda12.1)
pip install torch torchvision torchaudio
  • To install this package via PyPI
pip install openstarlab-event
  • To install manually
git clone git@github.com:open-starlab/Event.git
cd ./Event
pip install -e .

Current Features

Sports

RoadMap

  • Release the package
  • Provide pre-trained models

Other Information

Development torch version

version 2.4.0 linux pip python3.8 cuda12.1 

Developer

Calvin Yeung
Calvin Yeung

💻
Keisuke Fujii
Keisuke Fujii

🧑‍💻

Metadata

Release files for openstarlab-event 0.1.25

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for openstarlab-event 0.1.25
File Size Uploaded Provenance Actions
openstarlab_event-0.1.25.tar.gz 63.1 kB Without provenance Details for openstarlab_event-0.1.25.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for openstarlab-event 0.1.25
File Interpreter ABI Platform Actions
openstarlab_event-0.1.25-py3-none-any.whl Python 3 none any Details for openstarlab_event-0.1.25-py3-none-any.whl

Total release size: 155.7 kB

Release files / openstarlab_event-0.1.25.tar.gz

Download URL openstarlab_event-0.1.25.tar.gz
Size 63.1 kB
Tags Source
SHA-256 checksum
How to use checksums
1d7ebf59e42af0fe70b90d4d18a50e646a7dbcdf531e28062d7bfd364fee45d8
BLAKE2b-256 checksum
How to use checksums
6212b969a1da7ce5641d62c9e2864530cc38d2b5cbaedf5554cb6ea9d58c94cb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.8.19

Release files / openstarlab_event-0.1.25-py3-none-any.whl

Download URL openstarlab_event-0.1.25-py3-none-any.whl
Size 92.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
dbdaa714c7b5e9186c09a704512de0ef4df96d622d817172aec3f6260de13174
BLAKE2b-256 checksum
How to use checksums
331982b077288f8dcb1cc045452e0cb2e100e04ca823fa4222172755b19a39e2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.8.19

Security for openstarlab-event 0.1.25

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page