如何在Windows/Ubuntu系统搭建3D点云标注环境？零基础掌握自动驾驶标注工具

在自动驾驶技术研发过程中，精确的3D点云标注是训练感知模型的基础。本文将带你5分钟上手跨平台3D点云标注工具，轻松实现KITTI-bin格式点云的3D框注释，其标注格式与Apollo 3D标准完全兼容，支持加载、保存、可视化及点云选择等核心功能。

一、场景化需求：为什么选择这款标注工具？

当你需要处理以下任务时，这款工具能显著提升效率：

• 自动驾驶数据集的3D目标框标注
• 点云数据的可视化与交互分析
• 生成符合行业标准的标注结果

图1：工具主界面展示了点云数据的3D框标注效果，左侧为标注类型选择面板

二、核心功能解析：工具能为你做什么？

2.1 核心依赖解析

依赖项	Ubuntu 16.04	Windows 10
基础编译工具	cmake, gcc, g++	Visual Studio 2017+
GUI框架	qt5-default, libqt5opengl5-dev	Qt5 SDK
可视化库	libvtk8.1-dev	VTK 8.1+
点云处理	libpcl-all	PCL 1.8+预编译库

2.2 核心功能亮点

• 多格式支持：原生支持KITTI-bin格式点云文件
• 智能标注：提供自动平面检测和阈值分割功能
• 直观交互：通过鼠标拖拽即可调整3D框位置与大小
• 格式兼容：标注结果与Apollo 3D格式无缝对接

图2：大规模点云场景的标注效果，紫色框体表示已标注的目标对象

三、跨平台部署指南

3.1 Ubuntu系统快速部署

「1/3 环境准备」

🔧 执行命令：

sudo apt-get update
sudo apt-get install cmake gcc g++ qt5-default libqt5opengl5-dev libvtk8.1-dev libpcl-all

⚠️ 检查点：安装完成后可通过qmake -v验证Qt版本，确保输出5.x以上版本信息

「2/3 编译流程」

🔧 执行命令：

git clone https://gitcode.com/gh_mirrors/po/point-cloud-annotation-tool
cd point-cloud-annotation-tool
mkdir build && cd build
cmake ..
make -j4

「3/3 验证测试」

🔧 执行命令：

./point-cloud-annotation-tool

3.2 Windows系统部署指南

「1/3 环境准备」

⚠️ 需提前安装：

• Visual Studio 2017或更高版本
• PCL 1.8+预编译库（含VTK组件）
• Qt5 SDK（选择与VS版本匹配的编译器）

「2/3 编译流程」

🔧 执行命令：

git clone https://gitcode.com/gh_mirrors/po/point-cloud-annotation-tool
cd point-cloud-annotation-tool
mkdir build && cd build
cmake .. -G "Visual Studio 15 2017 Win64"

然后用Visual Studio打开build目录下的.sln文件，点击"生成"→"生成解决方案"

「3/3 验证测试」

在Visual Studio中按F5运行，或直接在build/Debug目录下双击可执行文件

四、实用技巧与常见问题

4.1 快速操作技巧

• 快捷键：按B键快速创建3D框，按Delete删除选中框体
• 视图控制：鼠标滚轮缩放，右键拖动旋转视角
• 批量操作：按住Ctrl键可多选标注框进行批量编辑

4.2 常见问题速查

Q: 编译时提示"VTK not found"怎么办？
A: 确保VTK开发包已安装，Ubuntu可执行sudo apt-get install libvtk8-dev，Windows需在CMake时指定VTK_DIR路径

Q: 程序启动后黑屏无显示？
A: 检查点云文件路径是否正确，确保文件格式为KITTI-bin格式

Q: 无法保存标注结果？
A: 确认当前用户对保存目录有写入权限，建议先在终端执行chmod +w ./annotations

五、功能扩展建议

• 批量处理：可开发脚本实现多文件自动标注流程
• AI辅助：集成预训练模型实现标注建议功能
• 格式转换：添加对COCO、PASCAL VOC等格式的支持

如需自定义编译选项，可参考项目内的cmake配置文档。这款工具持续更新中，欢迎贡献代码或提出改进建议。