How orurh/causal_slam works
Causal-SLAM is an experimental temporal-integrity and gating layer for LiDAR/IMU SLAM, not a mapping estimator. Its main live workflow adapts ROS sensor/TF input, analyzes timing and coverage, builds diagnostics and a map-update decision, then publishes health and checked LiDAR for a downstream estimator. A separate rosbag2 workflow analyzes recorded data and produces reports; session tooling supports bag discovery and repeatable analysis setup. The README documents these capabilities, while several application and rendering implementations were not excerpted, so those links are documented rather than inferred from unsampled code.
Main entry points: temporal_monitor_pipeline.cc Monitor Pipeline · temporal_monitor_node.cc Live Monitor · temporal_report_builder.cc Report Builder · analyze_bag_app.cc Bag Analyzer
Components 19
ROS Interfaces
- Live Monitor
src/apps/ros2/temporal_monitor_node.cc - Checked LiDAR
src/apps/ros2/temporal_monitor_node.cc - Session Tools
src/apps/ros2/session_app.cc
Temporal Analysis
- Monitor Pipeline
src/application/temporal_monitor/temporal_monitor_pipeline.cc - Stream Timing
src/domain/telemetry/stream_timing_tracker.cc - Scan Window
src/domain/sensors/lidar/lidar_scan_window_estimator.cc - Point Time
src/domain/sensors/pointcloud/point_cloud2_time_field_extractor.cc - IMU Coverage
src/domain/sensors/imu/imu_coverage_analyzer.cc - Transform Age
src/domain/sensors/transform/transform_age_analyzer.cc - Offline Analysis
src/application/offline_analysis/offline_stream_timing_fault_analyzer.cc
Offline Evidence
- Bag Analyzer
src/apps/ros2/analyze_bag_app.cc - Report Builder
src/presentation/report/temporal_report_builder.cc - JSON Report
src/presentation/render/offline_temporal_report_json_renderer.cc - HTML Report
src/presentation/render/offline_temporal_report_html_renderer.cc
Decisions and Reports
- Temporal Diagnostics
src/domain/diagnostics/temporal_diagnostics.cc - Map Update Policy
src/domain/policy/map_update_decision.h
Other components
- LiDAR / IMU / TF
- SLAM / LIO
- Rosbag2 Input
Connections 20
- LiDAR / IMU / TF → Live Monitor: feeds
README.md - Live Monitor → Monitor Pipeline: observes data
- Monitor Pipeline → Stream Timing: tracks timing
- Monitor Pipeline → Scan Window: estimates window
- Monitor Pipeline → Point Time: extracts point time
- Monitor Pipeline → IMU Coverage: checks coverage
src/application/temporal_monitor/temporal_monitor_pipeline.cc - Monitor Pipeline → Transform Age: analyzes transforms
- Monitor Pipeline → Temporal Diagnostics: builds snapshot
src/application/temporal_monitor/temporal_monitor_pipeline.cc - Monitor Pipeline → Map Update Policy: builds decision
- Live Monitor → Checked LiDAR: forwards checked data
README.md - Checked LiDAR → SLAM / LIO: feeds estimator
README.md - Live Monitor → Temporal Diagnostics: publishes health
README.md - Live Monitor → Map Update Policy: publishes decision
README.md - Rosbag2 Input → Bag Analyzer: provides recording
README.md - Bag Analyzer → Offline Analysis: runs analysis
README.md - Offline Analysis → Report Builder: supplies evidence
README.md - Bag Analyzer → Report Builder: builds report
README.md - Report Builder → JSON Report: renders JSON
README.md - Report Builder → HTML Report: optionally renders HTML
README.md - Session Tools → Rosbag2 Input: discovers and plays
src/apps/ros2/session_app.cc