本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用标签类别和帧属性创建标签类别配置文件
在使用 Amazon SageMaker API 操作 创建 3D 点云或视频帧标记作业时CreateLabelingJob
,您可以使用标签类别配置文件指定标签和工作人员说明。(可选)您也可以在标签类别属性文件中提供以下内容:
-
您可以为视频帧和 3D 点云对象跟踪以及对象检测任务类型提供标签类别属性。工作人员可以使用一个或多个属性来提供有关对象的更多信息。例如,您可能希望使用 occluded 属性,以使工作人员确定对象何时被部分遮挡。您可以使用
categoryAttributes
参数为单个标签指定标签类别属性,或者使用categoryGlobalAttributes
参数为所有标签指定标签类别属性。 -
您可以使用 为视频帧和 3D 点云对象跟踪以及对象检测任务类型提供帧属性
frameAttributes
。在创建帧属性时,该属性将显示在工作人员任务中的每个帧或点云上。在视频帧标记作业中,工作人员将这些设置分配给整个视频帧。对于 3D 点云标记作业,这些属性将应用于单个点云。使用帧属性可让工作人员提供有关特定帧或点云中的场景的更多信息。 -
对于视频帧标记作业,您可以使用标签类别配置文件指定发送给工作人员的任务类型(边界框、多边形、多边形或关键点)。
对于工作人员,为标签类别属性和帧属性指定值是可选的。
只有在运行审核作业以验证或调整标签auditLabelAttributeName
时,才应在 中提供标签属性名称。在生成您希望工作人员调整的注释的标记作业中,可以使用该参数以输入使用的 LabelAttributeName。在控制台中创建标记作业时,如果您未指定标签属性名称,则会将作业的 Name (名称) 作为 LabelAttributeName。
标签类别配置文件架构
下表列出了您可以或必须在标签类别配置文件中包含的元素。
annotationType
只有视频帧标记作业才支持 参数。
参数 |
必需 |
接受的值 |
描述 |
---|---|---|---|
frameAttributes |
否 |
JSON 对象的列表。 每个 JSON 对象中的必需参数:
每个 JSON 对象中的可选参数:
|
使用此参数可创建应用于标记作业中的所有帧或 3D 点云的帧属性。 有关更多信息,请参阅此部分中的第三个表。 |
categoryGlobalAttributes |
否 |
JSON 对象的列表。 每个 JSON 对象中的必需参数:
每个 JSON 对象中的可选参数:
|
使用此参数可创建应用于您在 中指定的所有标签的标签类别属性 |
labels |
是 |
最多包含 30 个 JSON 对象的列表 每个 JSON 对象中的必需参数:
每个 JSON 对象中的可选参数:
|
可以使用该参数以指定标签或类。为每个类添加一个 要将标签类别属性添加到一个标签中,请将 用于 有关更多信息,请参阅下表。 |
annotationType (仅支持视频帧标记作业)
|
否 |
字符串 接受的参数:
默认值:
|
使用此参数可为视频帧标记作业指定任务类型。例如,对于多边形视频帧对象检测任务,请选择 如果在创建视频帧标记作业 |
instructions |
否 |
JSON 对象 每个 JSON 对象中的必需参数:
|
可以使用该参数以添加工作人员说明,以帮助工作人员完成其任务。有关工作人员说明的更多信息,请参阅工作人员说明。 短说明必须少于 255 个字符,长说明必须少于 2,048 个字符。 有关更多信息,请参阅创建工作人员说明。 |
auditLabelAttributeName |
调整和验证任务类型所必需的 |
字符串 |
输入要调整注释的标记作业中使用的 LabelAttributeName。 仅当要为视频帧和 3D 点云对象检测、对象跟踪或 3D 点云语义分割创建调整作业时,才使用此参数。 |
下表描述了可用于和必须用于创建 列表的参数Labels
。每个参数都应包含在 JSON 对象中。
参数 | 必需 | 接受的值 | 描述 |
---|---|---|---|
label |
是 |
字符串 |
向工作人员显示的标签类别的名称。每个标签类别名称必须是唯一的。 |
categoryAttributes |
否 |
JSON 对象的列表。 每个 JSON 对象中的必需参数:
每个 JSON 对象中的可选参数:
|
使用此参数可将标签类别属性添加到您在 中指定的特定标签中 要向标签添加一个或多个标签类别属性,请在与该 相同的 |
editsAllowed |
否 |
字符串 支持的值:
或
|
指定工作人员是否可以编辑标签。 对于视频帧或 3D点云调整标记作业,请将此参数添加到 对于 3D 点云和视频帧验证标记作业,请将此参数与 值 |
下表描述了您可以使用和必须使用的参数,通过 和 参数,使用 frameAttributes
和 标签类别属性创建帧属性categoryGlobalAttributes
categoryAttributes
。
参数 |
必需 |
接受的值 |
描述 |
---|---|---|---|
name |
是 |
字符串 |
使用此参数可为标签类别或帧属性分配名称。这是工作人员看到的属性名称。 标签类别配置文件中的每个标签类别属性名称必须唯一。全局标签类别属性和标签特定标签类别属性不能具有相同的名称。 |
type |
是 |
字符串 必需的值:
|
使用此参数定义标签类别或帧属性类型。 如果您 如果您 如果您 |
enum |
是 |
字符串列表 |
使用此参数可定义工作人员可从中为该标签类别或帧属性选择的选项。工作人员可以选择在 您必须 |
description |
|
字符串 |
使用此参数可添加标签类别或帧属性的描述。您可以使用此字段为工作人员提供有关 属性的更多信息。 此字段仅对帧属性是必填字段。 |
minimum 和 maximum |
如果 属性type 为 ,则是必需的 "number" |
整数 |
使用这些参数指定工作人员可为数字标签类别或帧属性输入的最小值和最大(含)值。 您必须 |
editsAllowed |
否 |
字符串 必需的值:
或
|
指定工作人员是否可以编辑标签类别或帧属性。 对于视频帧或 3D点云调整和验证标记作业,请将此参数添加到标签类别和帧属性 JSON 对象以指定工作人员是否可以编辑属性。 |
标签和标签类别属性配额
您最多可以为每个类指定 10 个标签类别属性。该 10 属性配额包括全局标签类别属性。例如,如果您创建 4 个全局标签类别属性,然后将三个标签类别属性分配给标签 X
,则该标签总共具有 4+3=7 个标签类别属性。有关所有标签类别和标签类别属性限制,请参阅下表。
Type |
Min |
Max |
---|---|---|
标签 ( |
1 |
30 |
标签名称字符配额 |
1 |
16 |
每个标签的标签类别属性( |
0 |
10 |
每个标签的自由格式文本条目标签类别属性( |
0 | 5 |
帧属性 |
0 |
10 |
在 中自由格式文本条目属性 |
0 | 5 |
属性名称字符配额 ( |
1 |
16 |
属性描述字符配额 ( |
0 |
128 |
属性类型字符配额 ( |
1 |
16 |
|
1 | 10 |
|
1 | 16 |
自由格式文本响应中自由格式文本的最大字符数 frameAttributes |
0 | 1000 |
自由格式文本响应的最大字符数,用于自由格式文本categoryAttributes 和 categoryGlobalAttributes |
0 | 80 |
示例3D 点云标记作业的标签类别配置文件
在下表中选择一个选项卡,以查看用于对象检测、对象跟踪、语义分割、调整和验证标记作业的 3D 点云标签类别配置文件的示例。
选择下表中的选项卡以查看 3D 点云验证或调整标记作业的标签类别配置文件的示例。
示例:视频帧标记作业的标签类别配置文件
对您的工作程序和任务类型可用的注释工具取决于您为 指定的值annotationType
。例如,如果您希望工作人员使用关键点来跟踪多个帧中特定对象的姿势的变化,则应Keypoint
为 指定 annotationType
。如果您未指定注释类型,则默认情况下BoundingBox
将使用 。
以下是包含标签类别属性的视频帧关键点标签类别配置文件的示例。此示例包含两个帧属性,这些属性将添加到提交到标记作业的所有帧中。Car
标签将包含四个标签类别属性 —X
Y
、 Z
和全局属性 W
。
{ "documentVersion": "2020-03-01", "frameAttributes": [ { "name":"
count players
", "description":"How many players to you see in the scene?
", "type":"number
" }, { "name":"select one
", "description":"describe the scene
", "type":"string
", "enum":["clear
","blurry
"] }, ], "categoryGlobalAttributes": [ { "name":"W
", "description":"label-attributes-for-all-labels
", "type":"string
", "enum": ["foo
", "buz
", "buz2
"] } ], "labels": [ { "label": "Car
", "categoryAttributes": [ { "name":"X
", "description":"enter a number
", "type":"number
", }, { "name":"Y
", "description":"select an option
", "type":"string
", "enum": ["y1
", "y2
"] }, { "name":"Z
", "description":"submit a free-form response
", "type":"string
", } ] }, { "label": "Pedestrian", "categoryAttributes": [...
] } ], "annotationType":"Keypoint
", "instructions": {"shortInstruction":"add example short instructions here
", "fullInstruction":"<html markup>
"} }
从下表中选择一个选项卡,以查看视频帧调整和验证标记作业的标签类别配置文件示例。
创建工作人员说明
创建有关标记作业的自定义说明,以提高工作人员完成其任务的准确性。当工作人员在工作人员 UI 中选择 Instructions (说明) 菜单选项时,便可以访问您的说明。短说明必须少于 255 个字符,长说明必须少于 2,048 个字符。
说明分为两种:
-
简短说明 – 当工作人员在工作人员 UI 菜单中选择 Instructions (说明) 时,将向他们显示这些说明。它们应提供简单的参考内容,以向工作人员显示标记对象的正确方法。
-
完整说明 – 当工作人员在 instructions (说明) 弹出窗口中选择 More Instructions (更多说明) 时,将显示这些说明。如果要完成的任务使用多个示例来显示边缘情况和其他难以标记对象的情况,我们建议您提供详细说明。
对于 3D 点云和视频帧标记作业,您可以将工作人员说明添加到标签类别配置文件中。您可以使用单个字符串以创建说明,也可以添加 HTML 标记以自定义说明外观和添加图像。确保您在说明中包含的任何图像是公开可用的,或者如果说明位于 Amazon S3 中,请确保工作人员具有读取访问权限,以便他们可以查看这些说明。