Allegro数据标注实战：如何正确显示标注数据的单位

1次阅读

共计 2050 个字符，预计需要花费 6 分钟才能阅读完成。

在数据标注工作中，单位显示不明确或缺失是一个常见但容易被忽视的问题。这会导致后续数据处理、模型训练和分析时出现严重偏差。例如，在图像标注中，边界框的尺寸如果没有明确单位（像素、厘米等），不同标注人员可能采用不同标准；在传感器数据标注中，缺少单位（如℃、m/s）可能直接导致模型误用数据。

常见问题包括：

单位字段未强制要求，标注人员遗漏
同一项目中出现多种单位格式（如 ”cm” 与 ” 厘米 ” 混用）
单位信息未与标注数据绑定，导出后丢失

相比 LabelMe、CVAT 等开源工具，Allegro 在单位管理上提供更完整的解决方案：

结构化字段支持：允许预定义单位字段类型（下拉框 / 文本框），避免自由输入导致的格式混乱
API 级集成：单位信息直接写入标注文件的 metadata 层，与数据不可分割
批量处理能力：支持通过脚本对历史标注追加或修改单位信息

在 Allegro 项目设置中，进入 ”Schema Configuration” 添加单位字段：

点击 ”Add Field” 选择 ”Text” 或 ”Select” 类型
命名字段为 ”unit” 或自定义名称（建议英文）
对 Select 类型可预设选项（如 px, cm, m）
勾选 ”Required” 强制填写

标注界面会自动显示配置的单位字段。对于边界框标注：

绘制标注区域后，在属性面板找到单位字段
选择或输入单位（如选择 ”px”）
保存后单位信息将随坐标一起存储

导出的 JSON 格式示例（关键字段）：

{
  "annotations": [{"bbox": [100, 150, 200, 250],
    "metadata": {"unit": "px"}
  }]
}

以下 Python 脚本演示如何通过 Allegro API 批量添加单位：

import requests
from tqdm import tqdm

# 配置 API 密钥和项目 ID
API_KEY = "your_api_key"
PROJECT_ID = "project_123"

headers = {"Authorization": f"Key {API_KEY}",
    "Content-Type": "application/json"
}

# 获取所有未设置单位的标注
def get_annotations():
    url = f"https://api.allegro.ai/v1/projects/{PROJECT_ID}/annotations?filter=unit__null"
    response = requests.get(url, headers=headers)
    return response.json()["results"]

# 批量更新单位字段
def update_unit(annotation_id, unit):
    url = f"https://api.allegro.ai/v1/annotations/{annotation_id}"
    data = {"metadata": {"unit": unit}}
    requests.patch(url, json=data, headers=headers)

# 主流程
annotations = get_annotations()
for ann in tqdm(annotations):
    update_unit(ann["id"], "px")  # 统一设置为像素单位

关键参数说明：