本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 3D 點雲標籤工作概觀 本主題概述 Ground Truth 3D 點雲標籤工作的獨特功能。您可以使用 3D 點雲標籤工作，讓工作者標籤 3D 點雲中的物件，而物件可能產生自 3D 感應器 (例如 LiDAR 和景深相機)，或透過 3D 重建拼接由媒介 (例如無人機) 拍攝的影像而產生。 ## 工作預處理時間 建立 3D 點雲標籤工作時，您需要提供[輸入資訊清單檔案](sms-point-cloud-input-data.md)。輸入資訊清單檔案可以是： + *影格輸入資訊清單檔案*，每行各一個點雲影格。 + *序列輸入資訊清單檔案*，每行各一個序列。序列定義為一系列瞬間的點雲影格。 對於這兩種資訊清單檔案，*工作預處理時間* (也就是 Ground Truth 開始將任務傳送給工作者之前的時間) 取決於您在輸入資訊清單檔案中提供的點雲影格總數和大小。對於影格輸入資訊清單檔案，這是資訊清單檔案中的行數。對於序列資訊清單檔案，這是每個序列中的影格數乘以資訊清單檔案中的序列總數或總行數。 此外，每個點雲的點數和融合的感應器資料物件數 (例如影像)，也是影響工作預處理時間的因素。平均而言，Ground Truth 可以在大約 5 分鐘內預先處理 200 個點雲影格。如果您建立的 3D 點雲標籤工作有大量的點雲影格，您可能會經歷更長的工作預處理時間。例如，如果您建立的序列輸入資訊清單檔案有 4 個點雲序列，且每個序列包含 200 個點雲，則 Ground Truth 會預處理 800 個點雲，因此，工作預處理時間可能大約 20 分鐘。在此期間，標籤工作狀態為 `InProgress`。 當 3D 點雲標籤工作正在預處理時，您會收到 CloudWatch 訊息向您告知工作狀態。若要識別這些訊息，請在標籤工作日誌中搜尋 `3D_POINT_CLOUD_PROCESSING_STATUS`。 對於**影格輸入資訊清單檔案**，CloudWatch 日誌會有類似以下的訊息： ``` { "labeling-job-name": "example-point-cloud-labeling-job", "event-name": "3D_POINT_CLOUD_PROCESSING_STATUS", "event-log-message": "datasetObjectId from: 0 to 10, status: IN_PROGRESS" } ``` 事件日誌訊息 `datasetObjectId from: 0 to 10, status: IN_PROGRESS` 識別輸入資訊清單中已處理的影格數。每次處理影格後，您就會收到新訊息。例如，處理單一影格之後，您會收到另一則訊息指出 `datasetObjectId from: 1 to 10, status: IN_PROGRESS`。 對於**序列輸入資訊清單檔案**，CloudWatch 日誌會有類似以下的訊息： ``` { "labeling-job-name": "example-point-cloud-labeling-job", "event-name": "3D_POINT_CLOUD_PROCESSING_STATUS", "event-log-message": "datasetObjectId: 0, status: IN_PROGRESS" } ``` 事件日誌訊息 `datasetObjectId from: 0, status: IN_PROGRESS` 識別輸入資訊清單中已處理的序列數。每次處理序列後，您就會收到新訊息。例如，處理單一序列之後，在下一個序列開始處理時，您會收到一則訊息指出 `datasetObjectId from: 1, status: IN_PROGRESS`。 ## 工作完成時間 工作者可能需要花數小時來完成 3D 點雲標籤工作。當您建立標籤工作時，您可以設定工作者可花在處理每個任務的總時間。工作者花在處理任務的時間最多可設為 7 天。預設值為 3 天。 強烈建議您建立可讓工作者在 12 小時內完成的任務。工作者在處理任務時，必須保持開啟工作者使用者介面。他們可以在離開時儲存工作，Ground Truth 每 15 分鐘會儲存一次工作。 使用 SageMaker AI `CreateLabelingJob` API 作業時，請在 `HumanTaskConfig` 的 `TaskTimeLimitInSeconds` 參數中設定可讓工作者處理任務的總時間。 當您在主控台建立標籤工作時，您可以在選取人力資源類型和工作團隊時指定此時間限制。 ## 人力資源 建立 3D 點雲標籤工作時，您需要指定負責完成點雲註釋任務的工作團隊。您可以從您自己的工作者私有人力資源中，或從您在 AWS Marketplace中選取的廠商人力資源中，選擇工作團隊。您不能使用 Amazon Mechanical Turk 人力資源來處理 3D 點雲標籤工作。 若要進一步了解廠商人力資源，請參閱[訂用廠商人力資源](sms-workforce-management-vendor.md)。 若要了解如何建立和管理私有人力資源，請參閱[私有人力資源](sms-workforce-private.md)。 ## 工作者使用者介面 (UI) Ground Truth 提供工作者使用者介面 (UI)、工具和輔助標籤功能，以協助工作者完成 3D 點雲標籤任務。 在主控台建立標籤工作時，您可以預覽工作者使用者介面。 若要使用 API 作業 `CreateLabelingJob` 建立標籤工作，您必須提供參數 [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UiConfig.html#sagemaker-Type-UiConfig-UiTemplateS3Uri](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UiConfig.html#sagemaker-Type-UiConfig-UiTemplateS3Uri) 由 Ground Truth 提供的 ARN，來為您的任務類型指定工作者使用者介面。您可以使用 `HumanTaskUiArn` 搭配 SageMaker AI [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_RenderUiTemplate.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_RenderUiTemplate.html) API 作業，以預覽工作者使用者介面。 您可以提供工作者指示、標籤及 (選擇提供) 標籤類別屬性，以顯示在工作者使用者介面中。 ### 標籤類別屬性 建立 3D 點雲物件追蹤或物件偵測標籤工作時，您可以新增一個或多個*標任類別屬性*。您可以將*影格屬性*新增至所有 3D 點雲任務類型： + **標籤類別屬性** — 選項清單 (字串)、任意格式文字方塊，或與一或多個標籤相關聯的數值欄位。工作者以此來提供有關標籤的中繼資料。 + **影格屬性** — 在工作者傳送給註釋的每個點雲影格上顯示的選項 (字串)、任意格式文字方塊或數值欄位的清單。工作者以此來提供有關影格的中繼資料。 此外，您可以使用標籤和影格屬性讓工作者在 3D 點雲標籤驗證工作中驗證標籤。 請參閱下列各節，進一步了解這些屬性。若要瞭解如何將標籤類別和影格屬性新增至標籤工作，請使用您選擇的[任務類型頁面](https://docs.aws.amazon.com/sagemaker/latest/dg/sms-point-cloud-task-types)上的**建立標籤工作**區段。 #### 標籤類別屬性 將標籤類別屬性新增至標籤，方便工作者提供有關其建立註釋的更多資訊。標籤類別屬性會新增至個別標籤或所有標籤。將標籤類別屬性套用至所有標籤時，即稱為*全域標籤類別屬性*。 舉例來說，若您新增標籤類別 *car* (汽車)，您也可能想要擷取所標籤汽車的更多資料，例如是否被遮住或車輛大小。您可以使用標籤類別屬性來擷取此中繼資料。在此範例中，如果您將 *occluded* 屬性新增至 car 標籤類別，您可能會將 *partial*、*completely*、*no* 指派給 *occluded* 屬性，而工作者可以選取其中一個選項。 建立標籤驗證工作時，您可以將標籤類別屬性新增至您希望工作者驗證的每個標籤。 #### 影格屬性 新增影格屬性以使工作者能夠提供有關個別點雲影格的更多資訊。您最多可以指定 10 個影格屬性，這些屬性會出現在所有影格上。 例如，您可以新增允許工作者輸入數字的影格屬性。您可能想要使用此屬性，讓工作者識別他們在特定影格中看到的物件數量。 在另一個範例中，您可能想要提供任意格式文字方塊，讓工作者能夠為問題提供任意格式的答案。 建立標籤驗證工作時，您可以新增一個或多個影格屬性，以要求工作者針對點雲影格中的所有標籤提供意見回饋。 ### 工作者指示 您可以提供工作者指示，以協助工作者完成點雲標籤任務。您使用這些指示可能是為了： + 註釋物件時的最佳實務和避免事項。 + 解釋所提供的標籤類別屬性 (關於物件偵測和物件追蹤任務) 及其用法。 + 建議在標籤時如何使用鍵盤快速鍵來節省時間。 建立標籤工作時，您可以使用 SageMaker AI 主控台新增工作者指示。如果您使用 API 作業 `CreateLabelingJob` 建立標籤工作，請在標籤類別組態檔案中指定工作者指示。 除了您的指示之外，Ground Truth 還提供連結，以協助工作者導覽和使用工作者入口網站。請在[工作者指示](sms-point-cloud-worker-instructions.md)中選取任務類型，以檢視這些指示。 ### 拒絕任務 工作者能拒絕任務。 如果指示不清楚、輸入的資料顯示不正確，或者遇到任務的其他問題，工作者可以拒絕該任務。如果每個資料集物件 ([https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_HumanTaskConfig.html#sagemaker-Type-HumanTaskConfig-NumberOfHumanWorkersPerDataObject](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_HumanTaskConfig.html#sagemaker-Type-HumanTaskConfig-NumberOfHumanWorkersPerDataObject)) 的工作者數量拒絕任務，則資料物件會標記為已過期，且不會傳送給其他工作者。 # 3D 點雲標籤工作許可要求 建立 3D 點雲標籤工作時，除了[指派 IAM 許可以使用 Ground Truth](sms-security-permission.md)中列出的許可需求，您還必須將 CORS 政策新增至包含輸入資訊清單檔案的 S3 儲存貯體。 ## 將 CORS 權限政策新增至 S3 儲存貯體 建立 3D 點雲標籤工作時，您可以指定 S3 中的儲存貯體，其中有您的輸入資料和資訊清單檔案，也是要儲存輸出資料的地方。這些儲存貯體可能相同。您必須將下列跨來源資源分享 (CORS) 政策連接至輸入和輸出儲存貯體。如果您使用 Amazon S3 主控台，將政策新增至儲存貯體，則必須使用 JSON 格式。 **JSON** ``` [ { "AllowedHeaders": [ "*" ], "AllowedMethods": [ "GET", "HEAD", "PUT" ], "AllowedOrigins": [ "*" ], "ExposeHeaders": [ "Access-Control-Allow-Origin" ], "MaxAgeSeconds": 3000 } ] ``` **XML** ``` * GET HEAD PUT 3000 Access-Control-Allow-Origin * ``` 若要了解如何將 CORS 政策新增至 S3 儲存貯體，請參閱 Amazon Simple Storage Service 使用者指南中的[如何新增與 CORS 共用的跨網域資源？](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/add-cors-configuration.html)。