从零开始：roLabelImg安装与OBB旋转框标注实战指南

1. 为什么需要roLabelImg和旋转框标注

在计算机视觉项目中，我们经常需要标注图像中的目标物体。对于常规的矩形框标注，LabelImg这类工具已经足够好用。但遇到倾斜物体时，比如遥感图像中的飞机、自然场景中的交通标志、医学图像中的器官，传统矩形框会包含大量背景区域，严重影响模型训练效果。

这时候就需要旋转框标注(Oriented Bounding Box, OBB)。我去年参与过一个航拍图像分析项目，电线杆、风力发电机这类细长物体用普通矩形框标注时，IOU(交并比)始终上不去。改用旋转框后，模型准确率直接提升了23%。roLabelImg就是专门解决这个痛点的开源工具，它支持：

• 通过快捷键调整旋转角度
• 导出YOLO格式标注文件
• 兼容PASCAL VOC标准
• 可视化角度参数

注意：虽然roLabelImg基于LabelImg开发，但旋转框标注生成的是带角度参数的XML文件，后续模型训练需要专门支持OBB的算法（如YOLOv8-OBB）

2. 环境配置与安装避坑指南

2.1 Anaconda环境搭建

我强烈建议使用Anaconda管理Python环境，避免系统环境污染。以下是实测可用的步骤：

# 创建专有环境（Python3.8最稳定） conda create -n roLabelImg python=3.8 conda activate roLabelImg

遇到过conda下载慢的问题？可以试试清华镜像源：

conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/ conda config --set show_channel_urls yes

2.2 关键依赖安装

PyQt5是图形界面的核心，但直接pip install pyqt5可能会缺少依赖。更稳妥的做法是：

# 安装完整Qt组件 conda install pyqt=5.15.7 # 验证安装（应弹出测试窗口） python -c "from PyQt5.QtWidgets import QApplication, QLabel; app = QApplication([]); label = QLabel('PyQt5 works!'); label.show(); app.exec_()"

其他必备依赖：

pip install lxml pillow

2.3 解决resources.py报错

原版LabelImg的编译步骤有个经典坑位：

# 在labelImg-master目录执行 pyrcc5 -o resources.py resources.qrc # 关键步骤！必须拷贝到libs目录 cp resources.py libs/

如果遇到ImportError: No module named 'libs.resources'，就是忘记执行拷贝操作了。这个坑我至少踩过三次...

3. 旋转框标注实战技巧

3.1 标注界面操作详解

成功运行roLabelImg后，你会看到这样的界面：

1. 文件操作区：Open Dir加载图像目录，Change Save Dir设置标注保存路径
2. 标注工具栏：Create RotatedRBox是核心功能
3. 快捷键说明：
   • Z/X：逆时针/顺时针微调角度（0.5°步长）
   • C/V：快速旋转90°/180°
   • 空格键：确认当前标注

实测发现，用Z/X键精细调整角度时，配合鼠标滚轮缩放图像能提升标注精度。对于密集小目标，建议先放大到400%再操作。

3.2 标注文件解析

生成的XML文件包含关键旋转参数：

<object> <name>ship</name> <robndbox> <cx>512.3</cx> <cy>256.8</cy> <w>124.5</w> <h>32.7</h> <angle>0.785</angle> <!-- 弧度制，π/4=45° --> </robndbox> </object>

角度参数需要注意：

• 0弧度表示水平方向
• 正值表示顺时针旋转
• 范围是0~π（不会出现负值）

4. 打包成EXE的进阶操作

4.1 PyInstaller配置要点

将工具打包成exe方便团队使用，但直接运行pyinstaller -F roLabelImg.py肯定会报错。需要特别处理路径问题：

pyinstaller -F -w \ --paths="你的Anaconda环境路径\Lib\site-packages" \ --paths="labelImg-master\libs" \ --add-data="resources.qrc;." \ roLabelImg.py

几个关键参数说明：

• -w：禁止弹出命令行窗口
• --paths：指定依赖库搜索路径
• --add-data：打包资源文件

4.2 解决动态库缺失问题

打包后运行时若报错Failed to load PyQt5，通常是动态库没正确打包。手动检查dist目录是否包含：

• PyQt5的Qt5Core.dll等文件
• platforms/qwindows.dll目录
• imageformats目录（支持不同图片格式）

最稳妥的方法是使用--collect-all参数：

pyinstaller -F -w \ --collect-all PyQt5 \ --collect-all lxml \ roLabelImg.py

4.3 性能优化建议

exe文件过大的解决方案：

1. 使用UPX压缩：

   pip install upx pyinstaller --upx-dir=path_to_upx ...

2. 排除不必要的库：

   --exclude-module=unused_lib

经过优化后，我打包的exe从380MB降到了120MB，启动速度提升40%。