R3LIVE 项目下载与安装教程

1. 项目介绍

R3LIVE 是一个基于 LiDAR-Inertial-Visual 传感器融合框架的开源项目，能够利用 LiDAR、惯性测量单元和视觉传感器的测量数据来实现稳健和准确的状态估计。R3LIVE 包括两个子系统：LiDAR-Inertial Odometry (LIO) 和 Visual-Inertial Odometry (VIO)。LIO 子系统（FAST-LIO）利用 LiDAR 和惯性传感器的测量数据构建全局地图的几何结构，而 VIO 子系统则利用视觉-惯性传感器的数据为地图添加纹理。

2. 项目下载位置

项目托管在 GitHub 上，下载位置为：https://github.com/hku-mars/r3live.git

3. 项目安装环境配置

在安装项目之前，需要配置以下环境：

• ROS (Robot Operating System)
• livox_ros_driver
• CGAL 和 pcl_viewer (可选)
• OpenCV (版本 >= 3.3)

以下为环境配置的步骤及图片示例：

安装 ROS

sudo apt-get install ros-XXX-cv-bridge ros-XXX-tf ros-XXX-message-filters ros-XXX-image-transport ros-XXX-image-transport*

其中 XXX 代表你的 ROS 版本，例如 melodic、kinetic 等。

安装 livox_ros_driver

# 请参考官方教程进行安装

安装 CGAL 和 pcl_viewer

sudo apt-get install libcgal-dev pcl-tools

安装 OpenCV

确保你的 OpenCV 版本至少为 3.3，可以使用以下命令检查版本：

pkg-config --modversion opencv

4. 项目安装方式

1. 克隆项目到你的 ROS 工作空间

cd ~/catkin_ws/src
git clone https://github.com/hku-mars/r3live.git

2. 编译项目

cd ~/catkin_ws
catkin_make

3. 设置环境变量

source ~/catkin_ws/devel/setup.bash

5. 项目处理脚本

R3LIVE 提供了一系列离线工具来重建和纹理化网格，以下是一些基本的使用示例：

保存地图

在运行过程中，可以随时保存地图，只需在控制面板中按 'S' 或 's' 键。

重建和纹理化网格

保存地图后，可以使用以下命令重建和纹理化网格：

roslaunch r3live r3live_reconstruct_mesh.launch

查看保存的地图

默认情况下，离线地图保存在 $HOME/r3live_output 目录下，可以使用 pcl_viewer 或 meshlab 查看保存的地图。

cd $HOME/r3live_output
pcl_viewer rgb_pt.pcd

或

cd $HOME/r3live_output
meshlab textured_mesh.ply

通过以上步骤，你可以成功下载、安装并使用 R3LIVE 项目。