How ethz-asl/okvis works
OKVIS is a keyframe-based visual-inertial SLAM/odometry system. Its principal workflow ingests timestamped camera and IMU data, synchronizes and processes frames, tracks features and initializes landmarks, then optimizes a sliding-window state and reports poses, velocity, and IMU biases. The README also documents configurable camera/IMU calibration and a synchronous dataset demo. The excerpts expose parts of orchestration and optimization; links for unsampled subsystems are limited to the documented workflow.
Main entry points: ThreadedKFVio.cpp Threaded VIO · Estimator.cpp Window estimator · okvis_app_synchronous.cpp Synchronous demo · Frontend.cpp Feature frontend
Components 19
Inputs and calibration
- Parameter reader
okvis_common/src/VioParametersReader.cpp - Camera models
okvis_cv/include/okvis/cameras/NCameraSystem.hpp
Visual frontend
- Frame containers
okvis_cv/include/okvis/MultiFrame.hpp - Feature frontend
okvis_frontend/src/Frontend.cpp - Dense matcher
okvis_matcher/src/DenseMatcher.cpp - Stereo triangulation
okvis_frontend/src/ProbabilisticStereoTriangulator.cpp
State estimation
- Window estimator
okvis_ceres/src/Estimator.cpp - Optimization map
okvis_ceres/src/Map.cpp - Measurement errors
okvis_ceres/include/okvis/ceres/ImuError.hpp - Window marginalization
okvis_ceres/src/MarginalizationError.cpp
Processing and outputs
- Synchronous demo
okvis_apps/src/okvis_app_synchronous.cpp - VIO interface
okvis_common/include/okvis/VioInterface.hpp - Threaded VIO
okvis_multisensor_processing/src/ThreadedKFVio.cpp - Frame synchronizer
okvis_multisensor_processing/src/FrameSynchronizer.cpp - IMU synchronizer
okvis_multisensor_processing/src/ImuFrameSynchronizer.cpp - VIO visualizer
okvis_multisensor_processing/src/VioVisualizer.cpp
Other components
- Sensor dataset
- Estimator config
- Pose and motion state
Connections 23
- Sensor dataset → Synchronous demo: supplies measurements
- Estimator config → Parameter reader: provides settings
- Synchronous demo → Parameter reader: loads config
- Synchronous demo → VIO interface: starts processing
- Parameter reader → Camera models: configures cameras
- Parameter reader → VIO interface: provides parameters
- VIO interface → Threaded VIO: delegates processing
- Synchronous demo → Threaded VIO: submits sensor data
- Threaded VIO → Frame synchronizer: synchronizes frames
- Threaded VIO → IMU synchronizer: synchronizes IMU
- Frame synchronizer → Frame containers: forms multiframes
- Threaded VIO → Feature frontend: processes frames
- Feature frontend → Dense matcher: matches features
- Feature frontend → Stereo triangulation: initializes landmarks
- Threaded VIO → Window estimator: runs optimization
- Feature frontend → Window estimator: updates visual states
- Window estimator → Optimization map: maintains optimization map
- Window estimator → Measurement errors: adds residuals
- Window estimator → Window marginalization: marginalizes window
- Window estimator → Pose and motion state: reports estimates
- Threaded VIO → VIO visualizer: publishes visualization
- VIO visualizer → Pose and motion state: displays estimates
- Pose and motion state → Synchronous demo: returns via callbacks