

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Informazioni sul tipo di attività di monitoraggio di oggetti in una nuvola di punti 3D-2D
<a name="sms-point-cloud-3d-2d-object-tracking"></a>

Utilizza questo tipo di attività quando desideri che i worker colleghino le annotazioni di nuvole di punti 3D alle annotazioni di immagini 2D e colleghino anche le annotazioni di immagini 2D tra varie videocamere. Attualmente, Ground Truth supporta i cuboidi per l'annotazione in una nuvola di punti 3D e i riquadri di delimitazione per l'annotazione nei video 2D. Ad esempio, puoi utilizzare questo tipo di attività per chiedere ai worker di collegare il movimento di un veicolo in una nuvola di punti 3D con il relativo video 2D. Utilizzando il collegamento 3D-2D, è possibile correlare facilmente i dati della nuvola di punti (come la distanza di un parallelepipedo) ai dati video (riquadro di delimitazione) per un massimo di 8 videocamere.

 Ground Truth fornisce ai worker gli strumenti per annotare i cuboidi in una nuvola di punti 3D e i riquadri di delimitazione in un massimo di 8 videocamere utilizzando la stessa interfaccia utente di annotazione. I worker possono anche collegare diversi riquadri di delimitazione per lo stesso oggetto su diverse videocamere. Ad esempio, un riquadro di delimitazione in videocamera1 può essere collegato a un riquadro di delimitazione in videocamera2. Ciò consente di correlare un oggetto su più videocamere mediante un ID univoco. 

**Nota**  
Attualmente, l' SageMaker intelligenza artificiale non supporta la creazione di un processo di collegamento 3D-2D utilizzando la console. Per creare un lavoro di collegamento 3D-2D utilizzando l'API, consulta. SageMaker [Creare un processo di etichettatura (API)](sms-3d-2d-point-cloud-object-tracking-create-labeling-job.md#sms-point-cloud-3d-2d-object-tracking-create-labeling-job-api) 

I seguenti argomenti spiegano come creare un processo di etichettatura per il tracciamento di oggetti in una nuvola di punti 3D-2D, mostrano l’aspetto dell’interfaccia dell’attività dei worker (ciò che visualizzano quando lavorano a questa attività) e forniscono una panoramica dei dati di output che si ottengono quando i worker completano le loro attività.

**Topics**
+ [Creare un processo di etichettatura per il tracciamento di oggetti in una nuvola di punti 3D-2D](sms-3d-2d-point-cloud-object-tracking-create-labeling-job.md)
+ [Visualizzare l’interfaccia dell’attività dei worker per un processo di etichettatura per il tracciamento di oggetti in una nuvola di punti 3D-2D](sms-point-cloud-3d-2d-object-tracking-worker-ui.md)
+ [Dati di output per un processo di etichettatura per il tracciamento di oggetti 3D-2D](sms-point-cloud-3d-2d-object-tracking-output-data.md)

# Creare un processo di etichettatura per il tracciamento di oggetti in una nuvola di punti 3D-2D
<a name="sms-3d-2d-point-cloud-object-tracking-create-labeling-job"></a>

È possibile creare un lavoro di etichettatura di nuvole di punti 3D-2D utilizzando l'operazione API,. SageMaker [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html) Per creare un processo di etichettatura per questo tipo di attività è necessario quanto segue: 
+ Un team di lavoro di una forza lavoro privata o di fornitore. Non è possibile utilizzare Pubblica per i processi di etichettatura della nuvola di punti 3D. Per informazioni su come creare forza lavoro e team di lavoro, consulta [Forza lavoro](sms-workforce-management.md).
+ Aggiungi una policy CORS a un bucket S3 che contiene dati di input nella console Amazon S3. Per impostare le intestazioni CORS richieste sul bucket S3 che contiene le immagini di input nella console S3, segui le istruzioni dettagliate in [Requisiti per l’autorizzazione CORS.](https://docs.aws.amazon.com/sagemaker/latest/dg/sms-cors-update.html)
+ Inoltre, assicurati di aver esaminato e applicato quanto descritto in [Assegnare le autorizzazioni IAM per utilizzare Ground Truth](sms-security-permission.md). 

Per informazioni su come creare un processo di etichettatura utilizzando l’API, consulta le sezioni seguenti. 

## Creare un processo di etichettatura (API)
<a name="sms-point-cloud-3d-2d-object-tracking-create-labeling-job-api"></a>

Questa sezione descrive i dettagli che è necessario conoscere quando si crea un processo di etichettatura di oggetti 3D-2D utilizzando l'operazione API. SageMaker `CreateLabelingJob` Questa API definisce questa operazione per tutti. AWS SDKs Per visualizzare un elenco delle lingue specifiche SDKs supportate per questa operazione, **consulta la sezione Vedere anche** di. [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html) 

[Creare un processo di etichettatura (API)](sms-create-labeling-job-api.md) fornisce una panoramica dell'operazione `CreateLabelingJob`. Segui queste istruzioni ed effettua le seguenti operazioni durante la configurazione della richiesta: 
+ Immetti un ARN per `HumanTaskUiArn`. Utilizza `arn:aws:sagemaker:<region>:394669845002:human-task-ui/PointCloudObjectTracking`. Sostituisci `<region>` con la Regione AWS in cui stai creando il processo di etichettatura. 

  Non inserire una voce per il parametro `UiTemplateS3Uri`. 
+ Il tuo [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) deve finire con `-ref`. Ad esempio, `ot-labels-ref`. 
+ Il file manifest di input deve essere un file manifest della sequenza di frame della nuvola di punti. Per ulteriori informazioni, consulta [Creazione di un file manifest di input della sequenza di nuvole di punti](sms-point-cloud-multi-frame-input-data.md). Devi inoltre fornire un file di configurazione della categoria di etichette, come indicato sopra.
+ È necessario fornire funzioni Lambda predefinite ARNs per le funzioni Lambda di pre-annotazione e post-annotazione (ACS). Queste ARNs sono specifiche della AWS regione che utilizzi per creare il tuo lavoro di etichettatura. 
  + Per trovare l'ARN Lambda di pre-annotazione, fai riferimento a [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). Utilizza la Regione in cui stai creando il processo di etichettatura per trovare l'ARN corretto che termina con `PRE-3DPointCloudObjectTracking`. 
  + Per trovare l'ARN Lambda di postannotazione, fai riferimento a [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). Utilizza la Regione in cui stai creando il processo di etichettatura per trovare l'ARN corretto che termina con `ACS-3DPointCloudObjectTracking`. 
+ Il numero di worker specificato in `NumberOfHumanWorkersPerDataObject` deve essere `1`. 
+ L'etichettatura automatizzata dei dati non è supportata per i processi di etichettatura della nuvola di punti 3D. Non è necessario specificare i valori per i parametri in `[LabelingJobAlgorithmsConfig](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html#sagemaker-CreateLabelingJob-request-LabelingJobAlgorithmsConfig)`. 
+ I processi di etichettatura per il monitoraggio di oggetti i3D-2D possono richiedere più ore per il completamento. Puoi specificare un limite di tempo più lungo per questi processi di etichettatura in `TaskTimeLimitInSeconds` (fino a 7 giorni o 604.800 secondi). 

**Nota**  
Dopo aver creato con successo un processo di monitoraggio di oggetti 3D-2D, esso viene visualizzato sulla console insieme ai processi di etichettatura. Il tipo di attività per il processo viene visualizzato come **Monitoraggio di oggetti nuvola di punti**.

## Formato dei dati di input
<a name="sms-point-cloud-3d-2d-object-tracking-input-data"></a>

È possibile creare un processo di tracciamento di oggetti 3D-2D utilizzando l'operazione API, SageMaker . [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateLabelingJob.html) Per creare un processo di etichettatura per questo tipo di attività è necessario quanto segue:
+ Un file manifest di input di sequenza. Per informazioni su come creare questo tipo di file manifest, consulta [Creazione di un file manifest di input della sequenza di nuvole di punti](sms-point-cloud-multi-frame-input-data.md). Se non hai familiarità con la modalità di etichettatura della nuvola di punti Ground Truth 3D, ti consigliamo di leggere [Formati dati 3D non elaborati accettati](sms-point-cloud-raw-data-types.md). 
+ Specifica le etichette, la categoria di etichette e gli attributi dei fotogrammi, e le istruzioni per il worker in un file di configurazione della categoria di etichetta. Per ulteriori informazioni, consulta [Creazione di un file di configurazione della categoria di etichettatura con gli attributi Categoria di etichette e Attributi frame](https://docs.aws.amazon.com/sagemaker/latest/dg/sms-label-cat-config-attributes.html) per scoprire come creare questo file. Di seguito è riportato un esempio che mostra un file di configurazione della categoria di etichette per la creazione di un processo di monitoraggio di oggetti 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"
          }
      ]
  }
  ```
**Nota**  
È necessario fornire `BoundingBox` e `Cuboid` come AnnotationType nel file di configurazione della categoria di etichette per creare un processo di monitoraggio di oggetti 3D-2D. 

# Visualizzare l’interfaccia dell’attività dei worker per un processo di etichettatura per il tracciamento di oggetti in una nuvola di punti 3D-2D
<a name="sms-point-cloud-3d-2d-object-tracking-worker-ui"></a>

Ground Truth fornisce ai worker un portale Web e gli strumenti per completare le attività di annotazione del monitoraggio di oggetti della nuvola di punti 3D-2D. Quando crei il processo di etichettatura, fornisci il nome della risorsa Amazon (ARN) per un'interfaccia utente Ground Truth predefinita nel parametro `HumanTaskUiArn`. Per utilizzare l'interfaccia utente quando crei un processo di etichettatura per questo tipo di attività utilizzando l'API, devi fornire il `HumanTaskUiArn`. Puoi visualizzare in anteprima e interagire con l'interfaccia utente di lavoro quando crei un processo di etichettatura tramite l’API. Gli strumenti di annotazione fanno parte dell'interfaccia dell’attività del worker. Non sono disponibili per l'interfaccia in anteprima. L'immagine seguente mostra l'interfaccia dell’attività del worker utilizzata per l'attività di annotazione di monitoraggio di oggetti con nuvole di punti 3D-2D.

![\[L'interfaccia dell’attività del worker utilizzata per l'attività di annotazione di monitoraggio di oggetti con nuvole di punti 3D-2D.\]](http://docs.aws.amazon.com/it_it/sagemaker/latest/dg/images/sms-sensor-fusion.png)


Quando l'interpolazione è abilitata per impostazione predefinita. Dopo che un worker ha aggiunto un singolo cuboide, tale cuboide viene replicato in tutti i fotogrammi della sequenza con lo stesso ID. Se il worker regola il cuboide in un altro fotogramma, Ground Truth interpola il movimento di quell'oggetto e regola tutti i cuboidi tra i fotogrammi regolati manualmente. Inoltre, utilizzando la sezione di visualizzazione della videocamera, è possibile mostrare un cuboide con una proiezione (utilizzando il pulsante B per “alternare le etichette” nella visualizzazione della videocamera) che fornisce al worker un riferimento dalle immagini della videocamera. La precisione del cuboide rispetto alla proiezione dell'immagine si basa sulla precisione delle calibrazioni acquisite nei dati estrinseci e intrinseci.

Se specifichi i dati della telecamera per la fusione dei sensori, le immagini vengono abbinate a scene nel frame della nuvola di punti. Nota che i dati della videocamera devono essere sincronizzati in base all'ora con i dati della nuvola di punti per garantire una rappresentazione accurata della nuvola di punti rispetto alle immagini su ogni fotogramma della sequenza, come mostrato nell'immagine seguente.

![\[Il file manifesto, il portale del worker con i dati della nuvola di punti e i dati della videocamera.\]](http://docs.aws.amazon.com/it_it/sagemaker/latest/dg/images/3d_2d_link_ss.png)


**Il file manifesto contiene i dati estrinseci e intrinseci e la posa per consentire la visualizzazione della proiezione del cuboide sull'immagine della videocamera utilizzando il pulsante P**.

Il worker può navigare nella scena 3D utilizzando la tastiera e il mouse. In particolare, può:
+ Fare doppio clic su oggetti specifici nella nuvola di punti per ingrandirli.
+ Usare la rotella del mouse o un trackpad per ingrandire e ridurre la nuvola di punti.
+ Usa entrambi i tasti freccia della tastiera e i tasti Q, E, A e D per spostarsi Su, Giù, Sinistra, Destra. Usa i tasti della tastiera W e S per ingrandire e ridurre. 

Una volta che un worker posiziona un cuboide nella scena 3D, viene mostrata una visualizzazione laterale con le tre visualizzazioni laterali proiettate: superiore, laterale e posteriore. Queste visualizzazioni laterali mostrano i punti all'interno e attorno al cuboide posizionato e consentono ai worker di perfezionare i limiti del cuboide in quell'area. I worker possono ingrandire e ridurre ciascuna di queste visualizzazioni laterali utilizzando il mouse.

Il worker deve prima selezionare il cuboide per disegnare un riquadro di delimitazione corrispondente su una qualsiasi delle visualizzazioni della videocamera. Questo collega il cuboide e il riquadro di delimitazione con un nome comune e un ID univoco.

Il worker può anche disegnare prima un riquadro di delimitazione, selezionarlo e disegnare il cuboide corrispondente per collegarli.

Sono disponibili ulteriori opzioni di visualizzazione e caratteristiche. Consulta la [pagina delle istruzioni per il worker](https://docs.aws.amazon.com/sagemaker/latest/dg/sms-point-cloud-worker-instructions-object-tracking.html) per una panoramica completa dell'interfaccia utente di lavoro. 

## Strumenti per i worker
<a name="sms-point-cloud-object-tracking-worker-tools"></a>

I worker possono navigare nella nuvola di punti 3D eseguendo lo zoom avanti e indietro e spostandosi in tutte le direzioni intorno alla nuvola utilizzando le scelte rapide del mouse e della tastiera. Se i worker fanno clic su un punto nella nuvola di punti, l'interfaccia utente esegue lo zoom automatico in quell'area. I worker possono utilizzare vari strumenti per disegnare un cuboide 3D attorno agli oggetti. Per ulteriori informazioni, consulta **Strumenti di etichettatura assistita** nella discussione seguente. 

Dopo che i worker hanno inserito un cuboide 3D nella nuvola di punti, possono regolare questi cuboidi per adattarsi perfettamente alle auto utilizzando una varietà di viste: direttamente nella nuvola di punti 3D, in una vista laterale con tre prospettive ingrandite della nuvola di punti attorno alla casella e, se si includono immagini per la fusione dei sensori, direttamente nell'immagine 2D. 

Opzioni di visualizzazione aggiuntive consentono ai worker di nascondere o visualizzare facilmente il testo dell'etichetta, una maglia a terra e altri attributi di punto. I worker possono anche scegliere tra proiezioni prospettiche e ortogonali. 

**Strumenti di etichettatura assistita**  
Ground Truth consente ai worker di annotare le nuvole di punti 3D in modo più rapido e accurato utilizzando UX, gli strumenti di etichettatura assistita basati sul Machine Learning e gli strumenti di etichettatura assistita basati sulla visione artificiale per le attività di tracciamento di oggetti della nuvola di punti 3D. Per questo tipo di attività sono disponibili i seguenti strumenti di etichettatura assistita:
+ **Compilazione automatica delle etichette**: quando un worker aggiunge un cuboide a un fotogramma con le stesse dimensioni, orientamento e posizione xyz, viene aggiunto automaticamente a tutti i fotogrammi della sequenza. 
+ **Interpolazione etichette**: dopo che un worker ha etichettato un singolo oggetto in due fotogrammi, Ground Truth utilizza tali annotazioni per interpolare il movimento dell'oggetto tra tutti i fotogrammi. L'interpolazione delle etichette può essere attivata e disattivata. È attivata per impostazione predefinita. Ad esempio, se un worker che lavora con 5 fotogrammi aggiunge un cuboide nel fotogramma 2, esso viene copiato in tutti i 5 fotogrammi. Se poi il worker effettua delle regolazioni nel fotogramma 4, i fotogrammi 2 e 4 a quel punto agiscono come due punti attraverso i quali viene inserita una linea. Il cuboide viene quindi interpolato nei fotogrammi 1, 3 e 5.
+ **Gestione in blocco di etichette e attributi**: i worker possono aggiungere, eliminare e rinominare annotazioni, attributi delle categorie di etichette e attributi dei fotogrammi in blocco.
  + I worker possono eliminare manualmente le annotazioni per un determinato oggetto prima o dopo un fotogramma o in tutti i fotogrammi. Ad esempio, un worker può eliminare tutte le etichette per un oggetto dopo il frame 10 se tale oggetto non si trova più nella scena successiva al frame. 
  + Se un worker elimina accidentalmente tutte le annotazioni relative a un oggetto, può aggiungerle nuovamente. Ad esempio, se un worker elimina tutte le annotazioni per un oggetto prima del frame 100, può aggiungerle in blocco a tali frame. 
  + I worker possono rinominare un'etichetta in un frame e tutti i cuboidi 3D assegnati a tale etichetta vengono aggiornati con il nuovo nome in tutti i frame. 
  + I worker possono utilizzare la modifica in blocco per aggiungere o modificare gli attributi delle categorie di etichette e gli attributi dei frame in più frame.
+ **Aggancio**: i worker possono aggiungere un cuboide attorno a un oggetto e utilizzare un tasto di scelta rapida o un'opzione di menu per fare in modo che lo strumento di autofit di Ground Truth agganci saldamente il cuboide attorno ai bordi dell'oggetto. 
+ **Adatta a terra**: dopo che un worker aggiunge un cuboide alla scena 3D, il worker può automaticamente agganciare il cuboide al terreno. Ad esempio, il worker può utilizzare questa caratteristica per agganciare un cuboide sulla strada o sul marciapiede nella scena. 
+ **Etichettatura di più visualizzazioni**: dopo che un worker aggiunge un cuboide 3D alla scena 3D, un pannello laterale visualizza le prospettive frontali e a due vie per aiutare il worker ad adattare il cuboide attorno all'oggetto. I worker possono annotare il cloud di punti 3D, il pannello laterale e le regolazioni appaiono nelle altre viste in tempo reale. 
+ **Fusione dei sensori**: se fornisci i dati per la fusione dei sensori, i worker possono adattare nelle scene 3D e nelle immagini 2D le annotazioni che quindi sono proiettate nell'altra visualizzazione in tempo reale. Per ulteriori informazioni sui dati relativi alla fusione dei sensori, consulta [Comprendere i sistemi di coordinate e la fusione dei sensori](https://docs.aws.amazon.com/sagemaker/latest/dg/sms-point-cloud-sensor-fusion-details.html#sms-point-cloud-sensor-fusion).
+ **Unisci automaticamente cuboidi**: i worker possono unire automaticamente due cuboidi in tutti i fotogrammi se determinano che i cuboidi con etichette diverse rappresentano effettivamente un singolo oggetto. 
+ **Opzioni di visualizzazione**: consente ai worker di nascondere o visualizzare facilmente il testo dell'etichetta, una mesh di terra e altri attributi puntuali come il colore o l'intensità. I worker possono anche scegliere tra proiezioni prospettiche e ortogonali. 

# Dati di output per un processo di etichettatura per il tracciamento di oggetti 3D-2D
<a name="sms-point-cloud-3d-2d-object-tracking-output-data"></a>

Quando crei un processo di etichettatura di monitoraggio di oggetti 3D-2D, le attività vengono inviate ai worker. Quando questi worker completano le attività, le relative annotazioni vengono scritte nel bucket Amazon S3 specificato al momento della creazione del processo di etichettatura. Il formato dei dati di output determina ciò che vedi nel tuo bucket Amazon S3 quando lo stato del processo di etichettatura () è. [LabelingJobStatus](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeLabelingJob.html#API_DescribeLabelingJob_ResponseSyntax)`Completed` 

Se non hai familiarità con Ground Truth, consulta [Etichettatura dei dati di output di un processo](sms-data-output.md) per ulteriori informazioni sul formato dei dati di output in Ground Truth. Per informazioni sul formato dei dati di output del tracciamento di oggetti della nuvola di punti 3D-2D, consulta [Output del monitoraggio di oggetti in una nuvola di punti 3D-2D](sms-data-output.md#sms-output-3d-2d-point-cloud-object-tracking). 