AirVO 开源项目安装与使用指南

AirVO 是一个升级至 AirSLAM 的视觉里程计系统，旨在处理短期与长期光照变化挑战。本指南将引导您了解项目结构、启动文件与配置文件的详情，帮助您顺利进行部署与应用。

1. 项目目录结构及介绍

AirVO 项目的目录结构精心设计以支持清晰的代码组织和易于维护：

• 3rdparty: 包含第三方库或依赖项。
• cmake: CMake 配置文件，用于构建系统。
• configs: 含有系统运行所需的配置文件，对性能调优至关重要。
• demo: 示例数据或演示脚本，帮助理解如何使用项目。
• figures: 可视化结果或示意图。
• include: 头文件目录，存放自定义的数据结构和函数声明。
• launch: ROS（Robot Operating System）相关的启动文件，用于启动不同的系统组件。
• output: 运行时产生的输出数据，如日志或结果。
• rviz: RVIZ 相关配置，用于可视化SLAM过程。
• scripts: 脚本文件，执行特定任务，比如数据预处理等。
• src: 源代码主体，包括算法实现。
• voc: 关于 Vocabulary 或特征字典相关的内容。
• .gitignore, CMakeLists.txt, LICENSE, README.md, package.xml: 标准的Git、构建和元数据文件。

2. 项目的启动文件介绍

AirVO 使用ROS作为其后台框架，因此启动文件通常位于launch目录下。这些.launch文件负责启动不同服务和节点，例如视觉里程计(vo_euroc.launch)、地图优化(mr_euroc.launch)和重定位(reloc_euroc.launch)。以vo_euroc.launch为例，它用于启动基于EuRoC数据集的视觉里程计过程。用户需修改此文件中的路径设置，如dataroot和saving_dir，以匹配自己的数据位置和期望的保存路径。

3. 项目的配置文件介绍

配置文件主要存放在configs目录中，每个文件都针对系统的不同方面提供参数设置。这些配置文件允许用户调整算法行为，包括但不限于摄像头参数、特征检测阈值、优化策略等。在部署过程中，重要的是要检查并根据实际需求调整以下几类配置：

• 相机参数: 如分辨率、帧率等，通常位于特定的配置文件内。
• SLAM参数: 包括关键帧选择准则、地图管理策略等。
• TensorRT加速配置: 若项目利用了NVIDIA TensorRT加速，可能需要调整模型的加载和优化选项。

配置文件使用实例

在实际应用中，您需将Configs/camera.yaml中的摄像机参数替换为您的设备信息，并调整Configs/plnet.yaml来优化点线特征网络的运行配置。

编译与启动步骤简述

1. 克隆项目:

   git clone https://github.com/xukuanHIT/AirVO.git
   

2. 编译项目: 在ROS工作空间的src目录下执行：

   cd ~/catkin_ws/src
   # 克隆后切换到正确目录（假设命令中有误，正确的操作应指向刚克隆的目录）
   cd AirVO
   catkin_make
   

3. 环境准备:

   source ~/catkin_ws/devel/setup.bash
   

之后，通过修改对应的launch文件中的参数，并使用roslaunch命令启动相应功能，即可运行视觉里程计、地图优化及重定位流程。

请注意，具体配置与启动指令需参考项目最新文档，因ROS版本差异和项目更新可能会有所变动。