How ghm0819/erpot works
ERPoT is a ROS-based mobile-robot localization system built around compact polygon maps. Its main workflow converts LiDAR point clouds into obstacle scans, tracks pose against a prepared polygon map, and publishes results for visualization. A separate map-building workflow creates a grid map from scans and poses, then converts that grid into polygons. The graph includes these documented product stages and the sampled map-association and optimization layers; some runtime wiring is documented only at a high level, so uncertain connections are omitted.
Main entry points: feature_association.cpp Feature association · entrance_tracking.cpp Tracking entry · slam_karto.cpp Karto SLAM · map.cpp Polygon map model
Components 19
LiDAR perception
- Obstacle node
src/entrance_obstacle.cpp - Ground segmentation
nearest_obstacle/nearest_obstacle.cpp - Obstacle scan
nearest_obstacle/scan_point.h
Map construction
- Grid map
map - Polygon-map generator
src/entrance_polygon.cpp - Polygon map
map
Pose tracking
- Tracking entry
src/entrance_tracking.cpp - Polygon map model
feature_association/map.cpp - Map geometry
feature_association/vertex.h - Feature association
feature_association/feature_association.cpp - Scan factors
scan_factor/scan_factor.hpp - Tracked pose
src/entrance_tracking.cpp
Grid mapping
- Grid-map entry
src/entrance_gridmap.cpp - Karto SLAM
slam_karto/slam_karto.cpp - Scan mapper
slam_karto/Mapper.cpp - Pose graph solver
slam_karto/spa_solver.cpp
Other components
- Robot LiDAR
- RViz viewer
- KITTI loader
src/kitti_loader.cpp
Connections 18
- Robot LiDAR → Obstacle node: sends clouds
README.md - Obstacle node → Ground segmentation: processes clouds
- Ground segmentation → Obstacle scan: extracts obstacles
nearest_obstacle/nearest_obstacle.cpp - Robot LiDAR → Grid-map entry: provides scans
README.md - Grid-map entry → Karto SLAM: starts mapping
src/entrance_gridmap.cpp - Karto SLAM → Scan mapper: uses mapper
- Scan mapper → Pose graph solver: uses solver
- Karto SLAM → Grid map: builds grid
- Grid map → Polygon-map generator: converts grid
README.md - Polygon-map generator → Polygon map: writes polygons
src/entrance_polygon.cpp - Robot LiDAR → Tracking entry: supplies LiDAR
README.md - Tracking entry → Feature association: runs tracking
- Tracking entry → Polygon map model: loads map
- Polygon map model → Map geometry: builds associations
- Feature association → Polygon map model: requests associations
- Feature association → Scan factors: uses residuals
- Feature association → Tracked pose: estimates pose
- Tracked pose → RViz viewer: visualizes pose
README.md