Label Studio中多边形标注与YOLOv8 OBB导出的注意事项

在计算机视觉标注工具Label Studio中，多边形标注是一个常用功能，但在与YOLOv8 OBB格式导出配合使用时，开发者需要注意工具选择对导出结果的影响。本文将详细介绍多边形标注的正确使用方法，帮助用户避免常见的导出问题。

多边形标注工具的选择

Label Studio提供了两种实现多边形标注的方式：

1. 独立多边形工具：使用<Polygon>标签
2. 带标签的多边形工具：使用<PolygonLabels>标签

这两种工具在界面操作上可能看起来相似，但在底层数据结构和导出行为上存在重要差异。

问题现象分析

当用户使用<Polygon>与<Labels>组合配置时：

<View>
    <Image name="image" value="$image" zoom="true" />
    <Labels name="Type" toName="image" choice="single">
        <Label value="Airplane" background="red" />
        <Label value="Car" background="blue" />
    </Labels>
    <Polygon name="polygons" toName="image" />
</View>

虽然可以在界面上完成多边形标注并关联标签，但在导出为YOLOv8 OBB格式时，多边形点集数据会丢失。这是因为独立<Polygon>工具生成的标注数据结构与YOLO格式要求不完全兼容。

推荐解决方案

正确的做法是使用<PolygonLabels>标签：

<View>
    <Image name="image" value="$image" zoom="true" />
    <PolygonLabels name="label" toName="image">
        <Label value="Airplane" background="red" />
        <Label value="Car" background="blue" />
    </PolygonLabels>
</View>

<PolygonLabels>是专门为带标签的多边形标注设计的工具，它能够：

• 在标注时直接关联标签
• 保持标注数据结构与YOLO格式兼容
• 确保导出时包含完整的多边形点集数据

技术原理深入

YOLOv8 OBB(Oriented Bounding Box)格式需要包含多边形旋转框的所有顶点坐标。<PolygonLabels>工具生成的标注数据会以特定格式存储这些顶点信息，而独立<Polygon>工具生成的数据结构在导出转换时可能无法被正确识别和保留。

最佳实践建议

1. 对于纯多边形标注需求，优先使用<PolygonLabels>而非<Polygon>
2. 如果需要混合使用多种标注工具，确保每种工具都有明确的标签关联
3. 在复杂标注场景中，可以先小规模测试导出结果，确认数据结构是否符合预期
4. 定期检查Label Studio更新日志，了解标注工具的功能改进

通过正确选择标注工具，用户可以确保多边形标注数据在各种导出格式下都能保持完整性和可用性。