gary-robotics / ROS2-VINS-FUSION-GRIDMAP

VINS-Fusion

ROS2 version of VINS-Fusion.

Notices

• code has been updated so that the vins package can be executed via ros2 run or ros2 launch
• but now it has dependency on Opencv 4.0.x

Prerequisites

• System
  • Ubuntu 20.04
  • ROS2 foxy
• Libraries
  • OpenCV 4.0.x
  • Ceres Solver-2.1.0 (you can refer here; just edit 1.14.0 to 2.1.0 for install.)
  • Eigen-3.3.9

sensor setup

• camera: Intel realsense D435i
• using following shell script, you can install realsense SDK with ROS2 package.

chmod +x realsense_install.sh
bash realsense_install.sh

build

cd $(PATH_TO_YOUR_ROS2_WS)/src
git clone https://github.com/zinuok/VINS-Fusion-ROS2
cd ..
colcon build --symlink-install && source ./install/setup.bash && source ./install/local_setup.bash

run

# vins
ros2 run vins $(PATH_TO_YOUR_VINS_CONFIG_FILE)

# Rviz2 visualization
ros2 launch vins vins_rviz.launch.xml

play bag recorded at ROS1

Unfortunately, you can't just play back the bag file recorded at ROS1. This is because the filesystem structure for bag file has been changed significantly. The bag file at ROS2 needs the folder with some meta data for each bag file, which is done using following commands.

• you have to install this pkg

pip install rosbags

• run

export PATH=$PATH:~/.local/bin
rosbags-convert foo.bag --dst /path/to/bar

Original Readme:

8. Acknowledgements

We use ceres solver for non-linear optimization and DBoW2 for loop detection, a generic camera model and GeographicLib.

9. License

The source code is released under GPLv3 license.

We are still working on improving the code reliability. For any technical issues, please contact Tong Qin <qintonguavATgmail.com>.

For commercial inquiries, please contact Shaojie Shen <eeshaojieATust.hk>.