

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 3D-2D 点群オブジェクトの追跡のラベル付けジョブの作成
<a name="sms-3d-2d-point-cloud-object-tracking-create-labeling-job"></a>

3D-2D 点群のラベル付けジョブは、SageMaker の API オペレーション [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html) を使用して作成できます。このタスクタイプのラベル付けジョブを作成するには、次のものが必要です。
+ 自社またはベンダーのスタッフで構成された作業チーム。Amazon Mechanical Turk を 3D 点群のラベル付けジョブに使用することはできません。ワークフォースと作業チームの作成方法については、「[ワークフォース](sms-workforce-management.md)」を参照してください。
+ Amazon S3 コンソールで入力データを含む S3 バケットに CORS ポリシーを追加します。S3 コンソールで入力イメージを含む S3 バケットに必要な CORS ヘッダーを設定するには、「[CORS Permission Requirement](https://docs.aws.amazon.com/sagemaker/latest/dg/sms-cors-update.html)」で説明されている指示に従います。
+ また、「[Ground Truth を使用するための IAM アクセス権限を割り当てる](sms-security-permission.md)」を確認し、記載されている要件を満たすようにしてください 。

API を使用してラベル付けジョブを作成する方法については、次のセクションを参照してください。

## ラベル付けジョブを作成 (API)
<a name="sms-point-cloud-3d-2d-object-tracking-create-labeling-job-api"></a>

このセクションでは、SageMaker API オペレーション `CreateLabelingJob` を使用して 3D-2D オブジェクトの追跡のラベル付けジョブを作成する場合に知っておく必要のある詳細情報について説明します。この API は、すべての AWS SDKsに対してこのオペレーションを定義します。このオペレーションでサポートされている言語固有の SDK のリストを確認するには、[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html) の「**以下の資料も参照してください**」セクションを確認してください。

「[ラベル付けジョブを作成 (API)](sms-create-labeling-job-api.md)」では、`CreateLabelingJob` オペレーションの概要を説明しています。リクエストを設定する際には、それらの指示に従ったうえで、以下のことを実行してください。
+ `HumanTaskUiArn` の ARN を入力する必要があります。`arn:aws:sagemaker:{{<region>}}:394669845002:human-task-ui/PointCloudObjectTracking` を使用します。`{{<region>}}` を、ラベル付けジョブを作成している AWS のリージョンに置き換えます。

  `UiTemplateS3Uri` パラメータには値を入力しないでください。
+ [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html#sagemaker-CreateLabelingJob-request-LabelAttributeName](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html#sagemaker-CreateLabelingJob-request-LabelAttributeName) の末尾には、`-ref` を付ける必要があります。例えば、`{{ot-labels}}-ref`。
+ 入力マニフェストファイルは、点群フレームのシーケンスのマニフェストファイルである必要があります。詳細については、「[点群シーケンス入力マニフェストの作成](sms-point-cloud-multi-frame-input-data.md)」を参照してください。また、前述のように、ラベルカテゴリ設定ファイルを提供する必要もあります。
+ 注釈前および注釈後 (ACS) の Lambda 関数には、事前定義済みの ARN を指定する必要があります。これらの ARN は、ラベル付けジョブの作成に使用する AWS リージョンに固有です。
  + 注釈前の Lambda ARN を確認するには、「[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_HumanTaskConfig.html#sagemaker-Type-HumanTaskConfig-PreHumanTaskLambdaArn](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_HumanTaskConfig.html#sagemaker-Type-HumanTaskConfig-PreHumanTaskLambdaArn)」を参照してください。ラベル付けジョブを作成するリージョンに基づいて、`PRE-3DPointCloudObjectTracking` で終わる適切な ARN を見つけます。
  + 注釈後の Lambda ARN を確認するには、「[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_AnnotationConsolidationConfig.html#sagemaker-Type-AnnotationConsolidationConfig-AnnotationConsolidationLambdaArn](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_AnnotationConsolidationConfig.html#sagemaker-Type-AnnotationConsolidationConfig-AnnotationConsolidationLambdaArn)」を参照してください。ラベル付けジョブを作成するリージョンに基づいて、`ACS-3DPointCloudObjectTracking` で終わる適切な ARN を見つけます。
+ `NumberOfHumanWorkersPerDataObject` で指定するワーカーの数は `1` である必要があります。
+ 3D 点群のラベル付けジョブでは、自動データラベリングはサポートされていません。`[LabelingJobAlgorithmsConfig](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html#sagemaker-CreateLabelingJob-request-LabelingJobAlgorithmsConfig)` では、パラメータの値を指定しないでください。
+ 3D-2D オブジェクトの追跡のラベル付けジョブは、完了に数時間かかることがあります。このようなラベル付けジョブには、`TaskTimeLimitInSeconds` で制限時間を長く指定することができます (最長 7 日、つまり 604,800 秒)。

**注記**  
3D-2D オブジェクトの追跡ジョブが正常に作成されると、[ラベリングジョブ] の下のコンソールに表示されます。ジョブのタスクタイプは、**[ポイントクラウドオブジェクトの追跡]** と表示されます。

## 入力データ形式
<a name="sms-point-cloud-3d-2d-object-tracking-input-data"></a>

SageMaker API オペレーション [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html) を使用して、3D-2D オブジェクト追跡ジョブを作成します。このタスクタイプのラベル付けジョブを作成するには、次のものが必要です。
+ シーケンス入力マニフェストファイル。このタイプのマニフェストファイルを作成する方法については、「[点群シーケンス入力マニフェストの作成](sms-point-cloud-multi-frame-input-data.md)」を参照してください。Ground Truth の 3D 点群のラベル付けモダリティを初めて使用する場合は、[使用できる 3D の raw データ形式](sms-point-cloud-raw-data-types.md) を確認することをお勧めします。
+ ラベル、ラベルカテゴリ、フレーム属性、ワーカー向け指示書は、ラベルカテゴリ設定ファイルで指定します。このファイルを作成する方法については、「[Create a Labeling Category Configuration File with Label Category and Frame Attributes](https://docs.aws.amazon.com/sagemaker/latest/dg/sms-label-cat-config-attributes.html)」を参照してください。3D-2D オブジェクトの追跡ジョブを作成するためのラベルカテゴリ設定ファイルの例を次に示します。

  ```
  {
      "document-version": "2020-03-01",
      "categoryGlobalAttributes": [
          {
              "name": "Occlusion",
              "description": "global attribute that applies to all label categories",
              "type": "string",
              "enum":[
                  "Partial",
                  "Full"
              ]
          }
      ],
      "labels":[
          {
              "label": "Car",
              "attributes": [
                  {
                      "name": "Type",
                      "type": "string",
                      "enum": [
                          "SUV",
                          "Sedan"
                      ]
                  } 
              ]
          },
          {
              "label": "Bus",
              "attributes": [
                  {
                      "name": "Size",
                      "type": "string",
                      "enum": [
                          "Large",
                          "Medium",
                          "Small"
                      ]
                  }
              ]
          }
      ],
      "instructions": {
          "shortIntroduction": "Draw a tight cuboid around objects after you select a category.",
          "fullIntroduction": "<p>Use this area to add more detailed worker instructions.</p>"
      },
      "annotationType": [
          {
              "type": "BoundingBox"
          },
          {
              "type": "Cuboid"
          }
      ]
  }
  ```
**注記**  
3D-2D オブジェクト追跡ジョブを作成するには、ラベルカテゴリ設定ファイルに `BoundingBox` と `Cuboid` を annotationType として指定する必要があります。