ORB-SLAM3配置安装及运行---Ubuntu20.04（2021年）

写在前面：准备跑一下ORB-SLAM3，然后配置运行也是自己在网上搜索相关的博客跟着做的，参考了很多博客，而且由于博文发布时间原因环境说明：

文章共4,974字 · 阅读需要大约17分钟

一键AI生成摘要，助你高效阅读

问答

1900_

42687人浏览 · 2021-06-18 19:38:14

1900_ · 2021-06-18 19:38:14 发布

写在前面：

ps：2023年4月20日补充说明：

本文是当初我自己跑的时候的踩坑记录，主要记录了当时我跑ORBslam3时候遇到的问题和解决方案，希望能帮到大家。另外，由于时效问题，此教程可能与最新的源码有出入，请自行辨别（如遇到问题可以看看本文的评论区，很多大佬留下了宝贵的经验，也许可以对你有帮助~~~）

---------------以下是原文-------------

准备跑一下ORB-SLAM3，然后配置运行也是自己在网上搜索相关的博客跟着做的，参考了很多博客，而且由于博文发布时间原因，并没有哪一篇博客可以从头到尾解决所有问题，都是边装边搜索新的解决办法。

所以在此记录一下整个安装过程以及遇到的问题和解决方案。解决过程中所参考的博客链接我都会放出来。

ps：我是用的虚拟机安装的，并且是在一个新系统上开始配置的

所以我的操作步骤是在一个全新的Ubuntu上做的，参考博客的同学注意一下（如果你已经在系统上安装过了一些包，则有些步骤可以省去）

环境说明：

我用的是虚拟机VMware运行的

Ubuntu版本是20.04 （系统是在官网下载的）

ORB-SLAM3源码： https://github.com/UZ-SLAMLab/ORB_SLAM3

准备工作（安装依赖）：

ps：整个安装的大致流程我参考的是这篇博客

Ubuntu16.04下ORB_SLAM3的编译及运行【完整教程】_orbslam3运行_jian_1996的博客-CSDN博客

但是中间遇到了很多问题

源码下载：

去github上直接clone到本地 https://github.com/UZ-SLAMLab/ORB_SLAM3

最好先创建个文件夹，把待会要下载的东西都到这个文件夹下。

git clone https://github.com/UZ-SLAMLab/ORB_SLAM3.git

注意，如果你没装git，跟我一样是新系统，那要先装git

sudo apt-get install git

另外，如果是新系统的话，预装的vi编辑器不完整，用不了。

执行如下命令安装vi编辑器。后边要用

sudo apt-get remove vim-common
sudo apt-get install vim

Pangolin安装：

先去github把代码clone下来

地址：github.com/stevenlovegrove/Pangolin

git clone https://github.com/stevenlovegrove/Pangolin.git

然后安装按照GitHub给的依赖挨个安装即可

然后Optional Dependencies for video input和Very Optional Dependencies里面的我没有装。

安装好依赖了之后编译安装Pangolin

cd Pangolin
mkdir build
cd build
cmake ..
cmake --build .

OpenCV安装

源码要求OpenCV 3.2及以上。

但是最好不要安装OpenCV4以上（4默认不会生成.pc文件，最后查看版本的时候查看不到，找不到包，网上有人说是编译选项没选好，我改了，还是不行，我也不知道是啥原因，最后我换了3.4版本的）

首先，到官网去下载源码：Releases - OpenCV

我下载的是3.4.3版本

下载之后放到你想放的位置，然后把他解压

unzip opencv-3.4.3.zip

解压之后，cmake前面安装过了，如果没装的，安装一下
sudo apt-get install cmake

更新一下，准备开始安装OpenCV依赖库（不更新也行）

sudo apt-get update

这几个依赖库，一条指令完成

sudo apt-get install build-essential libgtk2.0-dev libavcodec-dev libavformat-dev libjpeg.dev libtiff4.dev libswscale-dev libjasper-dev

注意：我在运行上面这个指令的时候报错了，提示说

error: unable to locate libjasper-dev 无法定位这个包libjasper-dev

解决办法是：执行如下指令
sudo add-apt-repository "deb http://security.ubuntu.com/ubuntu xenial-security main"
sudo apt update
sudo apt install libjasper1 libjasper-dev
其中libjasper1是libjasper-dev的依赖包

运行完这个，在安装下面这个指令就没错了

sudo apt-get install build-essential libgtk2.0-dev libavcodec-dev libavformat-dev libjpeg.dev libtiff4.dev libswscale-dev libjasper-dev

安装好了依赖，编译OpenCV

cd opencv-3.4.3
mkdir build
cd build

cmake

cmake -D CMAKE_BUILD_TYPE=Release -D CMAKE_INSTALL_PREFIX=/usr/local ..

注意：执行上面指令后，终端会自动下载一个必需的ippicv加速库。
如果电脑配置了vpn并进入外网，便会卡住一会进行下载；

否则，不会卡住，而是报错提示ippicv_2017u3_lnx_intel64_general_20170822.tgz的加速库下载失败。报错如下：

解决办法是：下载离线的ippicv库

去这里下载 GitHub - opencv/opencv_3rdparty at ippicv/master_20170822

下载好了之后，把这个ippicv文件夹单独拷贝出来，放到你的文件夹下面。

然后把你的OpenCV源文件中 /3rdparty/ippicv 文件夹下的 ippicv.cmake 中，

第47行"https://raw.githubusercontent.com/opencv/opencv_3rdparty/${IPPICV_COMMIT}/ippicv/" 改成你新下载的ippicv文件路径。

比如我的新下载的ippicv我放在ORB-SLAM3下面

我的就改为"file:///home/ORB-SLAM3/ippicv"，如此，便改成了离线编译ippicv文件

反正你改成你下载后存的路径就行了，很好理解。

再次执行cmake命令，就完成了编译

cmake -D CMAKE_BUILD_TYPE=Release -D CMAKE_INSTALL_PREFIX=/usr/local ..

然后make一下

( j4 代表4核我虚拟机分配的8核我编译用的4核也可以不用直接 make即可就是慢一点)

make -j4

make的时间可能略微长一些，我花了十几分钟左右。耐心等待下。好了之后，安装

（不要忘了这一步，没有这个不算成功）

sudo make install

到此，OpenCV就安装好了，然后我们配置一下环境

1）添加库路径

sudo /bin/bash -c 'echo "/usr/local/lib" > /etc/ld.so.conf.d/opencv.conf'

2）更新系统库

sudo ldconfig

3）配置bash

sudo gedit /etc/bash.bashrc

在末尾粘贴如下两行代码

PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig  
export PKG_CONFIG_PATH

4）保存，执行如下命令使得配置生效：

source /etc/bash.bashrc

5）更新

sudo updatedb

如果该指令报错，那么可能是没有安装mlocate

先执行安装命令
apt-get install mlocate
然后再 sudo updatedb

6）opencv版本检测

pkg-config --modversion opencv

注意：如果执行后，显示找不到包。那么注意下你下载的OpenCV版本是不是3.多的

OpenCV版本4以上的，默认不生成.pc文件，会出现找不到包的问题

输出如下，表示opencv完成了安装

Eigen3安装

安装Eigen3的时候，请下载源码进行安装。

如下

#github 有个mirror,版本3.3.4 from 2017
git clone https://github.com/eigenteam/eigen-git-mirror

#安装
cd eigen-git-mirror
mkdir build
cd build
cmake ..
sudo make install

#安装后,头文件安装在/usr/local/include/eigen3/

不要采用如下指令安装eigen3
sudo apt-get install libeigen3-dev
如果采用这个指令安装，默认是安装到了/usr/include/eigen3，ORB-SLAM3检测不到，导致编译会报错。利用源码安装，安装好的路径是 /usr/local/include/eigen3/

DBoW2 and g2o

DBoW2主要用于回环检测，g2o（General Graph Optimization）主要用于图优化。
ORB-SLAM3的源码包自带DBoW2 and g2o，编译时会自动安装。不用管。

Python

执行如下指令

sudo apt install libpython2.7-dev

安装boost库

由此链接进入boost官网：Boost C++ Libraries

我下载的是1.75.0

下载之后解压：

tar -xzvf boost_1_75_0.tar.gz

解压之后进入解压出来的文件夹

然后执行这个脚本

sudo ./bootstrap.sh

执行完毕之后，你会发现又多了些文件

执行如下脚本

sudo ./b2 install

这可能需要些时间，等他安装完毕。

安装libssl-dev

执行

sudo apt-get install libssl-dev

ORB_SLAM3的编译和安装

源码编译：

进入源码文件夹

cd ORB_SLAM3
chmod +x build.sh
./build.sh

注意：这个build.sh是官方给的安装脚本，执行这个即可编译

但是我遇到一个问题，我执行这个编译完不成，出现了报错

这个报错原因就是内存不够，我虚拟机分配的8G内存。

然后我把虚拟机分配16G内存，再次执行build.sh

同时我打开另一个终端，查看内存使用情况。如图

发现疯狂吃内存，飙升到14G，而且还在上升。最后还是报错，内存不够。

不过我觉得不应该啊。不应该16G还不够

所以我换了个方法编译

打开build.sh这个脚本

脚本里面内容如下
echo "Configuring and building Thirdparty/DBoW2 ..."

cd Thirdparty/DBoW2
mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j

cd ../../g2o

echo "Configuring and building Thirdparty/g2o ..."

mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j

cd ../../../

echo "Uncompress vocabulary ..."

cd Vocabulary
tar -xf ORBvoc.txt.tar.gz


echo "Configuring and building ORB_SLAM3 ..."

mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j
我不执行这个脚本，而是挨个执行里面的语句，自己手动编译

并且我把这里面的make -j 换成了make -j4 来执行

（因为 make -j 的话会自动检测你的核心数，选用合适的数量，我感觉是我分配的太多了，我分了八核，编译时候16G内存都不够，后来我改成了 make -j4 竟然编译好了，而且也不是很慢，就不到十分钟的样子。我也搞不懂，这块可能跟自己电脑有关吧)

这里你可以根据自己情况，如果一直不行的话，可以试试换成make

单核编译，就是速度慢一些而已

注意：脚本里面的指令，前面安装库啥的都没问题

到了最后，编译源码出问题了

报错如下
make[2]: *** [CMakeFiles/ORB_SLAM3.dir/build.make:89：CMakeFiles/ORB_SLAM3.dir/src/LocalMapping.cc.o] 错误 1

make[2]: *** [CMakeFiles/ORB_SLAM3.dir/build.make:349：CMakeFiles/ORB_SLAM3.dir/src/CameraModels/KannalaBrandt8.cpp.o] 错误 1
解决办法是：

在报错的文件里，如KannalaBrandt8.cpp，LocalMapping.cc

在include之后加上如下代码
namespace cv
{
template<typename _Tp, int m, int n> static inline
Matx<_Tp, m, n> operator / (const Matx<_Tp, m, n> &a, float alpha)
{
return Matx<_Tp, m, n>(a, 1.f / alpha, Matx_ScaleOp());
}
}
参考博客：安装orbslam3时报错：error: no match for ‘operator/’_威少少熬夜的博客-CSDN博客

如果你报错：error: no match for ‘operator/’

也可以使用这个方法解决。

另外：如果你还遇到了其他错误，可以参考这篇博客

ORB-SLAM2编译错误_嵙杰的博客-CSDN博客

例如：
make[2]: *** [CMakeFiles/ORB_SLAM2.dir/src/LoopClosing.cc.o] Error 1
CMakeFiles/Makefile2:178: recipe for target 'CMakeFiles/ORB_SLAM2.dir/all' failed
make[1]: *** [CMakeFiles/ORB_SLAM2.dir/all] Error 2
Makefile:83: recipe for target 'all' failed

最终编译成功。

数据集测试

数据集下载地址：（下载很慢，百度云有会员的同学可以用我给的百度云链接）

kmavvisualinertialdatasets – ASL Datasets

要下载ASL格式的，我下的是第一个MH01

注意：这个网站下载的贼慢。

我这里放一个百度云链接，是我下载出来的MH01的压缩包

链接：https://pan.baidu.com/s/1glBWtlwACJnnuRqGrnMy-g
提取码：gixc

这个压缩包下好了之后，把他解压了，里面是一个mav0的文件夹（注意看你下的对不）

然后在你的文件夹下，我的是ORB-SLAM3文件夹下，创建一个文件夹叫dataset

在dataset文件夹下再创建一个MH01文件夹

然后把mav0文件夹放到MH01里面去

然后，在ORB-SLAM3的源码中，有一个Examples文件夹，

这个文件夹下有一个脚本“euroc_examples.sh“。打开这个脚本

你可以看到有一个与MH01有关的指令（就是第一条）指令如下：

./Monocular/mono_euroc ../Vocabulary/ORBvoc.txt ./Monocular/EuRoC.yaml "$pathDatasetEuroc"/MH01 ./Monocular/EuRoC_TimeStamps/MH01.txt dataset-MH01_mono

把这条指令复制出来：（我的指令复制出来如下）

./Monocular/mono_euroc ../Vocabulary/ORBvoc.txt ./Monocular/EuRoC.yaml "$pathDatasetEuroc"/MH01 ./Monocular/EuRoC_TimeStamps/MH01.txt dataset-MH01_mono

其中我标红的需要改：

把"$pathDatasetEuroc"/MH01 改成你自己的路径，比如我的路径就是

../dataset/MH01

为什么是这样，因为我观察这个指令，会发现他所执行的程序

比如./Monocular/mono_euroc

这个Monocular文件夹是在Examples文件夹下的，那也就意味着这个指令是在Examples文件夹下执行的才对

然后呢，咱们的数据集dataset在上一层文件夹呢

故改成 ../dataset/MH01