# ekrrems/stereo-inertial-slam architecture

> Architecture diagram of the GitHub repository ekrrems/stereo-inertial-slam, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ekrrems/stereo-inertial-slam
- Repository: https://github.com/ekrrems/stereo-inertial-slam

## Overview

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: [`src/main.cpp`](https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/main.cpp) (Dataset runner), [`src/StereoFrontend.cpp`](https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/StereoFrontend.cpp) (Stereo frontend), [`src/Evaluation.cpp`](https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/Evaluation.cpp) (Trajectory evaluation), [`src/LoopClosing.cpp`](https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/LoopClosing.cpp) (Loop closure)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_input["Input"]
  node_runner["Dataset runner<br/>[main.cpp]"]
  node_loader["Dataset loader<br/>[Dataloader.cpp]"]
end

subgraph group_slam["Visual SLAM"]
  node_frontend["Stereo frontend<br/>[StereoFrontend.cpp]"]
  node_localba["Local bundle adjustment"]
  node_loop["Loop closure<br/>[LoopClosing.cpp]"]
  node_posegraph["Pose graph<br/>[PoseGraph.cpp]"]
  node_dense["Dense mapper<br/>[DenseMapper.cpp]"]
  node_icp["Dense ICP<br/>[IcpAligner.cpp]"]
end

subgraph group_fusion["Inertial Fusion"]
  node_fusion["VIO fusion"]
  node_estimator["ESKF estimator<br/>[Estimator.cpp]"]
end

subgraph group_outputs["Maps and Evaluation"]
  node_mapexport["Map export<br/>[MapExport.cpp]"]
  node_mapviewer["Map viewer<br/>[MapViewer.cpp]"]
  node_trajectoryviewer["Trajectory viewer"]
  node_evaluation["Trajectory evaluation<br/>[Evaluation.cpp]"]
  node_artifacts["Maps and trajectories"]
end

node_dataset(("KITTI data"))
node_groundtruth["OXTS ground truth"]

node_dataset -->|"provides frames"| node_loader
node_runner -->|"reads events"| node_loader
node_runner -->|"processes stereo"| node_frontend
node_runner -->|"feeds IMU and poses"| node_fusion
node_runner -->|"evaluates trajectories"| node_evaluation
node_frontend -->|"optimizes keyframes"| node_localba
node_frontend -->|"checks keyframes"| node_loop
node_loop -->|"optimizes poses"| node_posegraph
node_frontend -->|"builds keyframe clouds"| node_dense
node_frontend -->|"aligns clouds"| node_icp
node_frontend -->|"adds ICP constraints"| node_localba
node_runner -->|"records filter stats"| node_estimator
node_fusion -->|"propagates and updates"| node_estimator
node_frontend -->|"exports map data"| node_mapexport
node_runner -->|"updates display"| node_mapviewer
node_runner -.->|"visualizes trajectory"| node_trajectoryviewer
node_runner -->|"writes trajectories"| node_artifacts
node_mapexport -->|"writes map files"| node_artifacts
node_evaluation -->|"loads OXTS poses"| node_groundtruth
node_evaluation -->|"writes metrics and plots"| node_artifacts

click node_runner "https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/main.cpp"
click node_loader "https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/Dataloader.cpp"
click node_frontend "https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/StereoFrontend.cpp"
click node_localba "https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/LocalBundleAdjuster.cpp"
click node_loop "https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/LoopClosing.cpp"
click node_posegraph "https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/PoseGraph.cpp"
click node_dense "https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/DenseMapper.cpp"
click node_icp "https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/IcpAligner.cpp"
click node_fusion "https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/VisualInertialFusion.cpp"
click node_estimator "https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/Estimator.cpp"
click node_mapexport "https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/MapExport.cpp"
click node_mapviewer "https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/MapViewer.cpp"
click node_trajectoryviewer "https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/TrajectoryViewer.cpp"
click node_evaluation "https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/Evaluation.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_runner,node_loader toneBlue
class node_frontend,node_localba,node_loop,node_posegraph,node_dense,node_icp toneAmber
class node_fusion,node_estimator toneMint
class node_mapexport,node_mapviewer,node_trajectoryviewer,node_evaluation,node_artifacts toneRose
class node_dataset,node_groundtruth toneIndigo
```

## Components

### Input

- [Dataset runner](https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/main.cpp): `src/main.cpp`
- [Dataset loader](https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/Dataloader.cpp): `src/Dataloader.cpp`

### Visual SLAM

- [Stereo frontend](https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/StereoFrontend.cpp): `src/StereoFrontend.cpp`
- [Local bundle adjustment](https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/LocalBundleAdjuster.cpp): `src/LocalBundleAdjuster.cpp`
- [Loop closure](https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/LoopClosing.cpp): `src/LoopClosing.cpp`
- [Pose graph](https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/PoseGraph.cpp): `src/PoseGraph.cpp`
- [Dense mapper](https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/DenseMapper.cpp): `src/DenseMapper.cpp`
- [Dense ICP](https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/IcpAligner.cpp): `src/IcpAligner.cpp`

### Inertial Fusion

- [VIO fusion](https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/VisualInertialFusion.cpp): `src/VisualInertialFusion.cpp`
- [ESKF estimator](https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/Estimator.cpp): `src/Estimator.cpp`

### Maps and Evaluation

- [Map export](https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/MapExport.cpp): `src/MapExport.cpp`
- [Map viewer](https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/MapViewer.cpp): `src/MapViewer.cpp`
- [Trajectory viewer](https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/TrajectoryViewer.cpp): `src/TrajectoryViewer.cpp`
- [Trajectory evaluation](https://github.com/ekrrems/stereo-inertial-slam/blob/main/src/Evaluation.cpp): `src/Evaluation.cpp`
- **Maps and trajectories**

### Other components

- **KITTI data**
- **OXTS ground truth**

## Connections

- KITTI data → Dataset loader: provides frames (evidence: `README.md`)
- Dataset runner → Dataset loader: reads events (evidence: `src/main.cpp`)
- Dataset runner → Stereo frontend: processes stereo (evidence: `src/main.cpp`)
- Dataset runner → VIO fusion: feeds IMU and poses (evidence: `src/main.cpp`)
- Dataset runner → Trajectory evaluation: evaluates trajectories (evidence: `src/main.cpp`)
- Stereo frontend → Local bundle adjustment: optimizes keyframes (evidence: `src/StereoFrontend.cpp`)
- Stereo frontend → Loop closure: checks keyframes (evidence: `src/StereoFrontend.cpp`)
- Loop closure → Pose graph: optimizes poses (evidence: `src/LoopClosing.cpp`)
- Stereo frontend → Dense mapper: builds keyframe clouds (evidence: `README.md`)
- Stereo frontend → Dense ICP: aligns clouds
- Stereo frontend → Local bundle adjustment: adds ICP constraints
- Dataset runner → ESKF estimator: records filter stats (evidence: `src/main.cpp`)
- VIO fusion → ESKF estimator: propagates and updates
- Stereo frontend → Map export: exports map data (evidence: `README.md`)
- Dataset runner → Map viewer: updates display (evidence: `src/main.cpp`)
- Dataset runner → Trajectory viewer: visualizes trajectory
- Dataset runner → Maps and trajectories: writes trajectories (evidence: `src/main.cpp`)
- Map export → Maps and trajectories: writes map files (evidence: `README.md`)
- Trajectory evaluation → OXTS ground truth: loads OXTS poses
- Trajectory evaluation → Maps and trajectories: writes metrics and plots
