xy2pct 0.1.0__tar.gz

xy2pct-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 JUSAAATIN
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

xy2pct-0.1.0/PKG-INFO

@@ -0,0 +1,48 @@
+Metadata-Version: 2.4
+Name: xy2pct
+Version: 0.1.0
+Summary: Convert track coordinates to percentages along a lap
+Author-email: jusaaatin <jusaaatin@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 JUSAAATIN
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+Keywords: xy2pct,f1,percentages,coordinates,track,lap,data,analysis
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: matplotlib
+Dynamic: license-file
+
+workflow:
+
+1. use [generatelaparray.py](https://github.com/jusaaatin/f1-xy2pct/blob/main/generatelaparray.py) to spit out a file with x, y, and z coordinates for the track
+2. manually delete extra data points and assign relevant ones to pit lane
+3. use [parselaparray.py](https://github.com/jusaaatin/f1-xy2pct/blob/main/parselaparray.py) to check work (sample code to also go from file to array)
+4. use [xy2pct.py](https://github.com/jusaaatin/f1-xy2pct/blob/main/xy2pct.py) to convert any coordinate to a percentage along the track

xy2pct-0.1.0/README.md

@@ -0,0 +1,6 @@
+workflow:
+
+1. use [generatelaparray.py](https://github.com/jusaaatin/f1-xy2pct/blob/main/generatelaparray.py) to spit out a file with x, y, and z coordinates for the track
+2. manually delete extra data points and assign relevant ones to pit lane
+3. use [parselaparray.py](https://github.com/jusaaatin/f1-xy2pct/blob/main/parselaparray.py) to check work (sample code to also go from file to array)
+4. use [xy2pct.py](https://github.com/jusaaatin/f1-xy2pct/blob/main/xy2pct.py) to convert any coordinate to a percentage along the track

xy2pct-0.1.0/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["setuptools>=61.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "xy2pct"
+version = "0.1.0"
+description = "Convert track coordinates to percentages along a lap"
+readme = "README.md"
+authors = [{ name = "jusaaatin", email = "jusaaatin@gmail.com" }]
+license = { file = "LICENSE" }
+classifiers = [
+"Development Status :: 4 - Beta",
+"License :: OSI Approved :: MIT License",
+"Programming Language :: Python",
+"Programming Language :: Python :: 3",
+"Operating System :: MacOS :: MacOS X",
+"Operating System :: Microsoft :: Windows",
+"Intended Audience :: Education",
+"Intended Audience :: Developers"
+]
+keywords = ["xy2pct", "f1", "percentages", "coordinates", "track", "lap", "data", "analysis"]
+requires-python = ">=3.10"
+dependencies = [
+	"numpy",
+	"matplotlib",
+]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+

xy2pct-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

xy2pct-0.1.0/src/xy2pct/__init__.py

@@ -0,0 +1,7 @@
+# __init__.py
+
+import os
+import src.xy2pct.xy2pct as xy2pct
+
+# Version of the xy2pct package
+__version__ = "0.1.0"

xy2pct-0.1.0/src/xy2pct/mapgeneration/belgiumtrackmap.py

@@ -0,0 +1,32 @@
+from urllib.request import urlopen
+import json
+import numpy as np
+import matplotlib.pyplot as plt
+
+allx = []
+ally = []
+
+response = urlopen('https://api.openf1.org/v1/location?session_key=9939&date>2025-07-27T13:00:00.000&date<2025-07-27T13:20:00.000')
+data = json.loads(response.read().decode('utf-8'))
+for each in data:
+    allx.append(each['x'])
+    ally.append(each['y'])
+
+
+
+def plot(x, y):
+    x_values = np.asarray(x)
+    y_values = np.asarray(y)
+    plt.plot(x_values, y_values, 'o') 
+    plt.axhline(0, color='black', linewidth=0.5, linestyle='--')
+    plt.axvline(0, color='black', linewidth=0.5, linestyle='--')
+    plt.show()
+
+    command = input("Type 'stop' to terminate: ")
+    if command == 'stop':
+        #stop application
+        print("Terminating application.")
+        exit()
+    
+
+plot(allx, ally)

xy2pct-0.1.0/src/xy2pct/mapgeneration/generatelaparray.py

@@ -0,0 +1,79 @@
+from urllib.request import urlopen
+import json
+import numpy as np
+import matplotlib.pyplot as plt
+from datetime import datetime, timedelta
+from pathlib import Path
+
+circuit_short_name = 'Singapore'
+clearanceGap = 50
+
+# get session id, date start, and date end
+def getSessionInfo(circuit_short_name):
+    baselink = f'https://api.openf1.org/v1/sessions?circuit_short_name={circuit_short_name}&session_type=Qualifying&year=2025'
+    response = urlopen(baselink)
+    data = json.loads(response.read().decode('utf-8'))
+    session_id = data[0]['session_key']
+    date_start = data[0]['date_start']
+    print(date_start)
+    return session_id, date_start
+
+# uses sessionid and start date to spit out array of coordinates in a lap
+def getCoordinateArray(session_id, date_start):
+    date_end = datetime.fromisoformat(date_start) + timedelta(minutes=30)
+    coordinates = []
+    link = f'https://api.openf1.org/v1/location?driver_number=4&session_key={session_id}&date>{date_start}&date<{date_end.isoformat()}'
+    response = urlopen(link)
+    data = json.loads(response.read().decode('utf-8'))
+    for item in data:
+        datapack = 'x: {x}, y: {y}, z: {z}'.format(x=item['x'], y=item['y'], z=item['z'])
+        #delete all x=0 y=0 pairs
+        if item['x'] == 0 and item['y'] == 0:
+            continue
+        #make it so that datapack checks that each x y pair is not in +-clearanceGap of any in coordinates
+        is_unique = True
+        for existing in coordinates:
+            existing_x, existing_y, *_ = existing.split(', ')
+            if abs(float(existing_x.split(': ')[1]) - float(item['x'])) <= clearanceGap and abs(float(existing_y.split(': ')[1]) - float(item['y'])) <= clearanceGap:
+                is_unique = False
+                break
+        if is_unique:
+            coordinates.append(datapack)
+    return coordinates
+
+# plots lap
+def plot(coordinates):
+    x_values = []
+    y_values = []
+    for coordinate in coordinates:
+        x, y, *_ = coordinate.split(', ')
+        x_values.append(float(x.split(': ')[1]))
+        y_values.append(float(y.split(': ')[1]))
+    #make first and last color red and the rest gradient from light blue to dark blue
+    colors = ['red'] + [plt.cm.viridis(i) for i in np.linspace(0, 1, len(x_values) - 2)] + ['orange']
+    for i in range(len(x_values)):
+        plt.scatter(x_values[i], y_values[i], c=[colors[i]], marker='o')
+    plt.axhline(0, color='black', linewidth=0.5, linestyle='--')
+    plt.axvline(0, color='black', linewidth=0.5, linestyle='--')
+    plt.title(f"{circuit_short_name} Lap Array")
+    plt.show()
+
+#generates file with track and pit lane coordinates
+def exportToFile(coordinates, circuit_short_name):
+    folder = Path("expy")
+    folder.mkdir(exist_ok=True)
+    filename = folder / f"{circuit_short_name}.txt"
+    with open(filename, "w") as f:
+        f.write("Track\n")
+        f.write("\n".join(coordinates))
+        f.write("\n\nPit Lane")
+    
+
+
+def generateLapArray():
+    coordinatearray = getCoordinateArray(*getSessionInfo(circuit_short_name))
+    exportToFile(coordinatearray, circuit_short_name)
+
+    plot(coordinatearray)
+
+generateLapArray()

xy2pct-0.1.0/src/xy2pct/mapgeneration/parselaparray.py

@@ -0,0 +1,93 @@
+from pathlib import Path
+import numpy as np
+import matplotlib.pyplot as plt
+from matplotlib.widgets import Button
+
+circuit_short_name = "Belgium"
+
+#imports expy files and turns them into separate track and pitlane coordinate arrays
+def fileToArray(circuit_short_name):
+    folder = Path("expy")
+    folder.mkdir(exist_ok=True)
+    file_path = folder / f"{circuit_short_name}.txt"
+
+    if not file_path.exists():
+        print(f"File {file_path} does not exist.")
+        return [], []
+
+    with open(file_path, "r") as file:
+        lines = file.readlines()
+
+    track_coordinates = []
+    pit_lane_coordinates = []
+    current_section = None
+
+    for line in lines:
+        line = line.strip()
+
+        if line == "":
+            continue #ignore blank lines
+        if line == "Track":
+            current_section = "track"
+        elif line == "Pit Lane":
+            current_section = "pit_lane"
+        elif current_section == "track":
+            track_coordinates.append(line)
+        elif current_section == "pit_lane":
+            pit_lane_coordinates.append(line)
+
+    return track_coordinates, pit_lane_coordinates
+
+# plots track and pit lane coordinates
+def draw_plot(ax, track_coordinates, pit_lane_coordinates):
+    ax.clear()
+
+    x_values = []
+    y_values = []
+
+    for coordinate in track_coordinates:
+        x, y, *_ = coordinate.split(", ")
+        x_values.append(float(x.split(": ")[1]))
+        y_values.append(float(y.split(": ")[1]))
+
+    for coordinate in pit_lane_coordinates:
+        x, y, *_ = coordinate.split(", ")
+        x_values.append(float(x.split(": ")[1]))
+        y_values.append(float(y.split(": ")[1]))
+
+    point_colors = (
+        [plt.cm.winter(i) for i in np.linspace(0, 1, len(track_coordinates))]
+        + [plt.cm.autumn(i) for i in np.linspace(0, 1, len(pit_lane_coordinates))]
+    )
+
+    for i in range(len(x_values)):
+        ax.scatter(x_values[i], y_values[i], c=[point_colors[i]], marker="o")
+
+    ax.axhline(0, color="black", linewidth=0.5, linestyle="--")
+    ax.axvline(0, color="black", linewidth=0.5, linestyle="--")
+    ax.set_title(f"{circuit_short_name} Track and Pit Lane")
+
+
+def plot(circuit_short_name):
+    fig, ax = plt.subplots()
+    plt.subplots_adjust(bottom=0.2)
+
+    track_coordinates, pit_lane_coordinates = fileToArray(circuit_short_name)
+    draw_plot(ax, track_coordinates, pit_lane_coordinates)
+
+    button_ax = plt.axes([0.4, 0.05, 0.2, 0.075])
+    reload_button = Button(button_ax, "Reload")
+
+    def reload(event):
+        track_coordinates, pit_lane_coordinates = fileToArray(circuit_short_name)
+        draw_plot(ax, track_coordinates, pit_lane_coordinates)
+        fig.canvas.draw_idle()
+
+    reload_button.on_clicked(reload)
+
+    plt.show()
+
+def parseLapArray():
+    plot(circuit_short_name)
+
+parseLapArray()

xy2pct-0.1.0/src/xy2pct/xy2pct.py

@@ -0,0 +1,117 @@
+from pathlib import Path
+import numpy as np
+import re
+import matplotlib.pyplot as plt
+from matplotlib.widgets import Button
+
+circuit_short_name = "Spa-Francorchamps"
+debug = True
+x = -3930
+y = -1640
+z = 0
+
+def fileToArray(circuit_short_name):
+    folder = Path("expy")
+    folder.mkdir(exist_ok=True)
+    file_path = folder / f"{circuit_short_name}.txt"
+
+    if not file_path.exists():
+        print(f"File {file_path} does not exist.")
+        return [], []
+
+    with open(file_path, "r") as file:
+        lines = file.readlines()
+
+    track_coordinates = []
+    pit_lane_coordinates = []
+    current_section = None
+
+    for line in lines:
+        line = line.strip()
+
+        if line == "":
+            continue
+        if line == "Track":
+            current_section = "track"
+        elif line == "Pit Lane":
+            current_section = "pit_lane"
+        elif current_section == "track":
+            track_coordinates.append(line)
+        elif current_section == "pit_lane":
+            pit_lane_coordinates.append(line)
+
+    return track_coordinates, pit_lane_coordinates
+
+def to_xyz_array(coords):
+    return np.array([
+        [float(x), float(y), float(z) if z is not None else 0.0]
+        for x, y, z in re.findall(
+            r"x:\s*(-?\d+(?:\.\d+)?),\s*y:\s*(-?\d+(?:\.\d+)?)(?:,\s*z:\s*(-?\d+(?:\.\d+)?))?",
+            "\n".join(coords),
+        )
+    ])
+
+def xy2pct(x, y, z=None, circuit_short_name=None): #takes coordinates and finds the % along the track/pit lane it is
+    if isinstance(z, str) and circuit_short_name is None:
+        circuit_short_name = z
+        z = None
+
+    if circuit_short_name is None:
+        circuit_short_name = globals()["circuit_short_name"]
+
+    track_coordinates, pit_lane_coordinates = fileToArray(circuit_short_name)
+    track = to_xyz_array(track_coordinates)
+    pit = to_xyz_array(pit_lane_coordinates)
+
+    if z is None:
+        point = np.array([x, y])
+        track_compare = track[:, :2]
+        pit_compare = pit[:, :2]
+    else:
+        point = np.array([x, y, z])
+        track_compare = track
+        pit_compare = pit
+
+    track_i = np.argmin(np.sum((track_compare - point) ** 2, axis=1))
+    pit_i = np.argmin(np.sum((pit_compare - point) ** 2, axis=1))
+
+    track_dist = np.sum((track_compare[track_i] - point) ** 2)
+    pit_dist = np.sum((pit_compare[pit_i] - point) ** 2)
+
+    onTrack = track_dist <= pit_dist
+
+    coords = track if onTrack else pit
+    index = track_i if onTrack else pit_i
+
+    highlighted = coords[index]
+    percentage = index / len(coords) * 100
+
+    if z is None:
+        print(f"highlighted coordinate: x={highlighted[0]}, y={highlighted[1]}")
+    else:
+        print(f"highlighted coordinate: x={highlighted[0]}, y={highlighted[1]}, z={highlighted[2]}")
+    print(f"onTrack: {onTrack}")
+
+    if debug:
+        return onTrack, percentage, highlighted
+    else:
+        return onTrack, percentage
+
+def plot(x, y, highlighted, track_coordinates, pit_lane_coordinates):
+    track = to_xyz_array(track_coordinates)
+    pit = to_xyz_array(pit_lane_coordinates)
+
+    plt.scatter(track[:, 0], track[:, 1], color='blue', label='Track')
+    plt.scatter(pit[:, 0], pit[:, 1], color='green', label='Pit Lane')
+    plt.scatter(x, y, color='red', label='Input Point', zorder=5)
+    plt.scatter(highlighted[0], highlighted[1], color='orange', label='Highlighted Point', zorder=5)
+    plt.axhline(0, color='black', linewidth=0.5, linestyle='--')
+    plt.axvline(0, color='black', linewidth=0.5, linestyle='--')
+    plt.legend()
+    plt.show()
+    
+    print(xy2pct(x, y, z, circuit_short_name))
+
+
+if debug:
+    plot(x, y, xy2pct(x, y, z, circuit_short_name)[2], *fileToArray(circuit_short_name))

xy2pct-0.1.0/src/xy2pct.egg-info/PKG-INFO

@@ -0,0 +1,48 @@
+Metadata-Version: 2.4
+Name: xy2pct
+Version: 0.1.0
+Summary: Convert track coordinates to percentages along a lap
+Author-email: jusaaatin <jusaaatin@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 JUSAAATIN
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+Keywords: xy2pct,f1,percentages,coordinates,track,lap,data,analysis
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy
+Requires-Dist: matplotlib
+Dynamic: license-file
+
+workflow:
+
+1. use [generatelaparray.py](https://github.com/jusaaatin/f1-xy2pct/blob/main/generatelaparray.py) to spit out a file with x, y, and z coordinates for the track
+2. manually delete extra data points and assign relevant ones to pit lane
+3. use [parselaparray.py](https://github.com/jusaaatin/f1-xy2pct/blob/main/parselaparray.py) to check work (sample code to also go from file to array)
+4. use [xy2pct.py](https://github.com/jusaaatin/f1-xy2pct/blob/main/xy2pct.py) to convert any coordinate to a percentage along the track

xy2pct-0.1.0/src/xy2pct.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+src/xy2pct/__init__.py
+src/xy2pct/xy2pct.py
+src/xy2pct.egg-info/PKG-INFO
+src/xy2pct.egg-info/SOURCES.txt
+src/xy2pct.egg-info/dependency_links.txt
+src/xy2pct.egg-info/requires.txt
+src/xy2pct.egg-info/top_level.txt
+src/xy2pct/mapgeneration/belgiumtrackmap.py
+src/xy2pct/mapgeneration/generatelaparray.py
+src/xy2pct/mapgeneration/parselaparray.py

xy2pct-0.1.0/src/xy2pct.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

xy2pct-0.1.0/src/xy2pct.egg-info/requires.txt

@@ -0,0 +1,2 @@
+numpy
+matplotlib

xy2pct-0.1.0/src/xy2pct.egg-info/top_level.txt

@@ -0,0 +1 @@
+xy2pct