From cc1ec9c08c8b4f3d202a328fc4f023e0968fd68c Mon Sep 17 00:00:00 2001
From: Calvin Yeung <70192523+calvinyeungck@users.noreply.github.com>
Date: Mon, 5 Jan 2026 14:55:54 +0900
Subject: [PATCH 1/5] Revert "Update readme for ultimate"
---
README.md | 2 --
preprocessing/sports/space_data/space_class.py | 2 +-
preprocessing/sports/space_data/ultimate/README.md | 9 ---------
.../sports/space_data/ultimate/ultimate_space_class.py | 2 +-
.../space_data/ultimate/ultimate_space_preprocessing.py | 4 ++--
5 files changed, 4 insertions(+), 15 deletions(-)
delete mode 100644 preprocessing/sports/space_data/ultimate/README.md
diff --git a/README.md b/README.md
index 3ffa3ae..d48b2c1 100644
--- a/README.md
+++ b/README.md
@@ -34,7 +34,6 @@ pip install -e .
#### Space Data
- [Space data in Basketball 🏀](https://github.com/open-starlab/PreProcessing/blob/master/preprocessing/sports/space_data/basketball/README.md)
- [Space data in Football/Soccer ⚽](https://github.com/open-starlab/PreProcessing/blob/master/preprocessing/sports/space_data/soccer/README.md)
-- [Space data in Ultimate 🥏](https://github.com/open-starlab/PreProcessing/blob/master/preprocessing/sports/space_data/ultimate/README.md)
## RoadMap
- [x] Release the package
@@ -55,7 +54,6 @@ pip install -e .
 Calvin Yeung 💻 |
 Kenjiro Ide 💻 |
 Zheng Chen 💻 |
-  Shunsuke Iwashita 💻 |
 Keisuke Fujii 🧑💻 |
diff --git a/preprocessing/sports/space_data/space_class.py b/preprocessing/sports/space_data/space_class.py
index 52efa74..d7ded26 100644
--- a/preprocessing/sports/space_data/space_class.py
+++ b/preprocessing/sports/space_data/space_class.py
@@ -2,7 +2,7 @@ class Space_data:
# Modified the sports list to only include fully supported providers
basketball_data_provider = ["SportVU_NBA"]
soccer_data_provider = ["fifa_wc_2022"]
- ultimate_data_provider = ["UltimateTrack", "UFATrack"]
+ ultimate_data_provider = ["UltimateTrack", "UFA"]
def __new__(cls, data_provider, *args, **kwargs):
if data_provider in cls.basketball_data_provider:
diff --git a/preprocessing/sports/space_data/ultimate/README.md b/preprocessing/sports/space_data/ultimate/README.md
deleted file mode 100644
index d029456..0000000
--- a/preprocessing/sports/space_data/ultimate/README.md
+++ /dev/null
@@ -1,9 +0,0 @@
-# Space data in Ultimate 🥏
-[](https://openstarlab.readthedocs.io/en/latest/Pre_Processing/Sports/index.html)
-## Introduction
-This package offers functions to load and preprocess space data from various sources in Ultimate.
-## Supported Data Providers
-You can find detailed documentation on supported data providers [here](https://openstarlab.readthedocs.io/en/latest/Pre_Processing/Sports/Space_Eval/Data_Provider/Ultimate/index.html). The supported providers include:
-
-- UFATrack
-- UltimateTrack
\ No newline at end of file
diff --git a/preprocessing/sports/space_data/ultimate/ultimate_space_class.py b/preprocessing/sports/space_data/ultimate/ultimate_space_class.py
index fcd7a8c..89f78f7 100644
--- a/preprocessing/sports/space_data/ultimate/ultimate_space_class.py
+++ b/preprocessing/sports/space_data/ultimate/ultimate_space_class.py
@@ -18,7 +18,7 @@ def __init__(
self.out_path = out_path
if self.data_provider == "UltimateTrack":
self.tracking_herz = 15
- elif self.data_provider == "UFATrack":
+ elif self.data_provider == "UFA":
self.tracking_herz = 10
def get_files(self):
diff --git a/preprocessing/sports/space_data/ultimate/ultimate_space_preprocessing.py b/preprocessing/sports/space_data/ultimate/ultimate_space_preprocessing.py
index 8c6a65d..75d1858 100644
--- a/preprocessing/sports/space_data/ultimate/ultimate_space_preprocessing.py
+++ b/preprocessing/sports/space_data/ultimate/ultimate_space_preprocessing.py
@@ -251,10 +251,10 @@ def create_events_metrica(df, tracking_herz):
def create_tracking_metrica(df, team, tracking_herz):
"""
- Create the Metrica format DataFrame for team tracking data from UFATrack data
+ Create the Metrica format DataFrame for team tracking data from UFA data
Args:
- df (DataFrame): The UFATrack intermediate DataFrame containing tracking data
+ df (DataFrame): The UFA intermediate DataFrame containing tracking data
with columns: frame, class, x, y, id, closest
team (str): Team designation ("Home" for offense, "Away" for defense)
tracking_herz (int): Frequency of tracking data (frames per second)
From 6318ef14318c1677b786db09f826b6018e1bab75 Mon Sep 17 00:00:00 2001
From: Shunsuke Iwashita <129936839+shunsuke-iwashita@users.noreply.github.com>
Date: Mon, 5 Jan 2026 15:04:53 +0900
Subject: [PATCH 2/5] update version
---
pyproject.toml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/pyproject.toml b/pyproject.toml
index 9b1f134..9d3840c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
[project]
name = "openstarlab_preprocessing"
-version = "0.1.41"
+version = "0.1.42"
description = "openstarlab preprocessing package"
readme = "README.md"
requires-python = ">=3.8"
From 14357b13abfc72f02a173f593e15d2519d56a191 Mon Sep 17 00:00:00 2001
From: Shunsuke Iwashita <129936839+shunsuke-iwashita@users.noreply.github.com>
Date: Tue, 13 Jan 2026 09:28:49 +0900
Subject: [PATCH 3/5] update
---
README.md | 2 ++
1 file changed, 2 insertions(+)
diff --git a/README.md b/README.md
index d48b2c1..3ffa3ae 100644
--- a/README.md
+++ b/README.md
@@ -34,6 +34,7 @@ pip install -e .
#### Space Data
- [Space data in Basketball 🏀](https://github.com/open-starlab/PreProcessing/blob/master/preprocessing/sports/space_data/basketball/README.md)
- [Space data in Football/Soccer ⚽](https://github.com/open-starlab/PreProcessing/blob/master/preprocessing/sports/space_data/soccer/README.md)
+- [Space data in Ultimate 🥏](https://github.com/open-starlab/PreProcessing/blob/master/preprocessing/sports/space_data/ultimate/README.md)
## RoadMap
- [x] Release the package
@@ -54,6 +55,7 @@ pip install -e .
 Calvin Yeung 💻 |
 Kenjiro Ide 💻 |
 Zheng Chen 💻 |
+  Shunsuke Iwashita 💻 |
 Keisuke Fujii 🧑💻 |
From 0d17df68c5fe1800fdd90ba836f2d2d0ce467e6e Mon Sep 17 00:00:00 2001
From: Shunsuke Iwashita <129936839+shunsuke-iwashita@users.noreply.github.com>
Date: Tue, 13 Jan 2026 09:29:54 +0900
Subject: [PATCH 4/5] update
---
preprocessing/sports/space_data/space_class.py | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/preprocessing/sports/space_data/space_class.py b/preprocessing/sports/space_data/space_class.py
index d7ded26..52efa74 100644
--- a/preprocessing/sports/space_data/space_class.py
+++ b/preprocessing/sports/space_data/space_class.py
@@ -2,7 +2,7 @@ class Space_data:
# Modified the sports list to only include fully supported providers
basketball_data_provider = ["SportVU_NBA"]
soccer_data_provider = ["fifa_wc_2022"]
- ultimate_data_provider = ["UltimateTrack", "UFA"]
+ ultimate_data_provider = ["UltimateTrack", "UFATrack"]
def __new__(cls, data_provider, *args, **kwargs):
if data_provider in cls.basketball_data_provider:
From 2360b8954c2ad512c7eb0a4958a36d4f12569301 Mon Sep 17 00:00:00 2001
From: shunsuke-iwashita
Date: Tue, 13 Jan 2026 09:33:40 +0900
Subject: [PATCH 5/5] update
---
preprocessing/sports/space_data/ultimate/README.md | 9 +++++++++
.../sports/space_data/ultimate/ultimate_space_class.py | 2 +-
.../space_data/ultimate/ultimate_space_preprocessing.py | 4 ++--
3 files changed, 12 insertions(+), 3 deletions(-)
create mode 100644 preprocessing/sports/space_data/ultimate/README.md
diff --git a/preprocessing/sports/space_data/ultimate/README.md b/preprocessing/sports/space_data/ultimate/README.md
new file mode 100644
index 0000000..d029456
--- /dev/null
+++ b/preprocessing/sports/space_data/ultimate/README.md
@@ -0,0 +1,9 @@
+# Space data in Ultimate 🥏
+[](https://openstarlab.readthedocs.io/en/latest/Pre_Processing/Sports/index.html)
+## Introduction
+This package offers functions to load and preprocess space data from various sources in Ultimate.
+## Supported Data Providers
+You can find detailed documentation on supported data providers [here](https://openstarlab.readthedocs.io/en/latest/Pre_Processing/Sports/Space_Eval/Data_Provider/Ultimate/index.html). The supported providers include:
+
+- UFATrack
+- UltimateTrack
\ No newline at end of file
diff --git a/preprocessing/sports/space_data/ultimate/ultimate_space_class.py b/preprocessing/sports/space_data/ultimate/ultimate_space_class.py
index 89f78f7..fcd7a8c 100644
--- a/preprocessing/sports/space_data/ultimate/ultimate_space_class.py
+++ b/preprocessing/sports/space_data/ultimate/ultimate_space_class.py
@@ -18,7 +18,7 @@ def __init__(
self.out_path = out_path
if self.data_provider == "UltimateTrack":
self.tracking_herz = 15
- elif self.data_provider == "UFA":
+ elif self.data_provider == "UFATrack":
self.tracking_herz = 10
def get_files(self):
diff --git a/preprocessing/sports/space_data/ultimate/ultimate_space_preprocessing.py b/preprocessing/sports/space_data/ultimate/ultimate_space_preprocessing.py
index 75d1858..8c6a65d 100644
--- a/preprocessing/sports/space_data/ultimate/ultimate_space_preprocessing.py
+++ b/preprocessing/sports/space_data/ultimate/ultimate_space_preprocessing.py
@@ -251,10 +251,10 @@ def create_events_metrica(df, tracking_herz):
def create_tracking_metrica(df, team, tracking_herz):
"""
- Create the Metrica format DataFrame for team tracking data from UFA data
+ Create the Metrica format DataFrame for team tracking data from UFATrack data
Args:
- df (DataFrame): The UFA intermediate DataFrame containing tracking data
+ df (DataFrame): The UFATrack intermediate DataFrame containing tracking data
with columns: frame, class, x, y, id, closest
team (str): Team designation ("Home" for offense, "Away" for defense)
tracking_herz (int): Frequency of tracking data (frames per second)