random-track-generator 1.0.0__tar.gz

random_track_generator-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Mees van Löben Sels
+
+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.

random_track_generator-1.0.0/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.4
+Name: random-track-generator
+Version: 1.0.0
+Summary: Generate random Formula Student Driverless race tracks.
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: gpxpy>=1.5.0
+Requires-Dist: numpy<2.0,>=1.21.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: scipy>=1.8.1
+Requires-Dist: shapely>=2.0.1
+Dynamic: license-file
+
+# Random Track Generator
+
+![Python](https://img.shields.io/badge/python-%3E%3D3.11-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+
+<p float="middle">
+  <img src="img/extend.png" width="45%" />
+  <img src="img/expand.png" width="45%" />
+</p>
+
+Generate random, rules-compliant tracks for Formula Student Driverless competitions. Creates realistic tracks with proper track width, cone spacing, and corner radii using Voronoi diagram-based generation.
+
+Developed by [Formula Student Team Delft](https://fsteamdelft.nl) for use with [FSSIM](https://github.com/AMZ-Driverless/fssim) and [FSDS](https://github.com/FS-Driverless/Formula-Student-Driverless-Simulator).
+
+## How It Works
+
+Tracks are generated using bounded Voronoi diagrams from uniformly sampled points. Regions are selected using one of three modes (**Expand**, **Extend**, or **Random**), then interpolated with cubic splines to create smooth, realistic racing lines.
+
+<p float="middle">
+  <img src="img/voronoi.png" width="50%" />
+</p>
+
+## Installation
+
+```bash
+uv sync
+```
+
+## Usage
+
+### Generate a random track
+
+```python
+from random_track_generator import generate_track
+
+track = generate_track(
+    n_points=60,       # Voronoi points
+    n_regions=20,      # Regions to select
+    min_bound=0.,      # Minimum x/y bound [m]
+    max_bound=150.,    # Maximum x/y bound [m]
+    mode="extend",     # Generation mode
+    seed=42            # Optional: for reproducibility
+)
+
+cones_left, cones_right = track.as_tuple()
+```
+
+#### Generation Modes
+
+- **`"expand"`** - Selects nearest neighbors for roundish tracks
+- **`"extend"`** - Selects regions along a random line for elongated tracks
+- **`"random"`** - Randomly selects regions for large, irregular tracks
+
+
+> **Note:** Not all parameter combinations produce stable results. Experiment with settings if generation fails.
+
+### Load a preset track
+
+```python
+from random_track_generator import load_track
+
+track = load_track("FSG")
+cones_left, cones_right = track.as_tuple()
+```
+
+### Save to file
+
+```python
+track.save("output/", sim_type="fssim")         # YAML for FSSIM
+track.save("output/", sim_type="fsds")          # CSV for FSDS
+track.save("output/", sim_type="gpx", 
+           lat_offset=51.19, lon_offset=5.32)   # GPX with coordinates
+```
+
+## Credits
+
+Based on Ian Hudson's [Race-Track-Generator](https://github.com/I-Hudson/Race-Track-Generator).

random_track_generator-1.0.0/README.md

@@ -0,0 +1,77 @@
+# Random Track Generator
+
+![Python](https://img.shields.io/badge/python-%3E%3D3.11-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+
+<p float="middle">
+  <img src="img/extend.png" width="45%" />
+  <img src="img/expand.png" width="45%" />
+</p>
+
+Generate random, rules-compliant tracks for Formula Student Driverless competitions. Creates realistic tracks with proper track width, cone spacing, and corner radii using Voronoi diagram-based generation.
+
+Developed by [Formula Student Team Delft](https://fsteamdelft.nl) for use with [FSSIM](https://github.com/AMZ-Driverless/fssim) and [FSDS](https://github.com/FS-Driverless/Formula-Student-Driverless-Simulator).
+
+## How It Works
+
+Tracks are generated using bounded Voronoi diagrams from uniformly sampled points. Regions are selected using one of three modes (**Expand**, **Extend**, or **Random**), then interpolated with cubic splines to create smooth, realistic racing lines.
+
+<p float="middle">
+  <img src="img/voronoi.png" width="50%" />
+</p>
+
+## Installation
+
+```bash
+uv sync
+```
+
+## Usage
+
+### Generate a random track
+
+```python
+from random_track_generator import generate_track
+
+track = generate_track(
+    n_points=60,       # Voronoi points
+    n_regions=20,      # Regions to select
+    min_bound=0.,      # Minimum x/y bound [m]
+    max_bound=150.,    # Maximum x/y bound [m]
+    mode="extend",     # Generation mode
+    seed=42            # Optional: for reproducibility
+)
+
+cones_left, cones_right = track.as_tuple()
+```
+
+#### Generation Modes
+
+- **`"expand"`** - Selects nearest neighbors for roundish tracks
+- **`"extend"`** - Selects regions along a random line for elongated tracks
+- **`"random"`** - Randomly selects regions for large, irregular tracks
+
+
+> **Note:** Not all parameter combinations produce stable results. Experiment with settings if generation fails.
+
+### Load a preset track
+
+```python
+from random_track_generator import load_track
+
+track = load_track("FSG")
+cones_left, cones_right = track.as_tuple()
+```
+
+### Save to file
+
+```python
+track.save("output/", sim_type="fssim")         # YAML for FSSIM
+track.save("output/", sim_type="fsds")          # CSV for FSDS
+track.save("output/", sim_type="gpx", 
+           lat_offset=51.19, lon_offset=5.32)   # GPX with coordinates
+```
+
+## Credits
+
+Based on Ian Hudson's [Race-Track-Generator](https://github.com/I-Hudson/Race-Track-Generator).

random_track_generator-1.0.0/pyproject.toml

@@ -0,0 +1,18 @@
+[project]
+name = "random-track-generator"
+version = "1.0.0"
+description = "Generate random Formula Student Driverless race tracks."
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "gpxpy>=1.5.0",
+    "numpy>=1.21.0,<2.0",
+    "pyyaml>=6.0",
+    "scipy>=1.8.1",
+    "shapely>=2.0.1",
+]
+[tool.setuptools.packages.find]
+include = ["random_track_generator*"]
+
+[tool.setuptools.package-data]
+random_track_generator = ["tracks/*.yaml"]

random_track_generator-1.0.0/random_track_generator.egg-info/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.4
+Name: random-track-generator
+Version: 1.0.0
+Summary: Generate random Formula Student Driverless race tracks.
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: gpxpy>=1.5.0
+Requires-Dist: numpy<2.0,>=1.21.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: scipy>=1.8.1
+Requires-Dist: shapely>=2.0.1
+Dynamic: license-file
+
+# Random Track Generator
+
+![Python](https://img.shields.io/badge/python-%3E%3D3.11-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+
+<p float="middle">
+  <img src="img/extend.png" width="45%" />
+  <img src="img/expand.png" width="45%" />
+</p>
+
+Generate random, rules-compliant tracks for Formula Student Driverless competitions. Creates realistic tracks with proper track width, cone spacing, and corner radii using Voronoi diagram-based generation.
+
+Developed by [Formula Student Team Delft](https://fsteamdelft.nl) for use with [FSSIM](https://github.com/AMZ-Driverless/fssim) and [FSDS](https://github.com/FS-Driverless/Formula-Student-Driverless-Simulator).
+
+## How It Works
+
+Tracks are generated using bounded Voronoi diagrams from uniformly sampled points. Regions are selected using one of three modes (**Expand**, **Extend**, or **Random**), then interpolated with cubic splines to create smooth, realistic racing lines.
+
+<p float="middle">
+  <img src="img/voronoi.png" width="50%" />
+</p>
+
+## Installation
+
+```bash
+uv sync
+```
+
+## Usage
+
+### Generate a random track
+
+```python
+from random_track_generator import generate_track
+
+track = generate_track(
+    n_points=60,       # Voronoi points
+    n_regions=20,      # Regions to select
+    min_bound=0.,      # Minimum x/y bound [m]
+    max_bound=150.,    # Maximum x/y bound [m]
+    mode="extend",     # Generation mode
+    seed=42            # Optional: for reproducibility
+)
+
+cones_left, cones_right = track.as_tuple()
+```
+
+#### Generation Modes
+
+- **`"expand"`** - Selects nearest neighbors for roundish tracks
+- **`"extend"`** - Selects regions along a random line for elongated tracks
+- **`"random"`** - Randomly selects regions for large, irregular tracks
+
+
+> **Note:** Not all parameter combinations produce stable results. Experiment with settings if generation fails.
+
+### Load a preset track
+
+```python
+from random_track_generator import load_track
+
+track = load_track("FSG")
+cones_left, cones_right = track.as_tuple()
+```
+
+### Save to file
+
+```python
+track.save("output/", sim_type="fssim")         # YAML for FSSIM
+track.save("output/", sim_type="fsds")          # CSV for FSDS
+track.save("output/", sim_type="gpx", 
+           lat_offset=51.19, lon_offset=5.32)   # GPX with coordinates
+```
+
+## Credits
+
+Based on Ian Hudson's [Race-Track-Generator](https://github.com/I-Hudson/Race-Track-Generator).

random_track_generator-1.0.0/random_track_generator.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+LICENSE
+README.md
+pyproject.toml
+random_track_generator.egg-info/PKG-INFO
+random_track_generator.egg-info/SOURCES.txt
+random_track_generator.egg-info/dependency_links.txt
+random_track_generator.egg-info/requires.txt
+random_track_generator.egg-info/top_level.txt

random_track_generator-1.0.0/random_track_generator.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

random_track_generator-1.0.0/random_track_generator.egg-info/requires.txt

@@ -0,0 +1,5 @@
+gpxpy>=1.5.0
+numpy<2.0,>=1.21.0
+pyyaml>=6.0
+scipy>=1.8.1
+shapely>=2.0.1

random_track_generator-1.0.0/random_track_generator.egg-info/top_level.txt

@@ -0,0 +1 @@
+

random_track_generator-1.0.0/setup.cfg

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