Skip to content

lookatmel/cartographer_detailed_comments_ws

 
 

Repository files navigation

cartographer 超详细注释代码

1 开源项目简介

本项目对cartographer进行了逐行的注释,代码是基于2021.04.20日在cartographer官方github上下载的master的代码

共做了如下工作

  • 在代码中进行了规范, 超详细的注释, 帮助大家更好的理解源码
  • 对cartographer中的关键概念进行了解释与说明
  • 对cartographer中使用的c++11新标准语法进行了标注与说明
  • 编写了编译, 保存地图相关的脚本
  • 对2d建图, 3d建图, 纯定位模式进行了launch与lua文件的的配置
  • 对3d的cartographer添加了实时显示三维点云地图与保存地图的功能
  • 配套了逐行讲解源码的视频课程

2 推荐编译环境

  • ubuntu 16.04/18.04 版本
  • ROS Kinetic/Melodic 版本
  • vscode

vscode中推荐的插件有:

  • C/C++
  • C++ Intellisense
  • Doxygen Documentation Generator
  • Msg Language Support
  • XML Tools
  • Todo Tree: 注释的高亮显示

3 运行相关命令

其中的bag文件可以在我的公众号: 从零开始搭SLAM 里找到,在底部菜单栏的数据集链接里

2d建图指令

roslaunch cartographer_ros lx_rs16_2d_outdoor.launch

保存2d轨迹,并生成ros格式的地图

./finish_slam_2d.sh

纯定位模式

roslaunch cartographer_ros lx_rs16_2d_outdoor_localization.launch

3d建图指令

roslaunch cartographer_ros lx_rs16_3d.launch

保存3d轨迹

./finish_slam_3d.sh

使用asset生成ros格式的2d栅格地图

roslaunch cartographer_ros assets_writer_2d.launch

使用asset生成3d点云地图

roslaunch cartographer_ros assets_writer_3d.launch

landmark使用示例

roslaunch cartographer_ros landmark_mir_100.launch

4 实时显示三维点云地图与保存地图的功能简述

显示三维点云地图需要是在建3d轨迹的情况下才可以显示, 点云地图默认发布在 /point_cloud_map 话题中.

默认关闭了保存pcd格式点云的功能, 如需要这个功能, 需要将node.cc文件的第1029行的 constexpr bool save_pcd = false; 改成true.

编译之后在建图结束后通过调用 /write_state 服务, 会在生成pbstream文件的同时也对pcd文件进行保存, 保存目录与pbstream文件同一个文件夹.

个人水平有限, 如果改完的代码有问题请您联系我进行改正.

pcd_map

5 逐行讲解源码的视频课程简介

课程介绍

Cartographer的代码庞大,逻辑复杂,包含大量的工程细节,对于初学者不太友好,学习理解代码十分困难,需要花费大量时间仍不得要领。

而企业对激光SLAM从业者的要求越来越高,只会调包调参的人找工作越来越难,只有深入理解激光SLAM原理与代码实现,才具有核心竞争力。

因此,计算机视觉life推出了源码解析课程《激光SLAM之Cartographer源码解析》,这是目前唯一一个逐行讲解Cartographer源码的课程!

课程大纲

大纲

如果图片刷不出来, 可以点击下方的链接去看更详细的介绍

课程的更加详细的介绍请点这里

课程咨询

如果对这个课程感兴趣的同学可以扫描下方的名片进行课程咨询, 加的时候备注下 carto课程咨询

咨询

by lixiang

About

cartographer work space with detailed comments

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C++ 92.9%
  • CMake 1.9%
  • Lua 1.9%
  • Python 1.3%
  • Shell 1.0%
  • Starlark 0.8%
  • Other 0.2%