CVAT项目中Datumaro格式导出时Occluded属性处理问题解析

在计算机视觉标注工具CVAT的使用过程中，用户发现当使用Datumaro 1.0格式导出标注数据时，"occluded"（遮挡）属性值始终为false，无法正确保留在CVAT界面中设置的遮挡状态。本文将深入分析这一问题的技术背景和解决方案。

问题现象

用户在使用CVAT 2.28.0版本进行图像标注时，通过界面勾选框设置了对象的"occluded"属性。当导出为Datumaro 1.0格式时，发现所有标注的"occluded"值均为false，而使用"CVAT for Images 1.0"格式导出时则能正确保留该属性值。

技术分析

经过项目维护者的确认，这个问题实际上与CVAT中属性命名的保留关键字有关。"occluded"是CVAT中的一个内置保留属性，用于表示对象的遮挡状态。当用户尝试创建自定义的"occluded"属性时，系统会优先处理内置属性，导致自定义属性无法正常工作。

CVAT系统内部已经提供了原生的遮挡属性支持，用户无需额外创建自定义属性。在标注界面中，系统已经提供了专门的遮挡标记选项（通常显示为一个眼睛图标），这个标记会直接对应到内置的"occluded"属性。

解决方案

针对这个问题，有两种可行的解决方案：

1. 使用内置遮挡属性：直接利用CVAT提供的原生遮挡标记功能，而不是创建自定义的"occluded"属性。这种方法最为推荐，因为：

   • 完全兼容所有导出格式
   • 符合CVAT的标准工作流程
   • 确保数据一致性

2. 重命名自定义属性：如果确实需要额外的遮挡相关属性，可以将其命名为其他名称（如"is_occluded"、"visibility"等），避免与系统保留关键字冲突。这种方法适用于需要记录不同类型遮挡信息的特殊场景。

最佳实践建议

对于大多数CVAT用户，建议遵循以下工作流程处理遮挡属性：

1. 在标注对象时，使用CVAT内置的遮挡标记功能（通常位于标注工具栏中）
2. 避免创建名为"occluded"的自定义属性
3. 导出数据时，系统会自动处理内置的遮挡属性
4. 如需额外的可见性信息，考虑使用其他属性名称

通过理解CVAT中属性处理的内部机制，用户可以更有效地利用各种导出格式，确保标注数据的完整性和一致性。