1. 为什么选择SUSTechPOINTS进行3D点云标注在自动驾驶研发过程中3D点云标注是个绕不开的苦差事。我最早用过不少商业标注工具不是价格贵得离谱就是功能残缺不全。直到去年团队接手一个校企合作项目才发现南方科技大学开源的这套SUSTechPOINTS确实香。这个工具最打动我的三点首先是纯本地化部署标注敏感数据不用提心吊胆其次是支持多模态融合能同时处理激光雷达点云和相机图像最重要的是标注效率高实测标注一辆车的3D边界框比同类工具快30%。有次赶项目进度我们五个标注员用这套系统三天完成了8000帧点云标注。2. 从零开始的环境配置2.1 硬件准备建议虽然官方说普通电脑就能跑但我建议配置不能太寒酸。我们实验室用的工作站是戴尔Precision 5820配了RTX 5000显卡和64G内存。实测标注百万级点云时8G显存以下经常爆内存。如果预算有限至少保证CPUi7十代以上内存32G起步显卡GTX 1660Ti及以上注意千万别用虚拟机我当初偷懒想在VMware里装结果点云渲染直接卡成PPT。2.2 Ubuntu系统配置推荐Ubuntu 20.04 LTS别问为什么不用22.04——去年踩过的坑够写本书。安装完系统后必做三件事换国内源阿里或清华更新驱动sudo ubuntu-drivers autoinstall安装编译工具链sudo apt-get install build-essential git python3-dev \ libgl1-mesa-glx libegl1-mesa libxrandr-dev \ libxinerama-dev libxcursor-dev libxi-dev3. 手把手安装SUSTechPOINTS3.1 Conda环境搭建Python环境隔离太重要了我有次因为系统Python被污染debug到凌晨三点。建议这样创建环境conda create -n sustech python3.8 -y conda activate sustech pip install --upgrade pip setuptools wheel3.2 源码安装踩坑指南克隆代码时记得加--recursive参数不然子模块缺失会导致运行时诡异报错git clone --recursive https://github.com/naurril/SUSTechPOINTS.git cd SUSTechPOINTS安装依赖时有个隐藏坑点PyQt5的版本必须锁定在5.15.4新版会引发界面崩溃pip install -r requirements.txt pip install PyQt55.15.44. 标注实战全流程解析4.1 平台启动与初始化启动命令看着简单但有几个实用参数python main.py --port 8081 --host 0.0.0.0--port改端口避免冲突--host设置为0.0.0.0可支持远程访问首次打开网页端会有点慢因为要加载预训练模型。如果卡住检查algos/models目录下是否有deep_annotation_inference.h5文件。4.2 标注核心功能详解场景切换技巧按PageUp/PageDown快速切换场景在URL后加?scenexxx直接定位场景帧导航黑科技按住Shift鼠标滚轮10帧为单位跳转Ctrl左键点击时间轴精准定位关键帧3D标注效率秘籍先按B键进入框选模式按住Alt拖动调整盒子高度按R键重置视角时双击物体可自动居中5. 高级定制与性能优化5.1 自定义标注类别修改public/js/obj_cfg.js时要注意JSON格式。建议先在VS Code里校验我有次少打个逗号导致整个界面白屏。新增类别示例{ name: DeliveryRobot, color: #FF00FF, attributes: [with_box, moving], hotkey: r }5.2 大规模标注性能调优遇到点云卡顿时可以修改config.py中的参数RENDER_CONFIG { max_points: 500000, # 超过此值自动降采样 voxel_size: 0.03, # 降采样粒度 fps_limit: 30 # 渲染帧率限制 }如果是团队协作建议用Redis做结果缓存pip install redis python main.py --redis 127.0.0.1:6379最后提醒下标注完别忘了定期执行python tools/backup_annotations.py。有次实验室断电幸亏有自动备份功能才保住一周的工作量。这套系统我们用了大半年标注效率提升明显特别是批量编辑和自动补间功能处理连续帧时能省一半时间。