本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 有標籤類別和影格屬性參考的標籤類別組態檔案
使用 Amazon SageMaker API 作業 `CreateLabelingJob` 建立 3D 點雲或影片影格標籤工作時，您可以使用標籤類別組態檔案指定標籤和工作者指示。或者，您還可以在標籤類別屬性檔案提供以下內容：
+ 您可以提供*標籤類別屬性*，給影片影格與 3D 點雲物件追蹤和物件偵測任務類型。工作者可以使用一個或多個屬性，提供有關該物件的更多資訊。例如，您可以使用 *occluded* 屬性，讓工作者知道物件有一部分被遮住。您可以使用 `categoryAttributes` 參數，以指定標籤類別屬性給單一標籤，如果要指定給所有標籤，請使用 `categoryGlobalAttributes` 參數。
+ 您可以使用 `frameAttributes` 提供影片影格和 3D 點雲物件追蹤和物件偵測任務類型的*影格屬性*。建立影格屬性時，該屬性會出現在工作者任務中的每個影格或點雲。在影片影格標籤工作中，這些是工作者指派給整個影片影格的屬性。針對 3D 點雲標籤工作，這些屬性將套用至單一點雲。使用影格屬性讓工作者提供有關特定影格或點雲中場景的更多資訊。
+ 針對影片影格標籤工作，您可以使用標籤類別組態檔案指定傳送給工作者的任務類型 (邊界框、折線、多邊形或關鍵點)。
針對工作者，指定標籤類別屬性和影格屬性的值屬於選擇性作法。
**重要**
只有在執行稽核工作以驗證或調整標籤時，才應該在 `auditLabelAttributeName` 中提供標籤屬性名稱。對於產生您要工作者調整的註釋之標籤工作，請使用此參數來輸入標籤工作中使用的 [LabelAttributeName](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html#sagemaker-CreateLabelingJob-request-LabelAttributeName)。在主控台建立標籤工作時，如果未指定標籤屬性名稱，則工作的**名稱**會做為 LabelAttributeName。
下列主題是不同標籤工作類型的標籤類別組態檔案範例。它們也會說明類別組態檔案的結構描述和配額。
**Topics**
+ [範例：3D 點雲標籤工作的標籤類別組態檔案](#sms-label-cat-config-attributes-3d-pc)
+ [範例：影片影格標籤工作的標籤類別組態檔案](#sms-label-cat-config-attributes-vid-frame)
+ [標籤類別組態檔案結構描述](#sms-label-cat-config-attributes-schema)
+ [標籤和標籤類別屬性配額](#sms-point-cloud-label-cat-limits)
## 範例：3D 點雲標籤工作的標籤類別組態檔案
下列主題是物件偵測、物件追蹤、語意分割、調整和驗證標籤工作的 3D 點雲標籤類別組態檔案範例。
**Topics**
+ [範例：3D 點雲物件追蹤和物件偵測](#example-3d-point-cloud-object)
+ [範例：3D 點雲語意分割](#example-3d-point-cloud-semantic)
+ [範例：3D 點雲調整](#example-3d-point-cloud-adjustment)
+ [範例：3D 點雲驗證](#example-3d-point-cloud-verification)
### 範例：3D 點雲物件追蹤和物件偵測
以下是標籤類別組態檔案的範例，該檔案包括用於 3D 點雲物件偵測或物件追蹤標籤工作的標籤類別屬性。此範例包括兩個影格屬性，這些屬性將加入提交至標籤工作的所有點雲。`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"],
"isRequired":true
},
],
"categoryGlobalAttributes": [
{
"name":"W",
"description":"label-attributes-for-all-labels",
"type":"string",
"enum": ["foo", "buzz", "biz"]
}
],
"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": [...]
}
],
"instructions": {"shortInstruction":"Draw a tight Cuboid", "fullInstruction":""}
}
```
### 範例：3D 點雲語意分割
以下是 3D 點雲語意分割標籤工作的標籤類別組態檔案範例。
3D 點雲語意分割任務類型不支援標籤類別屬性。支援影格屬性。如果您為語意分割標籤工作提供標籤類別屬性，則會忽略這些屬性。
```
{
"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"]
},
],
"labels": [
{
"label": "Car",
},
{
"label": "Pedestrian",
},
{
"label": "Cyclist",
}
],
"instructions": {"shortInstruction":"Select the appropriate label and paint all objects in the point cloud that it applies to the same color", "fullInstruction":""}
}
```
### 範例：3D 點雲調整
以下是標籤類別組態檔案的範例，用於 3D 點雲物件偵測或物件追蹤調整標籤工作。針對 3D 點雲語意分割調整標籤工作，`categoryGlobalAttributes` 和 `categoryAttributes` 並未獲得支援。
您必須包含 `auditLabelAttributeName`，才能指定先前用於建立調整標籤工作之標籤工作的標籤屬性名稱。或者，您可以使用 `editsAllowed` 參數指定是否可以編輯標籤或影格屬性。
```
{
"documentVersion": "2020-03-01",
"frameAttributes": [
{
"name":"count players",
"description":"How many players to you see in the scene?",
"type":"number"
},
{
"name":"select one",
"editsAllowed":"none",
"description":"describe the scene",
"type":"string",
"enum":["clear","blurry"]
},
],
"categoryGlobalAttributes": [
{
"name":"W",
"editsAllowed":"any",
"description":"label-attributes-for-all-labels",
"type":"string",
"enum": ["foo", "buzz", "biz"]
}
],
"labels": [
{
"label": "Car",
"editsAllowed":"any",
"categoryAttributes": [
{
"name":"X",
"description":"enter a number",
"type":"number"
},
{
"name":"Y",
"description":"select an option",
"type":"string",
"enum":["y1", "y2"],
"editsAllowed":"any"
},
{
"name":"Z",
"description":"submit a free-form response",
"type":"string",
"editsAllowed":"none"
}
]
},
{
"label": "Pedestrian",
"categoryAttributes": [...]
}
],
"instructions": {"shortInstruction":"Draw a tight Cuboid", "fullInstruction":""},
// include auditLabelAttributeName for label adjustment jobs
"auditLabelAttributeName": "myPrevJobLabelAttributeName"
}
```
### 範例：3D 點雲驗證
以下是標籤類別組態檔案的範例，您可用於 3D 點雲物件偵測或物件追蹤驗證標籤工作。針對 3D 點雲語意分割驗證標籤工作，`categoryGlobalAttributes` 和 `categoryAttributes` 並未獲得支援。
您必須包含 `auditLabelAttributeName`，才能指定先前用於建立驗證標籤工作之標籤工作的標籤屬性名稱。此外，您必須使用 `editsAllowed` 參數指定不能編輯任何標籤。
```
{
"documentVersion": "2020-03-01",
"frameAttributes": [
{
"name":"count players",
"editsAllowed":"any",
"description":"How many players to you see in the scene?",
"type":"number"
},
{
"name":"select one",
"editsAllowed":"any",
"description":"describe the scene",
"type":"string",
"enum":["clear","blurry"]
},
],
"categoryGlobalAttributes": [
{
"name":"W",
"editsAllowed":"none",
"description":"label-attributes-for-all-labels",
"type":"string",
"enum": ["foo", "buzz", "biz"]
}
],
"labels": [
{
"label": "Car",
"editsAllowed":"none",
"categoryAttributes": [
{
"name":"X",
"description":"enter a number",
"type":"number",
"editsAllowed":"none"
},
{
"name":"Y",
"description":"select an option",
"type":"string",
"enum":["y1", "y2"],
"editsAllowed":"any"
},
{
"name":"Z",
"description":"submit a free-form response",
"type":"string",
"editsAllowed":"none"
}
]
},
{
"label": "Pedestrian",
"editsAllowed":"none",
"categoryAttributes": [...]
}
],
"instructions": {"shortInstruction":"Draw a tight Cuboid", "fullInstruction":""},
// include auditLabelAttributeName for label verification jobs
"auditLabelAttributeName": "myPrevJobLabelAttributeName"
}
```
## 範例：影片影格標籤工作的標籤類別組態檔案
您的工作者和任務類型可用的註釋工具，取決於您為 `annotationType` 指定的值。例如，如果您希望工作者使用關鍵點追蹤多個影格中特定物件姿勢的變更，您可以為 `annotationType` 指定 `Keypoint`。如果您沒有指定註釋類型，則預設使用 `BoundingBox`。
下列主題是影片影格類別組態檔案的範例。
**Topics**
+ [範例：影片影格關鍵點](#example-video-frame-keypoint)
+ [範例：影片影格調整](#example-video-frame-adjustment)
+ [範例：影片影格驗證](#example-video-frame-verification)
### 範例：影片影格關鍵點
以下是具有標籤類別屬性之影片影格關鍵點標籤類別組態檔案的範例。此範例包含兩個影格屬性，這些屬性將新增至提交至標籤工作的所有影格。`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":""}
}
```
### 範例：影片影格調整
以下是可用於影片影格調整標籤工作的標籤類別組態檔案範例。
您必須包含 `auditLabelAttributeName`，才能指定先前用於建立驗證標籤工作之標籤工作的標籤屬性名稱。或者，您可以使用 `editsAllowed` 參數指定是否可以編輯標籤、標籤類別屬性或影格屬性。
```
{
"documentVersion": "2020-03-01",
"frameAttributes": [
{
"name":"count players",
"editsAllowed":"none",
"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",
"editsAllowed":"any",
"description":"label-attributes-for-all-labels",
"type":"string",
"enum": ["foo", "buz", "buz2"]
}
],
"labels": [
{
"label": "Car",
"editsAllowed":"any",
"categoryAttributes": [
{
"name":"X",
"description":"enter a number",
"type":"number",
"editsAllowed":"any"
},
{
"name":"Y",
"description":"select an option",
"type":"string",
"enum": ["y1", "y2"],
"editsAllowed":"any"
},
{
"name":"Z",
"description":"submit a free-form response",
"type":"string",
"editsAllowed":"none"
}
]
},
{
"label": "Pedestrian",
"editsAllowed":"none",
"categoryAttributes": [...]
}
],
"annotationType":"Keypoint",
"instructions": {"shortInstruction":"add example short instructions here", "fullInstruction":""},
// include auditLabelAttributeName for label adjustment jobs
"auditLabelAttributeName": "myPrevJobLabelAttributeName"
}
```
### 範例：影片影格驗證
以下是影片影格標籤工作的標籤類別組態檔案範例。
您必須包含 `auditLabelAttributeName`，才能指定先前用於建立驗證標籤工作之標籤工作的標籤屬性名稱。此外，您必須使用 `editsAllowed` 參數指定不能編輯任何標籤。
```
{
"documentVersion": "2020-03-01",
"frameAttributes": [
{
"name":"count players",
"editsAllowed":"none",
"description":"How many players to you see in the scene?",
"type":"number"
},
{
"name":"select one",
"editsAllowed":"any",
"description":"describe the scene",
"type":"string",
"enum":["clear","blurry"]
},
],
"categoryGlobalAttributes": [
{
"name":"W",
"editsAllowed":"none",
"description":"label-attributes-for-all-labels",
"type":"string",
"enum": ["foo", "buz", "buz2"]
}
],
"labels": [
{
"label": "Car",
"editsAllowed":"none",
"categoryAttributes": [
{
"name":"X",
"description":"enter a number",
"type":"number",
"editsAllowed":"any"
},
{
"name":"Y",
"description":"select an option",
"type":"string",
"enum": ["y1", "y2"],
"editsAllowed":"any"
},
{
"name":"Z",
"description":"submit a free-form response",
"type":"string",
"editsAllowed":"none"
}
]
},
{
"label": "Pedestrian",
"editsAllowed":"none",
"categoryAttributes": [...]
}
],
"annotationType":"Keypoint",
"instructions": {"shortInstruction":"add example short instructions here", "fullInstruction":""},
// include auditLabelAttributeName for label adjustment jobs
"auditLabelAttributeName": "myPrevJobLabelAttributeName"
}
```
## 標籤類別組態檔案結構描述
下表列出標籤類別組態檔案中可以和必須包含的元素。
**注意**
僅影片影格標籤工作支援參數 `annotationType`。
****
| 參數 | 必要 | 接受的值 | Description |
| --- | --- | --- | --- |
| frameAttributes | 否 | JSON 物件的清單。 **每個 JSON 物件中的必要參數：** `name`, `type`, `description` 如果 `type` 是 `"number"`，`minimum` 和 `maximum` 是必要的。 **每個 JSON 物件中的選用參數：** `enum`, `editsAllowed`, `isRequired` | 使用此參數可建立套用至標籤工作中所有影格或 3D 點雲的影格屬性。如果需要更多相關資訊，請參閱本節內的第三個表格。 |
| categoryGlobalAttributes | 否 | JSON 物件的清單。 **每個 JSON 物件中的必要參數：** `name`, `type` 如果 `type` 是 `"number"`，`minimum` 和 `maximum` 是必要的。 **每個 JSON 物件中的選用參數：** `description`, `enum`, `editsAllowed`, `isRequired` | 使用此參數建立標籤類別屬性，以套用至您在 `labels` 中指定的所有標籤。如果需要更多相關資訊，請參閱本節內的第三個表格。 |
| labels | 是 | 最多 30 個 JSON 物件的清單 **每個 JSON 物件中的必要參數：** `label` **每個 JSON 物件中的選用參數：** `categoryAttributes`, `editsAllowed` | 使用此參數來指定標籤或類別。為每個類別新增一個 `label`。 若要將標籤類別屬性新增至標籤，請將 `categoryAttributes` 新增至該標籤。 用 `editsAllowed` 指定是否可以在調整標籤工作中編輯標籤。針對驗證標籤工作將 `editsAllowed` 設定為 `"none"`。 如需詳細資訊，請參閱下表。 |
| annotationType (僅影片影格標籤工作支援) | 否 | String **接受的參數：** `BoundingBox`, `Polyline`, `Polygon`, `Keypoint` **預設值**： `BoundingBox` | 使用此選項可指定影片影格標籤工作的任務類型。例如，若為多邊形影片影格物件偵測任務，請選擇 `Polygon`。 如果您在建立影片影格標籤工作時未指定 `annotationType`，則根據預設 Ground Truth 會使用 `BoundingBox`。 |
| instructions | 否 | JSON 物件每個 JSON 物件中的必要參數：`"shortInstruction"`, `"fullInstruction"` | 使用此參數來新增工作者指示，以協助工作者完成任務。如需工作者指示的詳細資訊，請參閱[工作者指示](sms-point-cloud-general-information.md#sms-point-cloud-worker-instructions-general)。 簡短指示必須少於 255 個字元，詳細指示必須少於 2,048 個字元。 如需詳細資訊，請參閱[建立指示頁面](sms-creating-instruction-pages.md)。 |
| auditLabelAttributeName | 調整與驗證任務類型為必要項目 | String | 針對您要調整註釋的標籤工作，輸入此工作中使用的 [LabelAttributeName](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html#sagemaker-CreateLabelingJob-request-LabelAttributeName)。 僅在為影片影格和 3D 點雲物件偵測、物件追蹤或 3D 點雲語意分割建立調整工作時，才使用此參數。 |
### 標籤物件結構描述
下表說明您可以且必須用來建立 `Labels` 清單的參數。每個參數都應包含在 JSON 物件中。
****
| 參數 | 必要 | 接受的值 | Description |
| --- | --- | --- | --- |
| label | 是 | String | 顯示給工作者的標籤類別名稱。每個標籤類別名稱必須是唯一的。 |
| categoryAttributes | 否 | JSON 物件的清單。 **每個 JSON 物件中的必要參數：** `name`, `type` 如果 `type` 是 `"number"`，則 `minimum` 與 `maximum` 為必要。 **每個 JSON 物件中的選用參數：** `description`, `enum`, `editsAllowed`, `isRequired` | 針對您在 `labels` 指定的特定標籤，使用此參數新增標籤類別屬性。針對將一或多個標籤類別屬性新增至標籤，請將 `categoryAttributes` JSON 物件包含在與 `label` 相同的 `labels` JSON 物件中。如需詳細資訊，請參閱下表。 |
| editsAllowed | 否 | String **支援的值**： `"none"`：不允許任何修改。 或 `"any"` (預設值)：允許所有修改。 | 指定工作者是否可以編輯標籤。 針對影片影格或 3D 點雲*調整*標籤工作，請將此參數新增至 `labels` 清單中的一個或多個 JSON 物件，指定工作者是否可以編輯標籤。 針對 3D 點雲和影片影格*驗證*標籤工作，請將此參數及值 `"none"` 新增至 `labels` 清單中的每個 JSON 物件。這將使所有標籤變得無法編輯。 |
### frameAttributes 和 categoryGlobalAttributes 結構描述
下表說明您可以且必須使用的參數，以建立使用 `frameAttributes` 的影格屬性，以及使用 `categoryAttributes` 和 `categoryGlobalAttributes` 參數的標籤類別屬性。
****
| 參數 | 必要 | 接受的值 | Description |
| --- | --- | --- | --- |
| name | 是 | String | 使用此參數指派標籤類別或影格屬性的名稱。這是工作者看到的屬性名稱。 標籤類別組態檔案中的每個標籤類別屬性名稱都必須是唯一的。全域標籤類別屬性和特定標籤的標籤類別屬性名稱不能相同。 |
| type | 是 | String **必要值**： `"string"` 或 `"number"` | 使用此參數定義標籤類別或影格屬性類型。 如果您將 `type` 指定為 `"string"`，並為此屬性提供 `enum` 值，工作者將能夠從您提供的其中一個選項選擇。 如果您將 `type` 指定為 `"string"`，但不提供 `enum` 值，則工作者可以輸入任意格式文字。 如果您將 `type` 指定為 `number`，工作者可以輸入介於您指定的 `minimum` 和 `maximum` 數字之間的數字。 |
| enum | 否 | 字串清單 | 使用此參數，針對此標籤類別或影格屬性，定義可供工作者選擇的選項。工作者可以選擇 `enum` 中指定的一個值。例如，如果您為 `enum` 指定 `["foo", "buzz", "bar"`]，則工作者可以選擇 `foo`、`buzz` 或 `bar` 其中之一。 您必須為 `type` 指定 `"string"`，才能使用 `enum` 清單。 |
| description | `frameAttributes`：是 `categoryAttributes` 或 `categoryGlobalAttributes`：否 | String | 使用此參數新增標籤類別或影格屬性的描述。您可以使用此欄位為工作者提供有關屬性的詳細資訊。 只有影格屬性才需要此欄位。 |
| minimum 和 maximum | 如果屬性 type 為 "number" 則需要 | 整數 | 使用這些參數指定工作者可以為數值標籤類別或影格屬性輸入的最小和最大 (含) 值。 您必須為 `type` 指定 `"number"` 才能使用 `minimum` 和 `maximum`。 |
| editsAllowed | 否 | String **必要值**： `"none"`：不允許任何修改。 或 `"any"` (預設值)：允許所有修改。 | 指定工作者是否可以編輯標籤類別或影格屬性。 針對影片影格或 3D 點雲*調整*和*驗證*標籤工作，請將此參數新增至標籤類別和影格屬性 JSON 物件，指定工作者是否可以編輯屬性。 |
| isRequired | 否 | Boolean | 指定是否需要工作者才能註釋屬性。所有必要的屬性都註釋完畢，工作者才能提交工作。 |
## 標籤和標籤類別屬性配額
每個類別最多可以指定 10 個標籤類別屬性。這 10 個屬性的配額包括全域標籤類別屬性。例如，如果您建立四個全域標籤類別屬性，然後將三個標籤類別屬性指派給 `X` 標籤，則該標籤共有 4\$13=7 個標籤類別屬性。關於標籤類別和標籤類別屬性的所有限制，請參閱下表。
****
| Type | 最少 | 最多 |
| --- | --- | --- |
| 標籤 (`Labels`) | 1 | 30 |
| 標籤名稱字元配額 | 1 | 16 |
| 每個標籤的標籤類別屬性 (`categoryAttributes` 和 `categoryGlobalAttributes` 的總和) | 0 | 10 |
| 每個標籤的任意格式文字輸入標籤類別屬性 (`categoryAttributes` 和 `categoryGlobalAttributes` 的總和)。 | 0 | 5 |
| 影格屬性 | 0 | 10 |
| `frameAttributes` 中的任意格式文字輸入屬性。 | 0 | 5 |
| 屬性名稱字元配額 (`name`) | 1 | 16 |
| 屬性描述字元配額 (`description`) | 0 | 128 |
| 屬性類型字元配額 (`type`) | 1 | 16 |
| `string` 屬性 `enum` 清單中允許的值 | 1 | 10 |
| `enum` 清單中值的字元配額 | 1 | 16 |
| 自由格式文字 frameAttributes 之任意格式文字回應中的字元數目上限 | 0 | 1000 |
| 自由格式文字 categoryAttributes 與 categoryGlobalAttributes 之任意格式文字回應中的字元數目上限 | 0 | 80 |