转载请注明出处,谢谢
原创作者:Mingrui
原创链接:https://www.cnblogs.com/MingruiYu/p/12404730.html
本文要点:
- ROS 配置安装
- 解决
sudo rosdep init
报错Website may be down.
- 解决
- ORB-SLAM2 ROS 配置安装
- 解决报错
DSO missing from command line
- 解决报错
- Android 手机摄像头与 PC 进行基于 ROS 的通信
- 手机摄像头标定
- 采集标定图像
- OpenCV samples 相机标定例程
- 使用 Android 手机摄像头,运行 ORB-SLAM2 ROS Mono
- 简化启动
- 使用 gnome-terminal,一个脚本运行多个终端
写在前面
最近研究 ORB-SLAM2,自然是想能自己实时跑一跑。但最近因为疫情只能待在家里,身边能当摄像头的东西好像只有笔记本摄像头和手机摄像头。笔记本摄像头不方便(特别是我的 matebook 14 这个在键盘上的弹出摄像头,如想实现可参考),所以选择使用手机摄像头。ORB-SLAM2 官方提供了 ROS 的支持,再结合网上各路大佬提供的工具,最终实现了以 Android 手机摄像头为输入,基于 ROS 在 PC 上实时运行 ORB-SLAM2 Mono。本文将从零开始,介绍如何实现这一目标。
本文环境为:
- Ubuntu 18.04
- ROS Melodic
- Android 手机(MI 9 SE)
ROS 配置安装
首先是 ROS 的配置安装,参照 ROS 官方安装教程,其中第一步使用国内镜像:
sudo sh -c '. /etc/lsb-release && echo "deb http://mirrors.ustc.edu.cn/ros/ubuntu/ $DISTRIB_CODENAME main" > /etc/apt/sources.list.d/ros-latest.list'
sudo rosdep init 出错
安装步骤中 sudo rosdep init
报错:
ERROR: cannot download default sources list from:
https://raw.githubusercontent.com/ros/rosdistro/master/rosdep/sources.list.d/20-default.list
Website may be down.
首先试一试在浏览器中能不能打开,如果打不开的话,说明该网站需要翻。
因为在终端中安装,所以光浏览器能翻不够,还得配置终端翻。如果使用的是 ss 的话,终端还需要额外配置。配置方法可自行 google。
成功配置终端后,如果还报这个错,则需要:
sudo c_rehash /etc/ssl/certs
sudo -E rosdep init
之后再 rosdep update 就可以了。
学习教程
ORB-SLAM2 ROS 配置安装
编译
ORB-SLAM2 的配置安装可见 raulmur/ORB_SLAM2。之前的博文 ORB-SLAM2 初体验 —— 配置安装 中介绍了不包括 ROS 支持的 ORB-SLAM2 配置安装。包括 ROS 支持的配置安装可见 raulmur/ORB_SLAM2#7-ros-examples:
在 ~/.bashrc 中添加 ORB-SLAM2 path 至 ROS_PACKAGE_PATH
# 打开 ~/.bashrc
sudo gedit ~/.bashrc
# 添加
export ROS_PACKAGE_PATH=${ROS_PACKAGE_PATH}:PATH/ORB_SLAM2/Examples/ROS
# (注意修改 PATH 为自己 ORB-SLAM2 的目录)
NOTICE:
- ${ROS_PACKAGE_PATH}:和PATH之间不能有空格。
- 添加的位置要在之前添加的其它的 source 命令之后。
之后进行编译:
cd PATH/ORB_SLAM2
chmod +x build_ros.sh
./build_ros.sh
会报错:DSO missing from command line
解决方法:ERROR while running ./build_ros.sh #535
运行
例如运行单目 ORB-SLAM2:
rosrun ORB_SLAM2 Mono PATH_TO_VOCABULARY PATH_TO_SETTINGS_FILE
下文会详细介绍如何运行。
Android 手机摄像头与 PC 进行基于 ROS 的通信
该实现基于 GitHub 上的一个项目:hitcm/Android_Camera-IMU,作者实现了将手机的摄像头信息和 IMU 信息传给 PC(可参考作者博文 ROS实时采集Android的图像和IMU数据)。本文中,我们只需使用摄像头信息。
git clone https://github.com/hitcm/Android_Camera-IMU.git
sudo apt-get install ros-melodic-imu-tools # 修改对应自己的 ROS 版本(本文中其实不需要)
将 clone 下来的文件夹中已经编译好的 apk 拷到 Android 手机上,在手机上安装。并将 PC 和 Android 手机 置于同一局域网下。
运行方式:
PC Terminal 1: roscore
Android: 打开应用,在 在 IP Port 中修改 IP 地址为 PC的 IP地址,port不需要修改(PC 的 IP 可在 PC 终端输入 ifconfig
查看),之后点击 Connect,连接成功则进入相机界面。
PC Terminal 2:
cd Android_Camera-IMU
roslaunch android_cam-imu.launch
之后会弹出一个 Rviz 界面:
- 如果要实时显示 image,需要 Add - By topic - 添加/camera/image_raw/image。
- 如果要显示 imu,则需要 Add - By topic - 添加 imu,且在 Fix Frame 中 将 map 改为 imu。
手机摄像头标定
为了 ORB-SLAM2 准确运行,需要对手机摄像头进行标定。标定方式为:对棋盘格标定板进行各个方向的拍照,之后基于 OpenCV 进行标定。注意这里采集的图片需要和 ORB-SLAM2 程序读取到的一致,所以不能直接使用手机自带相机 app 拍照,因为手机会自动通过算法进行校正,而上述通信传输的是 raw images。因此,首先我们需要完成的任务是:采集并保存摄像头图像。
使用下图作为标定板(参考资料),可直接在电脑屏幕上显示,对其拍照即可。
注意:
- 实验发现,使用长宽格数不一样的棋盘标定板效果更好。
- 实验发现,标定板周围要是白色的才行,黑色的提取不出角点来(在电脑屏幕上显示标定板时尤其需要注意)。
- 摄像头需要从不同方向拍摄棋盘格,可参考 OpenCV 安装目录下 samples/data 中的 left0x.jpg 系列标定图片。
采集并保存图片
目前没有找到直接保存的方法,所以我们选择写一个 ROS node 来接收手机传来的图像,再通过 OpenCV 进行显示和保存。
为了方便,我们选择直接在 ORB-SLAM2 的 ros_mono.cc 的代码基础上进行修改,在 ros_mono.cc 同一目录下写了个 ros_camera_capture.cc:
/**
* This file is to capture images from Android phone, for camera calibration
* This file is used with Android_Camera-IMU
*/
#include<iostream>
#include<algorithm>
#include<fstream>
#include<chrono>
#include<ros/ros.h>
#include <cv_bridge/cv_bridge.h>
#include<opencv2/core/core.hpp>
#include"../../../include/System.h"
using namespace std;
string save_dir = "PATH"; // 修改为自己保存图片的路径
int imgId = 0;
void GrabImage(const sensor_msgs::ImageConstPtr& msg);
int main(int argc, char **argv)
{
std::cout << "To save the current frame, please press 'Q' or 'q' " << std::endl;
std::cout << "The images will be saved to " << save_dir << std::endl;
ros::init(argc, argv, "PClistener");
ros::start();
ros::NodeHandle nodeHandler;
ros::Subscriber sub = nodeHandler.subscribe("/camera/image_raw", 1, GrabImage);
ros::spin();
ros::shutdown();
return 0;
}
void GrabImage(const sensor_msgs::ImageConstPtr& msg)
{
string imgname;
cv_bridge::CvImageConstPtr cv_ptr;
try
{
cv_ptr = cv_bridge::toCvShare(msg);
cv::Mat img = cv_ptr->image;
cv::imshow("img_name", img);
char key = cv::waitKey(1);
// press "q" to save the image
if(key == 'q' || key == 'Q'){
imgId++;
imgname = "img_" + to_string(imgId) + ".jpg";
cv::imwrite(save_dir + imgname, img);
std::cout << "has saved image "<< imgId << " to " << save_dir << std::endl;
}
}
catch (cv_bridge::Exception& e)
{
ROS_ERROR("cv_bridge exception: %s", e.what());
return;
}
}
注意修改其中保存图像的目录。
另外,在 ORB_SLAM2/Examples/ROS/ORB_SLAM2 目录中的 CMakeLists.txt 中添加如下内容(添加在 # Node for monocular camera 上方即可):
# Node for capture images for camera calibration
rosbuild_add_executable(CameraCapture
src/ros_camera_capture.cc
)
target_link_libraries(CameraCapture
${LIBS}
)
之后重新编译 ORB_SLAM2 项目。
cd PATH/ORB_SLAM2
./build_ros.sh
使用方法:
Terminal 1:
roscore
手机进入 app 运行
Terminal 2: 在 Android_Camera-IMU 目录
roslaunch android_cam-imu.launch
(可以关掉 Rviz)
Terminal 3:
rosrun ORB_SLAM2 CameraCapture
鼠标选中图像框,按下 q 键保存图像。
进行标定
使用 OpenCV samples 中的代码实现。参考资料
标定例程
新建一个工作目录(文件夹)camera_calibration_opencv,将 OpenCV 安装目录中的 samples/cpp/tutorial_code/calib3d/camera_calibration 文件夹内的内容拷贝至该目录。
修改 VID5.xml
VID5.xml 中存储着标定图像的路径,所以要在 VID.xml 中添加所有标定图像的路径,eg:
<?xml version="1.0"?>
<opencv_storage>
<images>
PATH/img_1.jpg
PATH/img_2.jpg
PATH/img_3.jpg
</images>
</opencv_storage>
修改 in_VID5.xml
<BoardSize_Width> 9</BoardSize_Width>
<BoardSize_Height>6</BoardSize_Height>
表示棋盘格的宽和高,注意,这里的宽度和高度是指内部交叉点的个数,而不是方形格的个数。如上图棋盘的数据就是9和6。
<Square_Size>20</Square_Size>
修改为每格的边长 (mm),拿尺子量。
<Input>"VID5.xml"</Input>
修改 VID5.xml 的路径。
<Calibrate_FixPrincipalPointAtTheCenter> 1 </Calibrate_FixPrincipalPointAtTheCenter>
此处原来是0,需要改为1,表示引入切向畸变参数(因为 ORB-SLAM2 中也引入了切向畸变参数),否则只有径向畸变参数。
其它地方应该不需要改动,想进一步了解可看其中的注释。
编译
在工作目录 camera_calibration_opencv 中新建 CMakeLists.txt:
project(Camera_Calibration)
set(CMAKE_CXX_STANDARD 11)
find_package(OpenCV 3.0 QUIET)
if(NOT OpenCV_FOUND)
find_package(OpenCV 2.4.3 QUIET)
if(NOT OpenCV_FOUND)
message(FATAL_ERROR "OpenCV > 2.4.3 not found.")
endif()
endif()
include_directories(${OpenCV_INCLUDE_DIR})
add_executable(Camera_Calibration camera_calibration.cpp)
target_link_libraries(Camera_Calibration ${OpenCV_LIBS})
之后编译:
cd camera_calibration_opencv
mkdir build
cd build
cmake ..
make
运行,标定
cd camera_calibration_opencv
./Camera_Calibration in_VID5.xml
程序启动后会显示标定图像的角点提取情况,之后会显示校正后图像,一个一个全部关闭后才会保存标定参数至 out_camera_data.xml。
参数填入 ORB-SLAM2 的配置文件
参数输出在 out_camera_data.xml 中:
<camera_matrix type_id="opencv-matrix">
是相机内参矩阵,顺序为 fx, 0, cx; 0, fy, cy; 0, 0, 1。<distortion_coefficients type_id="opencv-matrix">
是畸变参数,其顺序为 k1, k2, p1, p2, k3。
之后在 ORB_SLAM2 中新建一个配置文件 AndroidPhone.yaml(建哪儿都行,我为了方便就和 TUM1.yaml 放在了一个目录下),将 TUM1.yaml 的内容拷贝过来,并把其中的 Camera 参数进行修改。
注意: 相机参数对 ORB-SLAM2 的运行效果有极大影响(尤其是初始化),所以标定过程须认真完成。
运行 ORB-SLAM2 Mono
Terminal 1:
roscore
手机进入 app 运行
Terminal 2: 在 Android_Camera-IMU 目录
roslaunch android_cam-imu.launch
(可以关掉 rvis)
Terminal 3:
rosrun ORB_SLAM2 Mono PATH_TO_VOCABULARY PATH_TO_SETTINGS_FILE
运行效果展示:
注意: ORB-SLAM2 Mono 还是比较难以初始化的(其设置的初始化条件相对苛刻),在开始时,选择特征纹理丰富的区域,多上下左右平移相机,有利于初始化。
简化启动
上述启动步骤需要启动3个终端,挺麻烦的,所以可以选择写一个脚本来自动启动这3个终端。参考资料
新建 ORB_SLAM2_with_AndroidPhone.sh,在其中填入:
gnome-terminal --title="roscore" -x bash -c "roscore"
# 暂停 2s,保证几个不同终端的启动顺序
sleep 2s;
gnome-terminal --title="AndroidPhone" -x bash -c "cd PATH/Android_Camera-IMU; roslaunch android_cam-imu.launch"
sleep 2s;
gnome-terminal --title="ORB-SLAM2" -x bash -c "rosrun ORB_SLAM2 Mono PATH_TO_VOCABULARY PATH_TO_SETTINGS_FILE"
之后赋予权限(仅需一次):
chmod +x ORB_SLAM2_with_AndroidPhone.sh
运行:
./ORB_SLAM2_with_AndroidPhone.sh
即可一次性打开3个终端,并运行相关命令。之后手机再打开 app 就可以了。
注意: 此时终端运行结束后会自动退出,如果不想自动退出,可 在terminal点右键,选择Profiles->Profile Preferences然后找到Title and Command,里面有一项When command exits,后面选择为Hold the terminal open。参考资料
参考资料
- 在Ubuntu 18.04 LTS安装ROS Melodic
- sudo rosdep init出错的解决方案
- sudo rosdep init 错误
- ERROR while running ./build_ros.sh #535
- ubuntu16.04下用笔记本摄像头和ROS编译运行ORB_SLAM2的单目AR例程
- ROS实时采集Android的图像和IMU数据
- OpenCV 相机参数标定(Camera Calibration
- 采集Android手机摄像头运行ORB_SLAM2(ubuntu16.04+ROS kinetic
- ubuntu下通过命令打开多个终端并在相应终端执指令
- gnome-terminal
ORB-SLAM2 系列博文
原文地址:https://www.cnblogs.com/MingruiYu/p/12404730.html