How ekrrems/stereo-inertial-slam works
RigVis is a KITTI-oriented stereo-inertial SLAM application. Its main workflow loads synchronized stereo and IMU events, estimates visual motion and a sparse map, optionally fuses IMU motion, then corrects keyframe poses through loop closure and exports trajectories/maps for evaluation. The graph preserves the documented dense-mapping and visualization branches. Some subsystem calls are documented in the README or headers but their full implementations were not excerpted, so uncertain connections are omitted.
Main entry points: main.cpp Dataset runner · StereoFrontend.cpp Stereo frontend · Evaluation.cpp Trajectory evaluation · LoopClosing.cpp Loop closure
Components 17
Input
- Dataset runner
src/main.cpp - Dataset loader
src/Dataloader.cpp
Visual SLAM
- Stereo frontend
src/StereoFrontend.cpp - Local bundle adjustment
src/LocalBundleAdjuster.cpp - Loop closure
src/LoopClosing.cpp - Pose graph
src/PoseGraph.cpp - Dense mapper
src/DenseMapper.cpp - Dense ICP
src/IcpAligner.cpp
Inertial Fusion
- VIO fusion
src/VisualInertialFusion.cpp - ESKF estimator
src/Estimator.cpp
Maps and Evaluation
- Map export
src/MapExport.cpp - Map viewer
src/MapViewer.cpp - Trajectory viewer
src/TrajectoryViewer.cpp - Trajectory evaluation
src/Evaluation.cpp - Maps and trajectories
Other components
- KITTI data
- OXTS ground truth
Connections 20
- KITTI data → Dataset loader: provides frames
README.md - Dataset runner → Dataset loader: reads events
src/main.cpp - Dataset runner → Stereo frontend: processes stereo
src/main.cpp - Dataset runner → VIO fusion: feeds IMU and poses
src/main.cpp - Dataset runner → Trajectory evaluation: evaluates trajectories
src/main.cpp - Stereo frontend → Local bundle adjustment: optimizes keyframes
src/StereoFrontend.cpp - Stereo frontend → Loop closure: checks keyframes
src/StereoFrontend.cpp - Loop closure → Pose graph: optimizes poses
src/LoopClosing.cpp - Stereo frontend → Dense mapper: builds keyframe clouds
README.md - Stereo frontend → Dense ICP: aligns clouds
- Stereo frontend → Local bundle adjustment: adds ICP constraints
- Dataset runner → ESKF estimator: records filter stats
src/main.cpp - VIO fusion → ESKF estimator: propagates and updates
- Stereo frontend → Map export: exports map data
README.md - Dataset runner → Map viewer: updates display
src/main.cpp - Dataset runner → Trajectory viewer: visualizes trajectory
- Dataset runner → Maps and trajectories: writes trajectories
src/main.cpp - Map export → Maps and trajectories: writes map files
README.md - Trajectory evaluation → OXTS ground truth: loads OXTS poses
- Trajectory evaluation → Maps and trajectories: writes metrics and plots