How isthisit123/ai-valet-parking-rover works
Q-ROVER’s implemented product is the map-processing and route-planning portion of an AI valet-parking rover, not the planned rover-control system. The principal workflow detects roads in a parking-map image, builds a pixel-weighted road graph, attaches labeled facilities and parking spaces, selects a space by preference, then exports route images and pixel waypoints. Calibration supports converting measured hints to image pixels. Edges reflect README-documented stage inputs and sampled calls; rover control, camera localization, and YOLO occupancy are planned or parallel work, not implemented here.
Main entry points: map_reader.py Road Detection · semantic_mapper.py Facility Mapping · map_config.py Map Configuration · graph_exporter.py Road Graph Export
Components 15
Map Input
- Map and Labels
assets/maps - Map Configuration
src/map_processing/map_config.py - Road Detection
src/map_processing/map_reader.py
Map Modeling
- Road Skeleton
src/map_processing/graph_builder.py - Road Graph Export
src/map_processing/graph_exporter.py - Road Graph JSON
data/maps/parking_map_real/graph.json - Facility Mapping
src/map_processing/semantic_mapper.py - Semantic Map JSON
data/maps/parking_map_real/semantic.json
Parking Routes
- Space Selection
src/map_processing/parking_selector.py - Route Export
src/map_processing/path_visualizer.py - Route Waypoints
data/maps/parking_map_real/routes
Planar Calibration
- Homography Calibration
src/map_processing/planar_calibration.py
Other components
- Map Operator
- Q-ROVER
- YOLO Occupancy
Connections 20
- Map Operator → Map Configuration: selects map
README.md - Map and Labels → Road Detection: supplies image
README.md - Map Configuration → Road Detection: configures input
src/map_processing/map_reader.py - Road Detection → Road Skeleton: provides mask
src/map_processing/graph_builder.py - Road Skeleton → Road Graph Export: provides skeleton
src/map_processing/graph_exporter.py - Road Detection → Road Graph Export: provides road mask
src/map_processing/graph_exporter.py - Map Configuration → Road Graph Export: configures output
src/map_processing/graph_exporter.py - Road Graph Export → Road Graph JSON: writes graph
README.md - Road Graph JSON → Facility Mapping: reads graph
README.md - Map and Labels → Facility Mapping: supplies labels
README.md - Map Configuration → Facility Mapping: configures paths
src/map_processing/semantic_mapper.py - Homography Calibration → Facility Mapping: converts hints
src/map_processing/semantic_mapper.py - Facility Mapping → Semantic Map JSON: writes semantics
README.md - Semantic Map JSON → Space Selection: loads map
src/map_processing/parking_selector.py - Space Selection → Route Export: selects destination
src/map_processing/path_visualizer.py - Semantic Map JSON → Route Export: loads map
src/map_processing/path_visualizer.py - Road Detection → Route Export: checks road mask
src/map_processing/path_visualizer.py - Route Export → Route Waypoints: writes routes
README.md - Route Waypoints → Q-ROVER: planned waypoints
README.md - YOLO Occupancy → Space Selection: planned occupancy
README.md