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à.
# Dati di input di fotogrammi video
Quando create un lavoro di rilevamento di oggetti con frame video o di etichettatura di oggetti, potete scegliere file video (MP4 file) o fotogrammi video per i dati di input. Tutte le attività dei worker vengono create utilizzando fotogrammi video, quindi se scegli i file video, usa lo strumento di estrazione di fotogrammi Ground Truth per estrarre i fotogrammi video (immagini) dai file video.
Per entrambe queste opzioni, puoi utilizzare l'opzione di **configurazione automatica dei dati** nella sezione Ground Truth della console Amazon SageMaker AI per configurare una connessione tra Ground Truth e i tuoi dati di input in Amazon S3 in modo che Ground Truth sappia dove cercare i dati di input durante la creazione delle attività di etichettatura. In tal modo viene creato e archiviato un file manifesto di input nella posizione del set di dati di input di Amazon S3. Per ulteriori informazioni, consulta [Configurare in modo automatico i dati di input nei frame video](sms-video-automated-data-setup.md).
In alternativa, puoi creare manualmente file di sequenza per ogni sequenza di fotogrammi video che desideri etichettare e fornire la posizione in Amazon S3 di un file manifesto di input che faccia riferimento a ciascuno di questi file di sequenze utilizzando la chiave `source-ref`. Per ulteriori informazioni, consulta [Creazione di un file manifesto di input di fotogrammi video](sms-video-manual-data-setup.md#sms-video-create-manifest).
**Topics**
+ [Scegli file video o fotogrammi video per i dati di input](sms-point-cloud-video-input-data.md)
+ [Configurazione dei dati di input](sms-video-data-setup.md)
# Scegli file video o fotogrammi video per i dati di input
Quando crei un lavoro di rilevamento di oggetti o di tracciamento di oggetti con frame video, puoi fornire una sequenza di fotogrammi video (immagini) oppure puoi utilizzare la console Amazon SageMaker AI per fare in modo che Ground Truth estragga automaticamente i fotogrammi video dai tuoi file video. Utilizza le seguenti sezioni per avere ulteriori informazioni su queste opzioni.
## Fornire fotogrammi video
I fotogrammi video sono sequenze di immagini estratte da un file video. È possibile creare un processo di etichettatura Ground Truth per consentire ai worker di etichettare più sequenze di fotogrammi video. Ogni sequenza è composta da immagini estratte da un singolo video.
Per creare un processo di etichettatura utilizzando sequenze di fotogrammi video, devi memorizzare ogni sequenza utilizzando un [prefisso di nome chiave](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#object-keys) univoco in Amazon S3. Nella console di Amazon S3, i prefissi dei nomi sono cartelle. Pertanto, nella console Amazon S3, ogni sequenza di fotogrammi video deve trovarsi nella propria cartella in Amazon S3.
Ad esempio, se disponi di due sequenze di fotogrammi video, puoi utilizzare i prefissi dei nomi chiave `sequence1/` e `sequence2/` per identificare le sequenze. In questo esempio, le sequenze possono trovarsi in `s3://amzn-s3-demo-bucket/video-frames/sequence1/` e `s3://amzn-s3-demo-bucket/video-frames/sequence2/`.
Se utilizzi la console Ground Truth per creare un file manifesto di input, tutti i prefissi dei nomi delle chiavi di sequenza devono trovarsi nella stessa posizione in Amazon S3. Ad esempio, nella console Amazon S3, ciascuna sequenza potrebbe essere in una cartella in `s3://amzn-s3-demo-bucket/video-frames/`. In questo esempio, la prima sequenza di fotogrammi video (immagini) potrebbe trovarsi in `s3://amzn-s3-demo-bucket/video-frames/sequence1/` e la seconda sequenza potrebbe trovarsi in `s3://amzn-s3-demo-bucket/video-frames/sequence2/`.
**Importante**
Anche se disponi di una sola sequenza di fotogrammi video che desideri che i worker etichettino, tale sequenza deve avere un prefisso del nome chiave in Amazon S3. Se utilizzi la console Amazon S3, significa che la sequenza si trova in una cartella. Essa non può trovarsi nella radice del bucket S3.
Quando si creano attività di worker utilizzando sequenze di fotogrammi video, Ground Truth utilizza una sequenza per attività. In ogni attività, Ground Truth ordina i fotogrammi video utilizzando l'ordine binario [UTF-8](https://en.wikipedia.org/wiki/UTF-8).
Ad esempio, i fotogrammi video potrebbero essere nell'ordine seguente in Amazon S3:
```
[0001.jpg, 0002.jpg, 0003.jpg, ..., 0011.jpg]
```
Sono disposti nello stesso ordine nell'attività del worker: `0001.jpg, 0002.jpg, 0003.jpg, ..., 0011.jpg`.
I fotogrammi possono anche essere ordinati utilizzando una convenzione di denominazione come la seguente:
```
[frame1.jpg, frame2.jpg, ..., frame11.jpg]
```
In questo caso, `frame10.jpg` e `frame11.jpg` precedono `frame2.jpg` nell’attività del worker. Il worker vede i tuoi fotogrammi video nel seguente ordine: `frame1.jpg, frame10.jpg, frame11.jpg, frame2.jpg, ..., frame9.jpg`.
## Fornire file video
È possibile utilizzare la funzione di suddivisione dei frame di Ground Truth quando si crea un nuovo lavoro di etichettatura nella console per estrarre i fotogrammi video dai file video (MP4 file). Una serie di fotogrammi video estratti da un singolo file video viene definita *sequenza di frame video*.
Puoi fare in modo che Ground Truth estragga automaticamente tutti i fotogrammi, fino a 2.000, dal video oppure puoi specificare una frequenza per l'estrazione di fotogrammi. Ad esempio, puoi fare in modo che Ground Truth estragga ogni 10o fotogramma dai tuoi video.
Puoi fornire fino a 50 video utilizzando la configurazione automatica dei dati per estrarre i fotogrammi; tuttavia, il file manifesto di input non può fare riferimento a più di 10 file di sequenza di fotogrammi video quando crei un processo di etichettatura di oggetti con fotogrammi video e di rilevamento di oggetti con fotogrammi video. Se utilizzi lo strumento console di configurazione automatica dei dati per estrarre fotogrammi video da più di 10 file video, dovrai modificare il file manifesto generato dallo strumento oppure crearne uno nuovo per includere al massimo 10 file di sequenza di fotogrammi video. Per ulteriori informazioni su queste quote, vedi [Quote del processo di etichettatura di nuvole di punti 3D e frame video](input-data-limits.md#sms-input-data-quotas-other).
Per utilizzare lo strumento di estrazione dei fotogrammi video, consulta [Configurare in modo automatico i dati di input nei frame video](sms-video-automated-data-setup.md).
Quando tutti i fotogrammi video sono stati estratti con successo dai tuoi video, nella posizione del set di dati di input S3 vedrai quanto segue:
+ Un prefisso del nome chiave (una cartella nella console Amazon S3) il cui nome viene assegnato dopo ogni video. Ciascuno di questi prefissi porta a:
+ Una sequenza di fotogrammi video estratti dal video utilizzata per denominare quel prefisso.
+ Un file di sequenza utilizzato per identificare tutte le immagini che compongono la sequenza.
+ Un file manifesto di input con estensione .manifest. Questo identifica tutti i file di sequenza che verranno utilizzati per creare il processo di etichettatura.
Tutti i fotogrammi estratti da un singolo file video vengono utilizzati per un'attività di etichettatura. Se estrai fotogrammi video da più file video, vengono create più attività per il processo di etichettatura, una per ogni sequenza di fotogrammi video.
Ground Truth archivia ogni sequenza di fotogrammi video che estrae nella posizione Amazon S3 per i set di dati di input utilizzando un [prefisso di nome chiave](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#object-keys) univoco. Nella console di Amazon S3, i prefissi dei nomi sono cartelle.
# Configurazione dei dati di input
Quando crei un processo di etichettatura di fotogrammi video, devi far sapere a Ground Truth dove cercare i dati di input. Ci sono due modi per farlo:
+ È possibile archiviare i dati di input in Amazon S3 e fare in modo che Ground Truth rilevi automaticamente il set di dati di input utilizzato per il processo di etichettatura. Per ulteriori informazioni su questa opzione, consulta [Configurare in modo automatico i dati di input nei frame video](sms-video-automated-data-setup.md).
+ È possibile creare un file manifesto di input e file di sequenza e caricarli su Amazon S3. Per ulteriori informazioni su questa opzione, consulta [Configurare in modo manuale i dati di input nei frame video](sms-video-manual-data-setup.md).
**Topics**
+ [Configurare in modo automatico i dati di input nei frame video](sms-video-automated-data-setup.md)
+ [Configurare in modo manuale i dati di input nei frame video](sms-video-manual-data-setup.md)
# Configurare in modo automatico i dati di input nei frame video
È possibile utilizzare la configurazione automatica dei dati Ground Truth per rilevare automaticamente i file video nel tuo bucket Amazon S3 ed estrarre i fotogrammi video da tali file. Per scoprire come, consulta [Fornire file video](sms-point-cloud-video-input-data.md#sms-point-cloud-video-frame-extraction).
Se disponi già di fotogrammi video in Amazon S3, puoi utilizzare la configurazione automatica dei dati per utilizzare questi fotogrammi video nel tuo processo di etichettatura. Per questa opzione, tutti i fotogrammi video di un singolo video devono essere memorizzati utilizzando un prefisso univoco. Per maggiori informazioni sui requisiti per utilizzare questa opzione, consulta [Fornire fotogrammi video](sms-point-cloud-video-input-data.md#sms-video-provide-frames).
Seleziona una delle seguenti sezioni per scoprire come configurare la connessione automatica del set di dati di input con Ground Truth.
## Fornire file video ed estrarre fotogrammi
Utilizza la seguente procedura per collegare i file video a Ground Truth ed estrai automaticamente i fotogrammi video da tali file per il rilevamento di oggetti con fotogrammi video e i processi di etichettatura di tracciamento degli oggetti.
**Nota**
Se utilizzi lo strumento console di configurazione automatica dei dati per estrarre fotogrammi video da più di 10 file video, dovrai modificare il file manifesto generato dallo strumento oppure crearne uno nuovo per includere al massimo 10 file di sequenza di fotogrammi video. Per ulteriori informazioni, consulta [Fornire file video](sms-point-cloud-video-input-data.md#sms-point-cloud-video-frame-extraction).
Assicurati che i tuoi file video siano archiviati in un bucket Amazon S3 nella stessa Regione AWS in cui esegui la configurazione automatica dei dati.
**Connetti automaticamente i tuoi file video in Amazon S3 con Ground Truth ed estrai i fotogrammi video:**
1. Vai alla pagina **Create labelling job** nella console Amazon SageMaker AI: [https://console.aws.amazon.com/sagemaker/groundtruth](https://console.aws.amazon.com//sagemaker/groundtruth).
I bucket S3 di input e output devono trovarsi nella stessa Regione AWS in cui crei il processo di etichettatura. Questo link ti porta nella regione della Virginia del Nord ( AWS us-east-1). Se i dati di input si trovano in un bucket Amazon S3 in un'altra Regione, passa a quella Regione. Per cambiare la tua AWS regione, nella [barra di navigazione](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/getting-started.html#select-region), scegli il nome della regione attualmente visualizzata.
1. Seleziona **Crea processo di etichettatura**.
1. Inserisci un **Nome processo**.
1. Nella sezione **Configurazione dei dati di input**, seleziona **Configurazione automatica dei dati**.
1. Inserisci un URI Amazon S3 per la **posizione S3 per i set di dati di input**. Un URI S3 ha il seguente aspetto: `s3://amzn-s3-demo-bucket/path-to-files/`. Questo URI deve indicare la posizione di Amazon S3 in cui sono archiviati i file video.
1. Specifica la **posizione S3 per i set di dati di output**. I dati di output vengono archiviati qui. Puoi scegliere di archiviare i dati di output nella **stessa posizione del set di dati di input** o **specificare una nuova posizione** e inserire l'URI S3 della posizione in cui desideri archiviare i dati di output.
1. Scegli **File video** per il tuo **tipo di dati** utilizzando l'elenco a discesa.
1. Scegli **Sì, estrai i fotogrammi per le attività di tracciamento e rilevamento degli oggetti**.
1. Scegli un metodo di **estrazione di fotogrammi**.
+ Quando scegli **Usa tutti i fotogrammi estratti dal video per creare un'attività di etichettatura**, Ground Truth estrae tutti i fotogrammi da ogni video nella **posizione S3 per i set di dati di input**, fino a 2.000 fotogrammi. Se un video nel set di dati di input contiene più di 2.000 fotogrammi, i primi 2.000 vengono estratti e utilizzati per l'attività di etichettatura.
+ Quando scegli **Usa ogni *x* fotogramma di un video per creare un'attività di etichettatura**, Ground Truth estrae ogni fotogramma da ogni *x* video nella tua **posizione S3 per** i set di dati di input.
Ad esempio, se il video dura 2 secondi e ha una [frequenza fotogrammi](https://en.wikipedia.org/wiki/Frame_rate) di 30 fotogrammi al secondo, il video contiene 60 fotogrammi. Se specifichi 10 qui, Ground Truth estrae ogni decimo fotogramma dal tuo video. Ciò significa che vengono estratti il 1o, 10o, 20o, 30o, 40o, 50o e 60o fotogramma.
1. Scegliere o creare un ruolo di esecuzione IAM. Assicurati che questo ruolo sia autorizzato ad accedere alle tue posizioni Amazon S3 per i dati di input e output specificati nelle fasi 5 e 6.
1. Seleziona **Configurazione dei dati completa**.
## Fornire fotogrammi video
Utilizza la seguente procedura per collegare le sequenze di fotogrammi video con Ground Truth per i processi di rilevamento degli oggetti dei fotogrammi video e di etichettatura del tracciamento degli oggetti.
Assicurati che i tuoi fotogrammi video siano archiviati in un bucket Amazon S3 nella stessa Regione AWS in cui esegui la configurazione automatica dei dati. Ogni sequenza di fotogrammi video deve avere un prefisso univoco. Ad esempio, se hai due sequenze memorizzate in `s3://amzn-s3-demo-bucket/video-frames/sequences/`, ognuna dovrebbe avere un prefisso univoco come `sequence1` e `sequence2` ed entrambe dovrebbero trovarsi direttamente sotto il prefisso `/sequences/`. Nell'esempio precedente, le posizioni di queste due sequenze sono: `s3://amzn-s3-demo-bucket/video-frames/sequences/sequence1/` e `s3://amzn-s3-demo-bucket/video-frames/sequences/sequence2/`.
**Connetti automaticamente il tuo fotogramma video in Amazon S3 con Ground Truth:**
1. Vai alla pagina **Create labelling job** nella console Amazon SageMaker AI: [https://console.aws.amazon.com/sagemaker/groundtruth](https://console.aws.amazon.com//sagemaker/groundtruth).
I bucket S3 di input e output devono trovarsi nella stessa Regione AWS in cui crei il processo di etichettatura. Questo link ti porta nella regione della Virginia del Nord ( AWS us-east-1). Se i dati di input si trovano in un bucket Amazon S3 in un'altra Regione, passa a quella Regione. Per cambiare la tua AWS regione, nella [barra di navigazione](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/getting-started.html#select-region), scegli il nome della regione attualmente visualizzata.
1. Seleziona **Crea processo di etichettatura**.
1. Inserisci un **Nome processo**.
1. Nella sezione **Configurazione dei dati di input**, seleziona **Configurazione automatica dei dati**.
1. Inserisci un URI Amazon S3 per la **posizione S3 per i set di dati di input**.
Questa deve essere la posizione Amazon S3 in cui sono archiviate le sequenze. Ad esempio, se hai due sequenze memorizzate in `s3://amzn-s3-demo-bucket/video-frames/sequences/sequence1/`, `s3://amzn-s3-demo-bucket/video-frames/sequences/sequence2/` inserisci `s3://amzn-s3-demo-bucket/video-frames/sequences/` qui.
1. Specifica la **posizione S3 per i set di dati di output**. I dati di output vengono archiviati qui. Puoi scegliere di archiviare i dati di output nella **stessa posizione del set di dati di input** o **specificare una nuova posizione** e inserire l'URI S3 della posizione in cui desideri archiviare i dati di output.
1. Scegli i **frame video** per il tuo **tipo di dati** utilizzando l'elenco a discesa.
1. Scegliere o creare un ruolo di esecuzione IAM. Assicurati che questo ruolo sia autorizzato ad accedere alle tue posizioni Amazon S3 per i dati di input e output specificati nelle fasi 5 e 6.
1. Seleziona **Configurazione dei dati completa**.
Queste procedure creeranno un manifesto di input nella posizione Amazon S3 per i set di dati di input specificati nella fase 5. Se stai creando un processo di etichettatura utilizzando l' SageMaker API o un AWS SDK AWS CLI, utilizza l'URI Amazon S3 per questo file manifest di input come input per il parametro. `ManifestS3Uri`
# Configurare in modo manuale i dati di input nei frame video
Scegli l'opzione di configurazione manuale dei dati se hai creato file di sequenza per ciascuna delle sequenze di fotogrammi video e un file manifesto che elenchi i riferimenti a tali file di sequenze.
## Creazione di un file manifesto di input di fotogrammi video
Ground Truth utilizza il file manifesto di input per identificare la posizione del set di dati di input durante la creazione di attività di etichettatura. Per i processi di rilevamento di oggetti con fotogramma video e di tracciamento degli oggetti, ogni riga del file manifesto di input identifica la posizione di un file di sequenza di fotogrammi video. Ogni file di sequenza identifica le immagini incluse in una singola sequenza di fotogrammi video.
Utilizza questa pagina per scoprire come creare un file di sequenza di fotogrammi video e un file manifesto di input per i processi di tracciamento di oggetti con fotogrammi video e di rilevamento di oggetti, di etichettatura.
Se desideri che Ground Truth generi automaticamente i file di sequenza e inserisca il file manifesto, consulta [Configurare in modo automatico i dati di input nei frame video](sms-video-automated-data-setup.md).
### Creazione di un manifesto di input di sequenza di fotogrammi video
Nel file manifesto di input della sequenza di fotogrammi video, ogni riga del manifesto è un oggetto JSON, con una chiave `"source-ref"` che fa riferimento a un file di sequenza. Ogni file di sequenza identifica la posizione di una sequenza di fotogrammi video. Questa è la formattazione del file manifesto richiesta per tutti i processi di etichettatura dei fotogrammi video.
Nell'esempio seguente viene illustrata la sintassi utilizzata per un file manifesto di input:
```
{"source-ref": "s3://amzn-s3-demo-bucket/example-folder/seq1.json"}
{"source-ref": "s3://amzn-s3-demo-bucket/example-folder/seq2.json"}
```
### Creazione di un file di sequenza di fotogrammi video
I dati per ogni sequenza di fotogrammi video devono essere memorizzati in un oggetto dati JSON. Di seguito è riportato un esempio del formato utilizzato per un file di sequenza. Le informazioni su ogni frame sono incluse come oggetto JSON e sono elencate in `frames`. Il seguente file JSON è stato ampliato per motivi di leggibilità.
```
{
"seq-no": 1,
"prefix": "s3://amzn-s3-demo-bucket/prefix/video1/",
"number-of-frames": 3,
"frames":[
{"frame-no": 1, "unix-timestamp": 1566861644, "frame": "frame0001.jpg" },
{"frame-no": 2, "unix-timestamp": 1566861644, "frame": "frame0002.jpg" },
{"frame-no": 3, "unix-timestamp": 1566861644, "frame": "frame0003.jpg" }
]
}
```
Nella tabella seguente vengono forniti dettagli sui parametri mostrati in questo esempio di codice.
****
| Parametro | Obbligatorio | Valori accettati | Description |
| --- | --- | --- | --- |
| `seq-no` | Sì | Numero intero | Il numero ordinato della sequenza. |
| `prefix` | Sì | Stringa **Valori accettati**: `s3:////` | Posizione Amazon S3 in cui si trovano i file di sequenza. Il prefisso deve terminare con una barra: `/`. |
| `number-of-frames` | Sì | Numero intero | Numero totale di frame inclusi nel file di sequenza. Questo numero deve corrispondere al numero totale di frame elencati nel parametro `frames` nella riga successiva. |
| `frames` | Sì | Elenco degli oggetti JSON **Campo obbligatorio**: `frame-no`, `frame` **Facoltativo**: `unix-timestamp` | Un elenco di dati frame. La lunghezza dell'elenco deve essere uguale `number-of-frames`. Nell'interfaccia utente del worker, i fotogrammi in una sequenza sono ordinati in ordine binario [UTF-8](https://en.wikipedia.org/wiki/UTF-8). Per ulteriori informazioni su questo ordine, consulta [Fornire fotogrammi video](sms-point-cloud-video-input-data.md#sms-video-provide-frames). |
| frame-no | Sì | Numero intero | Il numero dell'ordine del fotogramma. Questo determinerà l'ordine di un fotogramma nella sequenza. |
| `unix-timestamp` | No | Numero intero | Il timestamp unix di un fotogramma. Il numero di secondi trascorsi dal 1° gennaio 1970 all'ora UTC in cui il fotogramma è stato acquisito. |
| frame | Sì | Stringa | Il nome di un file di immagine con fotogramma video. |