How chen-liu520/hnurm26_fastlivo2_ros2 works
This repository combines FAST-LIVO2 ROS 2 LiDAR-inertial-visual mapping with a Livox sensor driver. The principal workflow is sensor data entering the driver, being converted to ROS point-cloud messages, then consumed by the mapper for state estimation and map/pose output. The README additionally documents MID360 vehicle-angle filtering and a low-performance launch option. Mapper internals and launch wiring are only partly sampled, so uncertain subsystem links are marked dashed rather than treated as verified calls.
Main entry points: LIVMapper.cpp LIV Mapper · livox_lidar_callback.cpp Lidar Callback · pub_handler.cpp Packet Processing · lddc.cpp Data Distribution
Components 15
Livox Driver
- Driver Node
src/livox_ros_driver2/livox_ros_driver2/src/driver_node.cpp - Lidar Callback
src/livox_ros_driver2/livox_ros_driver2/src/call_back/livox_lidar_callback.cpp - Packet Processing
src/livox_ros_driver2/livox_ros_driver2/src/comm/pub_handler.cpp - Data Distribution
src/livox_ros_driver2/livox_ros_driver2/src/lddc.cpp - ROS Point Clouds
src/livox_ros_driver2/livox_ros_driver2/src/lddc.cpp
FAST-LIVO2 Mapping
- Mapper Entry
src/FAST-LIVO2/src/main.cpp - LIV Mapper
src/FAST-LIVO2/src/LIVMapper.cpp - Mapping Profiles
src/FAST-LIVO2/launch/low_mid360.launch.py
Estimation Layers
- Sensor Preprocessing
src/FAST-LIVO2/src/preprocess.cpp - IMU Processing
src/FAST-LIVO2/src/IMU_Processing.cpp - Visual Odometry
src/FAST-LIVO2/src/vio.cpp - Voxel Map
src/FAST-LIVO2/src/voxel_map.cpp
ROS Outputs
- Mapping Publishers
src/FAST-LIVO2/src/LIVMapper.cpp
Other components
- Livox Sensor
- ROS Consumers
Connections 14
- Livox Sensor → Lidar Callback: sends packets
- Lidar Callback → Packet Processing: dispatches packets
- Packet Processing → Data Distribution: provides point data
- Data Distribution → ROS Point Clouds: publishes clouds
src/livox_ros_driver2/livox_ros_driver2/src/lddc.cpp - Driver Node → Lidar Callback: registers callbacks
- Mapper Entry → LIV Mapper: initializes and runs
src/FAST-LIVO2/src/main.cpp - LIV Mapper → Sensor Preprocessing: uses preprocessing
- LIV Mapper → IMU Processing: uses IMU processing
- LIV Mapper → Visual Odometry: uses visual odometry
- LIV Mapper → Voxel Map: uses voxel mapping
- LIV Mapper → Mapping Publishers: publishes results
- ROS Point Clouds → LIV Mapper: feeds sensor topics
- Mapping Publishers → ROS Consumers: publishes ROS results
- Mapping Profiles → Mapper Entry: configures launch