可执行入口与数据重打包模块

本模块包含两个独立的可执行程序：一是 EROAM 事件SLAM系统的标准启动入口，二是 DVS 事件相机rosbag数据的离线预处理工具。核心解决两个痛点：一是统一系统初始化流程，避免每次运行时重复处理日志、ROS节点、核心模块初始化逻辑；二是原始DVS数据普遍存在坏点、事件块大小不统一、用户常需截取特定时间片段等问题，将数据预处理逻辑与核心SLAM系统解耦，减少运行时的冗余计算。

概述

本模块处于整个系统的边界位置，分为两个完全独立的分支，无内部依赖：

  1. eroam_run 是系统的运行时入口，仅负责初始化依赖组件和启动消息循环，不包含业务逻辑
  2. rosbag_repack 是离线数据预处理工具，输出标准化的事件数据集，供后续SLAM系统直接使用

二者的设计遵循严格的职责分离原则：运行时入口不包含任何数据预处理逻辑，预处理工具也不依赖核心SLAM模块的任何组件，确保两个程序可以独立编译、部署和修改。

架构说明

graph TD M[可执行入口与数据重打包模块] --> R[eroam_run 启动入口
src/eroam_run.cpp] M --> P[rosbag_repack 预处理工具
src/rosbag_repack.cpp] R --> E[EROAM 核心SLAM实例] E --> KD[点云与索引工具
[point_cloud_index.md]] P --> B[isBadPixel 坏点过滤] P --> S[时间切片/事件重打包] P --> O[预处理后rosbag输出] O --> E
  • eroam_run 作为启动入口，仅完成三方依赖初始化（glog、gflags、ROS），创建EROAM核心实例并启动ROS消息循环，所有业务逻辑均委托给核心SLAM模块处理
  • rosbag_repack 作为数据前处理工具，接收原始rosbag输入，完成坏点过滤、时间窗口截取、固定时长事件块重打包三个核心功能，输出标准化的事件数据集
  • 两个程序完全独立，无互相调用关系，仅通过预处理后的rosbag文件形成间接数据链路

核心设计决策

1. 职责二分的可执行文件拆分

将启动入口和预处理工具拆分为两个独立可执行文件，而非整合为单二进制文件的不同模式：

  • 收益：运行时入口体积小，依赖少，启动速度快；预处理工具不需要链接SLAM核心相关的大量依赖，编译部署更灵活
  • 权衡：无法实现运行时实时坏点过滤，但坏点是传感器固有属性，离线预处理一次即可重复使用，远高于每次运行时过滤的效率，符合当前业务场景需求
  • 证据：两个主函数分别位于独立的cpp文件，无共享代码（src/eroam_run.cpp、src/rosbag_repack.cpp）

2. 坏点过滤的set实现

坏点查找使用std::set<PixelCoord>实现O(log n)复杂度的查询：

  • 收益：不需要硬编码DVS传感器分辨率，支持任意数量的坏点配置，内存占用随坏点数量线性增长，对于常见的个位数坏点场景内存效率极高
  • 权衡：如果坏点数量超过1000个，2D数组的O(1)查询性能更高，但当前DVS传感器坏点通常不超过100个，set的性能完全满足需求
  • 证据：src/rosbag_repack.cpp 行70-82 坏点转换逻辑，行27-29 isBadPixel实现

3. 嵌套循环的goto退出

使用goto语句跳出多层循环实现达到处理时长上限时的快速退出：

  • 收益：相比多层布尔标志位判断，代码更简洁，无额外的条件判断开销，避免标志位遗漏导致的逻辑错误
  • 权衡：goto语句不符合通用编码规范，但此处是C++中跳出多层循环的公认合理场景，且跳转目标位于同一函数尾部，无逻辑跳跃问题
  • 证据：src/rosbag_repack.cpp 行139 goto finish_processing 逻辑

4. 全栈RAII资源管理

所有资源（rosbag句柄、内存容器、ROS节点）均使用栈分配+RAII管理：

  • 收益：无需手动释放资源，即使出现异常也不会产生资源泄漏，代码更简洁
  • 权衡：对于超大事件数据集，栈分配的事件向量可能存在栈溢出风险，但当前默认的分段时长通常为100ms，事件数量不会超过栈容量上限
  • 证据：两个主函数中所有对象均为栈分配，无raw new/delete调用

内存与对象语义

PixelCoord 结构体

  • 遵循Rule of Zero，编译器自动生成的拷贝/移动/析构函数完全符合需求
  • 值语义，拷贝时执行x/y的深拷贝，无隐藏副作用
  • 自定义<运算符用于set排序，排序逻辑为x优先，x相等时比较y，无特殊对齐要求

资源所有权

  • 所有容器（std::set<PixelCoord>、std::vector<dv_ros_msgs::Event>）均为main函数独占所有，随函数退出自动释放
  • isBadPixel函数接收const std::set<PixelCoord>&参数，为借用引用，不转移所有权，调用方需保证set在调用期间有效
  • rosbag::Bag实例通过RAII管理，自动在生命周期结束时关闭文件，无需手动调用close

错误处理

eroam_run

  • 无异常捕获逻辑，初始化失败时直接抛出未捕获异常终止程序
  • 设计意图：启动阶段失败为致命错误，直接暴露问题便于快速排查，无需容错
  • 证据：src/eroam_run.cpp 无try/catch块

rosbag_repack

  • 仅捕获rosbag::BagException异常，打印错误日志后返回非零退出码
  • 异常安全等级为基本保证：所有资源均为RAII管理，出现异常时无资源泄漏，但已写入的输出bag文件可能不完整
  • 参数错误处理：坏像素列表格式不正确时直接跳过，不抛出错误，仅生成空的坏点集合
  • 证据：src/rosbag_repack.cpp 行155-162 异常处理逻辑，行70-82 坏像素列表解析逻辑

端到端数据流

eroam_run 执行流程

  1. 接收命令行参数，初始化glog日志系统，配置日志输出格式和级别
  2. 解析gflags命令行参数
  3. 初始化ROS节点，创建全局NodeHandle
  4. 实例化eroam::EROAM对象，调用Init方法完成核心系统初始化（依赖点云与索引工具模块的KD树、数学工具等组件）
  5. 启动ros::spin()进入消息循环，处理所有订阅的传感器输入
  6. 收到ROS关闭信号后退出循环，打印结束日志并返回0

rosbag_repack 执行流程

  1. 从ROS参数服务器加载配置：输入输出bag路径、事件话题名、分段时长、开始时间偏移、处理时长上限、坏点列表
  2. 将坏点列表转换为std::set<PixelCoord>结构用于快速查询
  3. 打开输入输出bag文件
  4. 遍历输入bag中的所有消息：
    • 首次遇到事件消息时，计算实际处理的开始和结束时间
    • 跳过开始时间之前的事件，达到结束时间时直接退出处理
    • 调用isBadPixel过滤坏点事件
    • 按配置的分段时长累积事件，达到时长时生成新的EventArray消息写入输出bag
    • 非事件话题的消息默认不写入输出（代码已注释，可按需开启）
  5. 处理剩余未写入的事件，关闭bag文件，输出处理统计信息

常见开发陷阱

  1. 非事件话题的处理：src/rosbag_repack.cpp 行146-152 其他话题写入逻辑默认被注释，如需保留IMU、LiDAR等其他话题数据，需手动取消注释，同时确保这些消息的时间戳在处理时间窗口内
  2. 分段时间戳约定：重打包后的EventArray消息header时间戳为分段的起始时间，而非分段内第一个事件的时间，下游代码如果依赖header时间戳与第一个事件时间一致，会出现逻辑错误
  3. 时间偏移基准：start_time_offset参数是相对于bag中第一个事件的时间，而非bag文件的元数据起始时间，如果bag中前半段无事件，偏移计算逻辑会和预期不符
  4. 单线程运行限制：eroam_run使用单线程ros::spin()处理消息，如果事件处理耗时超过输入速率，会导致消息队列堆积，引入延迟。如需多线程处理，需替换为MultiThreadedSpinner，但必须先确认EROAM核心接口是线程安全的
  5. 坏点坐标约定：PixelCoord的x/y顺序与dv_ros_msgs的Event字段顺序一致，如果使用其他事件消息格式，需注意坐标顺序是否匹配，否则坏点过滤会失效

跨模块依赖

  • 本模块唯一的外部依赖是点云与索引工具模块，仅在eroam_run初始化EROAM核心时使用
  • rosbag_repack无内部模块依赖，仅依赖ROS和rosbag相关的三方库