保姆级教程：在Ubuntu 20.04上从零部署SUSTechPOINTS点云标注平台
保姆级教程：在Ubuntu 20.04上从零部署SUSTechPOINTS点云标注平台
点云标注是自动驾驶领域的基础工作之一，而SUSTechPOINTS作为一款开源的3D点云标注工具，因其简洁的界面和稳定的性能受到开发者青睐。本文将手把手带你完成从系统环境准备到服务启动的全过程，特别针对Ubuntu 20.04系统中可能遇到的依赖冲突、权限问题提供解决方案。
1. 环境准备与基础配置
在开始部署前，建议使用至少8GB内存的机器，并确保磁盘剩余空间超过20GB。显卡虽然不是必需项，但配备NVIDIA显卡能显著提升点云渲染效率。首先更新系统基础组件：
sudo apt update && sudo apt upgrade -y sudo apt install -y git wget build-essential libgl1-mesa-glx接下来安装Miniconda环境管理工具。相比Anaconda，Miniconda更轻量且适合生产环境：
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh bash Miniconda3-latest-Linux-x86_64.sh -b -p $HOME/miniconda echo 'export PATH="$HOME/miniconda/bin:$PATH"' >> ~/.bashrc source ~/.bashrc验证conda安装成功后，创建一个名为sustech的独立环境：
conda create -n sustech python=3.8 -y conda activate sustech注意：如果遇到
conda: command not found错误，请检查.bashrc文件是否正确加载了conda路径
2. 项目部署与依赖安装
获取项目源码时推荐使用深度克隆，确保获取所有分支和提交历史：
git clone --depth=1 https://github.com/naurril/SUSTechPOINTS.git cd SUSTechPOINTS安装依赖时常见的问题是部分库版本冲突。以下是经过验证的稳定版本组合：
| 依赖包 | 推荐版本 | 替代方案 |
|---|---|---|
| numpy | 1.21.6 | ≥1.20.0 |
| opencv-python | 4.5.5.64 | 避免使用4.6.x系列 |
| flask | 2.0.3 | 不兼容2.2.x新版 |
使用以下命令安装指定版本依赖：
pip install -r requirements.txt --no-cache-dir若遇到SSL相关错误，可尝试：
pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org -r requirements.txt3. 模型下载与配置调整
预训练模型是标注功能的核心组件。除官方提供的模型外，也可使用其他兼容模型：
mkdir -p algos/models wget --no-check-certificate https://github.com/naurril/SUSTechPOINTS/releases/download/0.1/deep_annotation_inference.h5 -P algos/models/配置文件位于public/js/obj_cfg.js，修改前建议备份原始文件。典型自定义配置示例如下：
const objCfg = { Car: { color: [255,0,0], size: [4.5,1.8,1.5] }, Pedestrian: { color: [0,255,0], size: [0.8,0.6,1.7] }, // 新增自定义类别 TrafficCone: { color: [255,165,0], // 橙色 size: [0.3,0.3,0.5] } };4. 服务启动与排错指南
启动服务时建议指定工作线程数：
python main.py --workers 4 --port 8081常见问题及解决方案：
- 端口冲突：通过
lsof -i :8081查找占用进程，或改用其他端口 - 模型加载失败：检查
algos/models/目录权限（应设为755） - 页面空白：清除浏览器缓存或使用隐私模式访问
访问服务后，操作界面主要功能区说明：
- 场景选择区：加载不同点云场景数据
- 帧控制区：切换连续帧进行时序标注
- 标注工具栏：包含立方体、多边形等标注工具
- 属性编辑区：修改对象类别、尺寸等属性
为提高标注效率，建议掌握以下快捷键：
| 快捷键 | 功能 | 适用场景 |
|---|---|---|
| B | 创建3D边界框 | 物体检测任务 |
| Ctrl+Z | 撤销上一步操作 | 误操作时恢复 |
| 空格键 | 暂停/继续帧播放 | 连续帧标注 |
5. 高级配置与优化建议
对于需要处理大规模点云的用户，可调整以下参数提升性能：
# 在config.py中修改 POINTCLOUD = { 'max_points': 500000, # 单帧最大点数 'voxel_size': 0.05, # 降采样体素大小 'preload': True # 预加载模式 }内存优化方案：
- 启用磁盘缓存：添加
--cache-dir /path/to/cache参数 - 限制历史记录：设置
--max-history 50保留最近50次操作
对于团队协作场景，建议：
- 使用Nginx反向代理实现多用户访问
- 定期备份
annotations/目录下的标注结果 - 通过
--read-only参数开启只读模式供审核使用
实际使用中发现，在标注连续帧时先完成关键帧标注，再使用插值功能自动生成中间帧结果，能提升30%以上的工作效率。对于特殊形状物体，可以组合使用多边形工具和3D立方体工具获得更精确的标注效果。