zero2route3d-sdk 0.2.0__tar.gz

zero2route3d_sdk-0.2.0/CHANGELOG.md

@@ -0,0 +1,46 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [0.2.0] - 2026-08-25
+### Added
+- Added `GeoTiffRasterSource` for headless rasterio-backed GeoTIFF sampling with WGS84-to-raster CRS reprojection.
+- Added GeoTIFF DEM integration for `EnvironmentalSurfaceSampler` and `sample_rasterio_dem`.
+- Added file/path GeoJSON network loading for high-level routing calls.
+- Added focused 0.2.0 regression tests for network input, profile resolution, DEM fallback behavior, report generation, multimodal routing, and plotting validation.
+
+### Changed
+- Made unknown profile keys fail strictly in high-level APIs while preserving the legacy non-strict `get_profile` fallback.
+- Preserved caller-supplied `MobilityProfile` instances through routing engines.
+- Improved standalone route HTML output so generated reports include their route data, styles, and scripts without external assets.
+- Kept missing DEM/elevation samples as `None` instead of silently treating them as sea level.
+
+### Fixed
+- Fixed GeoJSON `oneway=-1` handling so reversed one-way segments are stored in their travel direction.
+- Fixed DEM batch fetch alignment when invalid coordinates or cache misses are present.
+- Fixed multimodal hub selection so access and egress hubs cannot collapse into the same main-leg endpoint.
+- Fixed motorized elevation plots so they do not show pedestrian calorie axes.
+- Fixed Pareto plotting to reject unsupported metric names instead of silently substituting calories.
+
+## [0.1.0] - 2026-08-24
+### Added
+- Initial standalone release of `zero2route3d-sdk`.
+- Biomechanical kinematics engine: Tobler's walking speed, Minetti metabolic energy polynomials, cycling aerodynamics, rolling resistance, scooter power, and senior fatigue decay.
+- 15 Calibrated mobility profiles spanning pedestrian, micromobility, vehicle, and emergency modes.
+- 3D Topological graph routing engine with Dijkstra and A* pathfinding.
+- NAMOA* 4D Multi-objective Pareto frontier router (Time, Climb, Heat Dose, Calories).
+- 3D Anisotropic Isochrone wavefront simulation engine.
+- 3D Hidden Markov Model (HMM) Viterbi map-matching for noisy GPS/GPX tracks.
+- Keys' 16-point bicubic convolution spline micro-elevation interpolator.
+- Solar shadow raytracing and thermal irradiance analysis.
+- Multi-Criteria Decision Analysis (AHP) with consistency ratio validation ($CR \le 0.10$).
+- Enhanced 2-Step Floating Catchment Area (E2SFCA) accessibility equity engine with Gini, Lorenz, and Palma scorecards.
+- Dynamic hazard zone evacuation routing and safe haven allocation.
+- Standalone Three.js 60 FPS WebGL 3D Cockpit HTML bundler.
+- AutoCAD DXF 3D Polyline and longitudinal profile drawing exporter.
+- Copernicus GLO-30 DEM COG tile fetcher.

zero2route3d_sdk-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yusuf Eminoğlu
+
+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.

zero2route3d_sdk-0.2.0/MANIFEST.in

@@ -0,0 +1,7 @@
+include LICENSE
+include README.md
+include CHANGELOG.md
+include pyproject.toml
+include src/zero2route3d/py.typed
+recursive-include src/zero2route3d *.py
+recursive-include tests *.py

zero2route3d_sdk-0.2.0/PKG-INFO

@@ -0,0 +1,251 @@
+Metadata-Version: 2.4
+Name: zero2route3d-sdk
+Version: 0.2.0
+Summary: Headless 3D spatial mobility, biomechanical human kinematics, and multi-criteria routing engine.
+Author-email: Yusuf Eminoğlu <yusufeminoglu@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/YusufEminoglu/zero2route3d_sdk
+Project-URL: Repository, https://github.com/YusufEminoglu/zero2route3d_sdk
+Project-URL: Issues, https://github.com/YusufEminoglu/zero2route3d_sdk/issues
+Project-URL: Documentation, https://yusufeminoglu.github.io/zero2route3d/
+Keywords: gis,routing,shortest-path,isochrone,accessibility,walkability,mobility,kinematics,openstreetmap,dem,pareto,map-matching
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Topic :: Scientific/Engineering :: Physics
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.20.0
+Requires-Dist: scipy>=1.7.0
+Provides-Extra: geo
+Requires-Dist: shapely>=2.0.0; extra == "geo"
+Requires-Dist: rasterio>=1.3.0; extra == "geo"
+Requires-Dist: geopandas>=0.12.0; extra == "geo"
+Requires-Dist: networkx>=2.8.0; extra == "geo"
+Requires-Dist: matplotlib>=3.5.0; extra == "geo"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Dynamic: license-file
+
+# zero2route3d-sdk
+
+[![CI](https://github.com/YusufEminoglu/zero2route3d_sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/YusufEminoglu/zero2route3d_sdk/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/zero2route3d-sdk.svg)](https://pypi.org/project/zero2route3d-sdk/)
+[![Python version support](https://img.shields.io/pypi/pyversions/zero2route3d-sdk.svg)](https://pypi.org/project/zero2route3d-sdk/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Code style: Ruff](https://img.shields.io/badge/code%20style-ruff-D7FF64.svg)](https://docs.astral.sh/ruff/)
+
+**zero2route3d-sdk** is a Python library for **3D spatial mobility modeling, biomechanical human kinematics, and multi-criteria routing analytics**.
+
+Built for urban planners, mobility researchers, and geospatial developers, it brings physiological human movement equations, terrain-aware 3D graph algorithms, and environmental microclimate impedance surfaces together into a pure-Python, headless package powered by NumPy and SciPy.
+
+---
+
+## 🌟 Key Capabilities
+
+1. **Biomechanical Kinematics & Energy Modeling:**
+   - Empirical slope-speed curves via **Tobler's hiking function** ($W(s) = 6.0 \cdot e^{-3.5|s+0.05|}$).
+   - Exact metabolic energy expenditure via **Minetti's 5th-order polynomial equations** ($J / (kg \cdot m)$).
+   - Aerodynamic drag, rolling resistance, and mechanical efficiency for commuter bikes, cargo bikes, and e-scooters.
+   - Universal Thermal Comfort Index (**UTCI**) and solar irradiance aspect factors.
+
+2. **15 Calibrated Mobility Profiles:**
+   - Pedestrian (*Adult, Senior, Child*).
+   - Universal accessibility (*Wheelchair ADA, Stroller*).
+   - Micromobility (*Commuter Bike, Cargo Bike, E-Bike, E-Scooter, Runner, Hiker*).
+   - Vehicles & Emergency (*Emergency EMS, Fire Truck, Logistics Van, Electric Car*).
+
+3. **Multi-Objective 4D Pareto Optimization (NAMOA*):**
+   - Finds non-dominated Pareto frontiers balancing **Travel Time, Cumulative Climb, Thermal Heat Dose, and Metabolic Calories**.
+
+4. **3D Topological Routing & Isochrones:**
+   - 3D graph construction with elevation draping, turn penalties, and barrier avoidance.
+   - Anisotropic 3D isochrone wavefront propagation.
+
+5. **3D Hidden Markov Model (HMM) Map Matching:**
+   - Robust Viterbi decoding matching noisy GPS/GPX tracks to 3D networks.
+
+6. **Micro-Elevation & Solar Ray-Tracing:**
+   - Keys' 16-point bicubic convolution spline interpolation with analytical $\mathcal{C}^1$ slope/aspect derivatives.
+   - Solar position calculation (azimuth/elevation) and building shadow casting.
+
+7. **Spatial Justice & Evacuation:**
+   - Enhanced 2-Step Floating Catchment Area (**E2SFCA**) healthcare/amenity accessibility.
+   - Gini coefficients, Lorenz curves, and Palma spatial equity ratios.
+   - Dynamic hazard zone evacuation routing and safe haven allocation.
+
+8. **Headless & Multi-Format I/O:**
+   - Runs everywhere: Jupyter Notebooks, FastAPI/Flask backends, Docker containers, CLI scripts.
+   - Exports to GeoJSON 3D, GPX 1.1, AutoCAD DXF (AC1009/AC1015) 3D Polylines, and standalone Three.js 60 FPS WebGL 3D Cockpit HTML bundles.
+
+---
+
+## 📦 Installation
+
+Install the core library from PyPI:
+
+```bash
+pip install zero2route3d-sdk
+```
+
+Or install with optional geospatial acceleration libraries:
+
+```bash
+pip install "zero2route3d-sdk[geo]"
+```
+
+---
+
+## 🚀 Quickstart
+
+### 1. High-Level One-Line Routing & Isochrones
+
+```python
+import zero2route3d as zr3d
+
+# Solve 3D Least-Cost Route in 1 line
+route = zr3d.solve_3d_route(
+    origin=(27.11, 38.41),
+    destination=(27.14, 38.44),
+    network="izmir_network.geojson",  # Or GeoDataFrame / list of RoadSegments
+    profile="wheelchair"              # 15 calibrated profiles
+)
+
+print(f"Distance: {route.statistics.total_distance_km:.2f} km")
+print(f"Duration: {route.statistics.total_duration_min:.1f} min")
+print(f"Climb: +{route.statistics.elevation_gain_m:.1f} m")
+
+# Save or display interactive 3D WebGL Cockpit
+route.to_html("route_viewer.html")
+
+# Plot publication-grade elevation & metabolic energy profile with Matplotlib
+route.plot(show_energy=True, save_path="profile.png")
+
+# Convert to 3D LineStringZ GeoDataFrame for GIS workflows
+gdf = route.to_geodataframe()
+```
+
+### 2. Multi-Objective 4D Pareto Frontier (NAMOA*)
+
+```python
+import zero2route3d as zr3d
+
+pareto_result = zr3d.solve_4d_pareto_frontier(
+    origin=(27.11, 38.41),
+    destination=(27.14, 38.44),
+    network="izmir_network.geojson",
+    profile="commuter_bike"
+)
+
+for idx, sol in enumerate(pareto_result.solutions, start=1):
+    print(f"Solution #{idx}: Time={sol.costs.time_sec/60:.1f}m, Climb={sol.costs.climb_m:.1f}m, Calories={sol.costs.calories_kcal:.0f}kcal")
+
+# Plot 2D Pareto trade-off curve
+zr3d.plot_pareto_frontier_2d(pareto_result, save_path="pareto_curve.png")
+```
+
+### 3. GeoPandas & NetworkX Ecosystem Bridges
+
+```python
+from zero2route3d import to_geodataframe, to_networkx_digraph, from_geodataframe
+import geopandas as gpd
+
+# Load standard GeoDataFrame of road centerlines
+gdf = gpd.read_file("streets.geojson")
+
+# Convert GeoDataFrame into 3D RoadSegment graph
+segments = from_geodataframe(gdf)
+
+# Convert 3D routing graph into NetworkX DiGraph with slope & kinematic weights
+nx_digraph = to_networkx_digraph(segments)
+```
+
+### 4. Command Line Interface (CLI)
+
+```bash
+# Inspect all 15 mobility profiles
+zero2route3d profiles
+
+# Run headless 3D route calculation from terminal
+zero2route3d route --origin 27.11,38.41 --dest 27.14,38.44 --network streets.geojson --profile wheelchair --out-geojson route.geojson --out-dxf route.dxf --out-html viewer.html
+
+# Compute 3D travel time isochrone bands
+zero2route3d isochrone --center 27.12,38.42 --intervals 5,10,15 --network streets.geojson --out-geojson isochrones.geojson
+```
+
+---
+
+## 📚 Mobility Profiles Catalog
+
+| Key | Profile Name | Base Speed | Max Slope | Stairs Policy | Target Use-Case |
+| :--- | :--- | :--- | :--- | :--- | :--- |
+| `adult` | Standard Adult | 5.0 km/h | 25.0% | Allowed (1.2×) | Everyday urban walking |
+| `senior` | Senior / Elderly | 3.2 km/h | 10.0% | Heavy Penalty (8.0×) | Age-friendly routing |
+| `child` | Child / Elementary | 3.8 km/h | 12.0% | Heavy Penalty (5.0×) | Safe routes to school |
+| `wheelchair` | Wheelchair ADA | 3.5 km/h | 5.0% | **Forbidden** (1000×) | Barrier-free ADA routing |
+| `stroller` | Stroller / Pram | 4.0 km/h | 8.0% | **Forbidden** (500×) | Family-friendly walking |
+| `cargo_bike` | Cargo Bike | 14.0 km/h | 8.0% | **Forbidden** (1000×) | Urban freight & logistics |
+| `commuter_bike`| Commuter Bike | 18.0 km/h | 15.0% | Heavy Penalty (20.0×) | Daily bicycle commuting |
+| `ebike` | Electric Assist Bike| 22.0 km/h | 22.0% | Heavy Penalty (20.0×) | Topography-immune cycling |
+| `escooter` | E-Scooter | 16.0 km/h | 10.0% | **Forbidden** (1000×) | First/last-mile micromobility |
+| `runner` | Jogger / Runner | 10.0 km/h | 30.0% | Allowed (1.0×) | Fitness & athletic routing |
+| `hiker` | Mountain Hiker | 4.5 km/h | 50.0% | Allowed (1.0×) | Trail & topographic hiking |
+| `emergency_ems`| Ambulance EMS | 50.0 km/h | 20.0% | **Forbidden** (1000×) | Rapid emergency response |
+| `emergency_fire`| Fire Engine Heavy | 40.0 km/h | 16.0% | **Forbidden** (1000×) | Heavy emergency vehicles |
+| `logistics_van`| Delivery Van | 45.0 km/h | 18.0% | **Forbidden** (1000×) | Courier & parcel delivery |
+| `electric_car` | Electric EV | 50.0 km/h | 25.0% | **Forbidden** (1000×) | Regenerative braking routing |
+
+---
+
+## 🧪 Development & Testing
+
+Clone the repository and install in editable mode:
+
+```bash
+git clone https://github.com/YusufEminoglu/zero2route3d_sdk.git
+cd zero2route3d_sdk
+pip install -e ".[dev]"
+```
+
+Run test suite with coverage:
+
+```bash
+pytest tests/ -v --cov=zero2route3d
+```
+
+Run linter and type checker:
+
+```bash
+ruff check .
+ruff format --check src tests
+mypy src
+```
+
+---
+
+## 📄 License & Citation
+
+Distributed under the **MIT License**. See `LICENSE` for details.
+
+If you use this library in scientific research, please cite:
+
+```bibtex
+@software{eminoglu2026zero2route3d,
+  author = {Eminoğlu, Yusuf},
+  title = {zero2route3d-sdk: Headless 3D spatial mobility, biomechanical human kinematics, and multi-criteria routing engine},
+  year = {2026},
+  url = {https://github.com/YusufEminoglu/zero2route3d_sdk}
+}
+```

zero2route3d_sdk-0.2.0/README.md

@@ -0,0 +1,210 @@
+# zero2route3d-sdk
+
+[![CI](https://github.com/YusufEminoglu/zero2route3d_sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/YusufEminoglu/zero2route3d_sdk/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/zero2route3d-sdk.svg)](https://pypi.org/project/zero2route3d-sdk/)
+[![Python version support](https://img.shields.io/pypi/pyversions/zero2route3d-sdk.svg)](https://pypi.org/project/zero2route3d-sdk/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Code style: Ruff](https://img.shields.io/badge/code%20style-ruff-D7FF64.svg)](https://docs.astral.sh/ruff/)
+
+**zero2route3d-sdk** is a Python library for **3D spatial mobility modeling, biomechanical human kinematics, and multi-criteria routing analytics**.
+
+Built for urban planners, mobility researchers, and geospatial developers, it brings physiological human movement equations, terrain-aware 3D graph algorithms, and environmental microclimate impedance surfaces together into a pure-Python, headless package powered by NumPy and SciPy.
+
+---
+
+## 🌟 Key Capabilities
+
+1. **Biomechanical Kinematics & Energy Modeling:**
+   - Empirical slope-speed curves via **Tobler's hiking function** ($W(s) = 6.0 \cdot e^{-3.5|s+0.05|}$).
+   - Exact metabolic energy expenditure via **Minetti's 5th-order polynomial equations** ($J / (kg \cdot m)$).
+   - Aerodynamic drag, rolling resistance, and mechanical efficiency for commuter bikes, cargo bikes, and e-scooters.
+   - Universal Thermal Comfort Index (**UTCI**) and solar irradiance aspect factors.
+
+2. **15 Calibrated Mobility Profiles:**
+   - Pedestrian (*Adult, Senior, Child*).
+   - Universal accessibility (*Wheelchair ADA, Stroller*).
+   - Micromobility (*Commuter Bike, Cargo Bike, E-Bike, E-Scooter, Runner, Hiker*).
+   - Vehicles & Emergency (*Emergency EMS, Fire Truck, Logistics Van, Electric Car*).
+
+3. **Multi-Objective 4D Pareto Optimization (NAMOA*):**
+   - Finds non-dominated Pareto frontiers balancing **Travel Time, Cumulative Climb, Thermal Heat Dose, and Metabolic Calories**.
+
+4. **3D Topological Routing & Isochrones:**
+   - 3D graph construction with elevation draping, turn penalties, and barrier avoidance.
+   - Anisotropic 3D isochrone wavefront propagation.
+
+5. **3D Hidden Markov Model (HMM) Map Matching:**
+   - Robust Viterbi decoding matching noisy GPS/GPX tracks to 3D networks.
+
+6. **Micro-Elevation & Solar Ray-Tracing:**
+   - Keys' 16-point bicubic convolution spline interpolation with analytical $\mathcal{C}^1$ slope/aspect derivatives.
+   - Solar position calculation (azimuth/elevation) and building shadow casting.
+
+7. **Spatial Justice & Evacuation:**
+   - Enhanced 2-Step Floating Catchment Area (**E2SFCA**) healthcare/amenity accessibility.
+   - Gini coefficients, Lorenz curves, and Palma spatial equity ratios.
+   - Dynamic hazard zone evacuation routing and safe haven allocation.
+
+8. **Headless & Multi-Format I/O:**
+   - Runs everywhere: Jupyter Notebooks, FastAPI/Flask backends, Docker containers, CLI scripts.
+   - Exports to GeoJSON 3D, GPX 1.1, AutoCAD DXF (AC1009/AC1015) 3D Polylines, and standalone Three.js 60 FPS WebGL 3D Cockpit HTML bundles.
+
+---
+
+## 📦 Installation
+
+Install the core library from PyPI:
+
+```bash
+pip install zero2route3d-sdk
+```
+
+Or install with optional geospatial acceleration libraries:
+
+```bash
+pip install "zero2route3d-sdk[geo]"
+```
+
+---
+
+## 🚀 Quickstart
+
+### 1. High-Level One-Line Routing & Isochrones
+
+```python
+import zero2route3d as zr3d
+
+# Solve 3D Least-Cost Route in 1 line
+route = zr3d.solve_3d_route(
+    origin=(27.11, 38.41),
+    destination=(27.14, 38.44),
+    network="izmir_network.geojson",  # Or GeoDataFrame / list of RoadSegments
+    profile="wheelchair"              # 15 calibrated profiles
+)
+
+print(f"Distance: {route.statistics.total_distance_km:.2f} km")
+print(f"Duration: {route.statistics.total_duration_min:.1f} min")
+print(f"Climb: +{route.statistics.elevation_gain_m:.1f} m")
+
+# Save or display interactive 3D WebGL Cockpit
+route.to_html("route_viewer.html")
+
+# Plot publication-grade elevation & metabolic energy profile with Matplotlib
+route.plot(show_energy=True, save_path="profile.png")
+
+# Convert to 3D LineStringZ GeoDataFrame for GIS workflows
+gdf = route.to_geodataframe()
+```
+
+### 2. Multi-Objective 4D Pareto Frontier (NAMOA*)
+
+```python
+import zero2route3d as zr3d
+
+pareto_result = zr3d.solve_4d_pareto_frontier(
+    origin=(27.11, 38.41),
+    destination=(27.14, 38.44),
+    network="izmir_network.geojson",
+    profile="commuter_bike"
+)
+
+for idx, sol in enumerate(pareto_result.solutions, start=1):
+    print(f"Solution #{idx}: Time={sol.costs.time_sec/60:.1f}m, Climb={sol.costs.climb_m:.1f}m, Calories={sol.costs.calories_kcal:.0f}kcal")
+
+# Plot 2D Pareto trade-off curve
+zr3d.plot_pareto_frontier_2d(pareto_result, save_path="pareto_curve.png")
+```
+
+### 3. GeoPandas & NetworkX Ecosystem Bridges
+
+```python
+from zero2route3d import to_geodataframe, to_networkx_digraph, from_geodataframe
+import geopandas as gpd
+
+# Load standard GeoDataFrame of road centerlines
+gdf = gpd.read_file("streets.geojson")
+
+# Convert GeoDataFrame into 3D RoadSegment graph
+segments = from_geodataframe(gdf)
+
+# Convert 3D routing graph into NetworkX DiGraph with slope & kinematic weights
+nx_digraph = to_networkx_digraph(segments)
+```
+
+### 4. Command Line Interface (CLI)
+
+```bash
+# Inspect all 15 mobility profiles
+zero2route3d profiles
+
+# Run headless 3D route calculation from terminal
+zero2route3d route --origin 27.11,38.41 --dest 27.14,38.44 --network streets.geojson --profile wheelchair --out-geojson route.geojson --out-dxf route.dxf --out-html viewer.html
+
+# Compute 3D travel time isochrone bands
+zero2route3d isochrone --center 27.12,38.42 --intervals 5,10,15 --network streets.geojson --out-geojson isochrones.geojson
+```
+
+---
+
+## 📚 Mobility Profiles Catalog
+
+| Key | Profile Name | Base Speed | Max Slope | Stairs Policy | Target Use-Case |
+| :--- | :--- | :--- | :--- | :--- | :--- |
+| `adult` | Standard Adult | 5.0 km/h | 25.0% | Allowed (1.2×) | Everyday urban walking |
+| `senior` | Senior / Elderly | 3.2 km/h | 10.0% | Heavy Penalty (8.0×) | Age-friendly routing |
+| `child` | Child / Elementary | 3.8 km/h | 12.0% | Heavy Penalty (5.0×) | Safe routes to school |
+| `wheelchair` | Wheelchair ADA | 3.5 km/h | 5.0% | **Forbidden** (1000×) | Barrier-free ADA routing |
+| `stroller` | Stroller / Pram | 4.0 km/h | 8.0% | **Forbidden** (500×) | Family-friendly walking |
+| `cargo_bike` | Cargo Bike | 14.0 km/h | 8.0% | **Forbidden** (1000×) | Urban freight & logistics |
+| `commuter_bike`| Commuter Bike | 18.0 km/h | 15.0% | Heavy Penalty (20.0×) | Daily bicycle commuting |
+| `ebike` | Electric Assist Bike| 22.0 km/h | 22.0% | Heavy Penalty (20.0×) | Topography-immune cycling |
+| `escooter` | E-Scooter | 16.0 km/h | 10.0% | **Forbidden** (1000×) | First/last-mile micromobility |
+| `runner` | Jogger / Runner | 10.0 km/h | 30.0% | Allowed (1.0×) | Fitness & athletic routing |
+| `hiker` | Mountain Hiker | 4.5 km/h | 50.0% | Allowed (1.0×) | Trail & topographic hiking |
+| `emergency_ems`| Ambulance EMS | 50.0 km/h | 20.0% | **Forbidden** (1000×) | Rapid emergency response |
+| `emergency_fire`| Fire Engine Heavy | 40.0 km/h | 16.0% | **Forbidden** (1000×) | Heavy emergency vehicles |
+| `logistics_van`| Delivery Van | 45.0 km/h | 18.0% | **Forbidden** (1000×) | Courier & parcel delivery |
+| `electric_car` | Electric EV | 50.0 km/h | 25.0% | **Forbidden** (1000×) | Regenerative braking routing |
+
+---
+
+## 🧪 Development & Testing
+
+Clone the repository and install in editable mode:
+
+```bash
+git clone https://github.com/YusufEminoglu/zero2route3d_sdk.git
+cd zero2route3d_sdk
+pip install -e ".[dev]"
+```
+
+Run test suite with coverage:
+
+```bash
+pytest tests/ -v --cov=zero2route3d
+```
+
+Run linter and type checker:
+
+```bash
+ruff check .
+ruff format --check src tests
+mypy src
+```
+
+---
+
+## 📄 License & Citation
+
+Distributed under the **MIT License**. See `LICENSE` for details.
+
+If you use this library in scientific research, please cite:
+
+```bibtex
+@software{eminoglu2026zero2route3d,
+  author = {Eminoğlu, Yusuf},
+  title = {zero2route3d-sdk: Headless 3D spatial mobility, biomechanical human kinematics, and multi-criteria routing engine},
+  year = {2026},
+  url = {https://github.com/YusufEminoglu/zero2route3d_sdk}
+}
+```

zero2route3d_sdk-0.2.0/pyproject.toml

@@ -0,0 +1,129 @@
+[build-system]
+requires = ["setuptools>=61.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "zero2route3d-sdk"
+version = "0.2.0"
+authors = [
+    { name = "Yusuf Eminoğlu", email = "yusufeminoglu@gmail.com" }
+]
+description = "Headless 3D spatial mobility, biomechanical human kinematics, and multi-criteria routing engine."
+keywords = [
+    "gis",
+    "routing",
+    "shortest-path",
+    "isochrone",
+    "accessibility",
+    "walkability",
+    "mobility",
+    "kinematics",
+    "openstreetmap",
+    "dem",
+    "pareto",
+    "map-matching",
+]
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: OS Independent",
+    "Topic :: Scientific/Engineering :: GIS",
+    "Topic :: Scientific/Engineering :: Mathematics",
+    "Topic :: Scientific/Engineering :: Physics",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: Developers",
+]
+dependencies = [
+    "numpy>=1.20.0",
+    "scipy>=1.7.0",
+]
+
+[project.optional-dependencies]
+geo = [
+    "shapely>=2.0.0",
+    "rasterio>=1.3.0",
+    "geopandas>=0.12.0",
+    "networkx>=2.8.0",
+    "matplotlib>=3.5.0",
+]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "ruff>=0.1.0",
+    "mypy>=1.0.0",
+]
+
+[project.scripts]
+zero2route3d = "zero2route3d.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/YusufEminoglu/zero2route3d_sdk"
+Repository = "https://github.com/YusufEminoglu/zero2route3d_sdk"
+Issues = "https://github.com/YusufEminoglu/zero2route3d_sdk/issues"
+Documentation = "https://yusufeminoglu.github.io/zero2route3d/"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+zero2route3d = ["py.typed"]
+
+[tool.black]
+line-length = 100
+target-version = ['py39']
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+exclude = [
+    "scratch",
+    ".venv",
+    "build",
+    "dist",
+]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "B", "C4"]
+ignore = ["E501"]
+
+[tool.mypy]
+files = ["src"]
+
+[[tool.mypy.overrides]]
+module = [
+    "scipy.*",
+    "sklearn.*",
+    "shapely.*",
+    "rasterio.*",
+    "geopandas.*",
+    "networkx.*",
+    "matplotlib.*",
+    # QGIS and GDAL are optional, host-provided runtimes: every import of them in
+    # this package is lazy and guarded, and they are never installed in CI.
+    "qgis.*",
+    "osgeo.*",
+]
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+# Lets `pytest` run straight from a clone, without an editable install first.
+pythonpath = ["src"]
+
+[tool.coverage.run]
+source = ["zero2route3d"]
+branch = true
+
+[tool.coverage.report]
+show_missing = true
+fail_under = 50

zero2route3d_sdk-0.2.0/setup.cfg

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