3D点云标注工具快速上手从零到出第一个标注结果的5个步骤【免费下载链接】point-cloud-annotation-tool项目地址: https://gitcode.com/gh_mirrors/po/point-cloud-annotation-tool做自动驾驶、机器人或三维感知的开发者一定经历过这样的场景拿到一帧 KITTI 点云想确认某个算法的边界框效果却要打开笨重的专业软件或者干脆自己写可视化脚本。更痛苦的是当你终于想认真标注一批训练数据时才发现手头的工具要么只能看不能标要么装半天依赖要么标注格式跟 Apollo、KITTI 对不上。point-cloud-annotation-tool正是为这个场景而生一个基于 PCL VTK Qt5 的开源 3D 点云标注工具直接读取 KITTI-bin 格式点云支持 3D 边界框生成、编辑与删除标注结果按 Apollo 3D 格式保存。它解决的问题很简单——让你能在 5 分钟内装起来用鼠标画出一个贴合目标的 3D 框再一键导出标准格式而不是把时间耗在环境搭建和格式转换上。为什么你需要一个专用的 3D 点云标注工具先看一组常见的手动标注痛苦清单常见做法实际体验代价自己写点云可视化取框脚本每次调整都要改代码重编译半天起步只够标一帧用通用 3D 建模软件硬标没有点云语义框贴合全靠肉眼精度差返工率高用在线付费标注平台数据要上传、格式要转换、可能涉密成本高流程长相比之下这个工具把读点云 → 选点 → 生成框 → 微调 → 保存整个链路做成了 GUI 操作。代码仓库里自带 main.cpp 启动入口和 mainwindow.ui 界面定义打开即用没有多余的中间环节。更关键的是格式兼容性标注文件是点云文件名.txt与 Apollo 3D 标注格式一致见 Annotaion.cpp 中的BoxLabel::toString()KITTI 数据集可直接对接省去了最常见的格式转换地狱。亮点速览这个工具凭什么是高效率选择能力具体表现谁最受益零学习成本的框标注框选点云 → 点击类型按钮 → 自动生成贴合边界框第一次接触点云标注的新手智能点云选择支持框选Ctrl 追加/删除、Shift 并集、CtrlShift 交集需要精确选点的老手限制旋转的 3D 编辑基于自研vtkBoxWidgetRestricted只能绕 Z 轴旋转做车载/道路场景标注的工程师一键地面去除阈值模式或 RANSAC 平面检测两种方案地面点干扰严重的路测数据标准格式导入导出支持 .pcd / KITTI-bin保存为 Apollo 3D 格式需要对接训练流程的团队其中最有特色的是 vtkBoxWidgetRestricted.cpp它在标准 VTK 盒控件基础上把旋转限制在 Z 轴。对车载 LiDAR 场景来说目标框根本不需要自由翻转——这既减少了误操作也让标注框保持车头朝向语义一举两得。5分钟上手一键安装与最快配置方法项目在 Ubuntu 16.04 和 Windows 10 下均测试通过依赖为 PCL 1.8、VTK 8.1 与 Qt5。如果你已经装好这三个库整个构建只需要三行命令git clone https://gitcode.com/gh_mirrors/po/point-cloud-annotation-tool cd point-cloud-annotation-tool mkdir build cd build cmake .. make几个值得注意的细节根目录 CMakeLists.txt 会自动检测ccache加速编译也会把test/和tool/子目录一起构建可用-DBUILD_TESTOFF关闭。无需任何标注数据.bin文件即 KITTI 常见的 x/y/z/intensity 四通道浮点二进制工具内部按此结构解析见 visualizer.cpp 的loadBinFile。启动后点File → Open选择.bin或.pcd文件即可。跑起来之后你看到的界面就是上面那张图的样子左侧是 Annotations 列表和 Types 彩色按钮中央是点云渲染窗口。核心操作详解三步搞定第一个 3D 边界框标注第一步框选目标点云在点云视图中用鼠标拖出矩形框框住你关心的目标。被选中的点会高亮变色。这一步可以结合模式切换直接框选 全新选择按住 Shift 再框选 追加并集按住 Ctrl 再框选 从当前选区减去差集同时按住 CtrlShift 取交集。这套逻辑写死在AreaPickingEventProcess见 visualizer.cpp对精细选点非常友好。第二步一键生成并上色在左侧 Types 面板点击目标类型按钮工具会立刻根据选中点生成一个最小包围盒并按类型自动着色vehicle紫、cyclist红、pedestrian蓝、unknown橙、dontCare绿。颜色的映射关系在 Annotaion.h 的getColor中定义一眼就能分清类别。第三步微调与验证点击任意标注框即可选中它此时会出现 3D 编辑手柄即vtkBoxWidgetRestricted可以拖动缩放、平移、绕 Z 轴旋转框会实时贴合点云。不满意直接按Del键删除。全部完成后File → Save结果写入同名的.txt标注文件。进阶技巧只有深度用户才知道的两个细节技巧一地面点去除的组合拳菜单栏Filters提供两种地面去除方式DetectPlaneRANSAC 平面检测默认距离阈值 0.1和Threshold按 Z 值阈值默认 -1.5即把 z -1.5 的点标记为地面。大多数用户只用一个但更聪明的做法是先平面检测、再阈值兜底前者抓出大片平整路面后者处理前者的漏网之鱼。被标记为地面的点会改变颜色而且在框选时会被自动排除见AreaPickingEventProcess中对GROUND_POINT的判断所以地面去除做得越干净框选越不容易误选。技巧二用选中→改类型完成批量纠错不需要先删框再新建。点击某个标注框选中后直接在左侧 Types 面板点击其他类型按钮该框的类别和颜色会当场更新对应typeButtonClickedProcess的逻辑。当你标注完一整帧、回头发现某几个框类别标错时这个操作比删除重画快得多。常见问题速查问题原因与解决办法打开点云后标注没自动加载标注文件必须与点云同名例如cloud.bin对应cloud.bin.txt否则不会自动读取框选后点类型按钮没反应选中的点少于 3~4 个时无法生成包围盒代码会提示 no points selected多框一些点再试标注框转来转去不听话这是设计如此vtkBoxWidgetRestricted将旋转限制在 Z 轴符合车载场景语义想要自由旋转需要改用它继承的vtkBoxWidget地面去除把目标也标掉了阈值模式下 Z 阈值设置过大尝试调小阈值或改用平面检测模式保存后 txt 里数字含义不清楚每行格式为类型 cx cy cz length width height yaw即中心坐标尺寸偏航角正是 Apollo 3D 标注的字段顺序适合谁用用户受益点自动驾驶算法工程师快速给 KITTI/Apollo 数据补标注、抽查算法输出质量计算机视觉研究者无需写代码就能获得标准格式的 3D 框数据数据标注团队免费开源、支持批量处理流程对接降低标注成本点云工具链开发者源码结构清晰visualizer 负责渲染交互、Annotaion 负责数据管理、vtkAnnotationBoxSource 负责框体绘制二次扩展方便总结一句话回顾point-cloud-annotation-tool 是一个 3 分钟能装起来、30 秒能标出第一个框、导出格式直接对接 Apollo/KITTI 的开源 3D 点云标注工具。如果你是自动驾驶或三维感知方向的一员与其继续在临时脚本和专业软件之间反复横跳不如现在就 clone 下来试一帧数据看看那个贴合点云的紫色框是不是比想象中更快出现。更多细节可以参考项目 README 与源码中的注释特别是visualizer.cpp的交互事件处理和Annotaion.cpp的格式读写部分。觉得好用的话给项目点个 Star帮助它被更多需要标注工具的团队看到。【免费下载链接】point-cloud-annotation-tool项目地址: https://gitcode.com/gh_mirrors/po/point-cloud-annotation-tool创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考