企业官网建设流程全解析

RKO-LIO 是一个无需传感器特定建模的 LiDAR 惯性里程计（LiDAR-Inertial Odometry）系统，它的 ROS2 离线模式（offline mode）可以直接以全速"抽干"一个 rosbag 而不受墙钟节拍限制，比ros2 bag play快得多，还自带rko_lio/bag_progress主题实时汇报回放百分比与预计剩余时间（ETA）。本文带你从安装到监控，完整走通 RKO-LIO 的 rosbag 全速回放流程。

为什么离线模式比 ros2 bag play 更快？

常规的ros2 bag play会按采集时的时间戳节拍回放，一段 1 小时的数据就得等 1 小时。而 RKO-LIO 的离线模式直接读取 bag 文件、以 CPU 能跑多快就跑多快的速度处理，适合：

• 🔄 快速验证外参与配置改动对轨迹的影响
• 🧪 批量回测不同数据集
• 📊 离线分析里程计输出，无需真机在线

离线节点复用了在线的线程化管线（rko_lio/ros/threaded_node.hpp），每帧点云依次经过去畸变、下采样、数据关联与迭代优化：

当点云缓冲区写满时，bag 读取线程会被短暂限流（见 rko_lio/ros/offline_node.cpp），此时终端打印一条Lidar buffer size ... throttling the bag reading thread的警告属于正常现象，不用紧张。

一键安装 RKO-LIO

支持 Humble、Jazzy、Kilted、Lyrical、Rolling 五个 ROS2 发行版。最简单的方式是装预编译包：

sudo apt install ros-$ROS_DISTRO-rko-lio

如果想从源码构建，把仓库克隆进 colcon 工作区的src目录后构建即可（依赖可走 rosdep 或 CMake FetchContent 两种方式）：

git clone https://gitcode.com/gh_mirrors/rk/rko_lio src/rko_lio rosdep install --from-paths src --ignore-src -r -y colcon build --packages-select rko_lio

若 rosdep 装不齐依赖，也可以构建时让 CMake 自动拉取：

colcon build --packages-select rko_lio --cmake-args -DRKO_LIO_FETCH_CONTENT_DEPS=ON

全速启动：一条 launch 命令搞定

一切入口都是 launch/odometry.launch.py。启动时加上mode:=offline与bag_path:=（指向包含.mcap/.db3的 bag 目录）即可进入全速回放：

ros2 launch rko_lio odometry.launch.py \ mode:=offline \ bag_path:=/path/to/rosbag/directory

默认开启autodetect:=true，会从 bag 里自动推断imu_topic、lidar_topic和base_frame。想手动指定话题时，至少给出这三个参数：

ros2 launch rko_lio odometry.launch.py \ autodetect:=false \ imu_topic:=/your/imu lidar_topic:=/your/lidar base_frame:=base \ mode:=offline bag_path:=/path/to/rosbag/directory

参数也可以全部写进 YAML 配置文件后用config_file:=传入（命令行参数优先），仓库自带一份默认参数清单 config/ros_default.yaml 可以参考。

离线模式关键参数速查

用 bag_progress 主题实时监控回放进度

离线节点每处理一条 bag 消息，就会在rko_lio/bag_progress主题上发布一次进度（实现见 rko_lio/ros/offline_node.cpp）。消息类型为std_msgs/msg/Float32MultiArray，包含两个值：

• percent_complete：已处理百分比（0~100）
• seconds_remaining：按当前平均处理速度估算的剩余秒数

开一个新终端就能看到进度条式输出：

ros2 topic echo /rko_lio/bag_progress

data: - 12.34 - 145.2 --- data: - 37.8 - 98.6 ---

百分比的分母是 bag 中 IMU + 激光话题的消息总数（见 rko_lio/ros/utils/rosbag.cpp），所以长 bag 也能准确预估还剩多久，跑长数据前再也不用"盲等"了。

数据要求：bag 里最好有 TF 树

离线模式不订阅实时话题，TF 直接从 bag 里读：/tf_static会在启动时一次性预加载，/tf则随回放流式摄入（见 rko_lio/ros/utils/rosbag.cpp）。因此请确保录制 bag 时把 TF 树一起录进去了——TF 正常的话，IMU 与激光的外参会自动通过 TF 查找解析，无需额外配置。

如果 bag 里没有 TF，则需要在配置文件里显式给出两组外参（缺一不可）：

extrinsic_imu2base_quat_xyzw_xyz: [0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0] extrinsic_lidar2base_quat_xyzw_xyz: [0.0, 0.0, 0.0, 1.0, 0.1, 0.0, 0.05]

格式为[qx, qy, qz, qw, x, y, z]。另外，如果你的平台启动时处于静止状态，建议加上initialization_phase:=true，用前两帧之间的 IMU 数据初始化俯仰/横滚与 IMU 偏置，在斜坡上起步时改善明显。

常见问题排查 ⚠️

1. 报Cannot classify LiDAR timestamps as absolute or relative：点云逐点时间戳启发式判断失败。用lidar_timestamps.force_absolute、lidar_timestamps.force_relative强制指定，或用lidar_timestamps.multiplier_to_seconds指定原始时间戳单位换算系数（如微秒设1.0e-6）。
2. odom_at_imu_rate:=true在离线模式下无效：IMU 频率里程计只属于在线 seq 管线，与mode:=offline同传时启动文件会打印警告并回退到异步离线管线。
3. bag 开头的静止段/标定段不想处理：传skip_first_seconds:=5.0，读取器会直接seek到 bag 起点偏移 5 秒处。
4. autodetect 猜错话题：多个sensor_msgs/msg/Imu或sensor_msgs/msg/PointCloud2话题并存时自动推断会失败并列出候选项，此时改为autodetect:=false手动指定即可。

处理完成后，轨迹与配置可以用dump_results:=true导出到results_dir供离线分析，配合数据集评测图可以直观检查效果：

相关文件索引

掌握mode:=offline+bag_path:=+bag_progress这三件套，你就能在 ROS2 下把数小时的 rosbag 以全速跑完，并随时知道"还剩几分钟"。