File di configurazione della categoria di etichettatura con riferimento alla categoria dell'etichetta e agli attributi del frame - Amazon SageMaker AI

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à.

File di configurazione della categoria di etichettatura con riferimento alla categoria dell'etichetta e agli attributi del frame

Quando crei un lavoro di etichettatura con nuvole di punti o fotogrammi video 3D utilizzando l' SageMaker APIoperazione AmazonCreateLabelingJob, utilizzi un file di configurazione della categoria di etichette per specificare le etichette e le istruzioni per l'operatore. Facoltativamente, puoi anche fornire quanto segue nel tuo file di attributi di categoria dell’etichetta:

  • Puoi fornire gli attributi di categoria dell’etichetta per il fotogramma video e il monitoraggio di oggetti della nuvola di punti 3D e i tipi di attività di monitoraggio di oggetti. I worker possono usare uno o più attributi per fornire ulteriori informazioni su un oggetto. Ad esempio, potresti utilizzare l'attributo occluded per consentire ai worker di individuare quando un oggetto è parzialmente ostruito. Puoi specificare un attributo di categoria dell’etichetta per una singola etichetta utilizzando il parametro categoryAttributes o per tutte le etichette utilizzando il parametro categoryGlobalAttributes.

  • Puoi fornire attributi del fotogramma per i tipi di attività di tracciamento e rilevamento di oggetti con nuvole di punti 3D e fotogrammi video utilizzando frameAttributes. Quando crei un attributo del fotogramma, questo viene visualizzato su ogni fotogramma o nuvola di punti dell'attività del worker. Nei processi di etichettatura di fotogrammi video, si tratta di attributi che i worker assegnano a un intero fotogramma video. Per i processi di etichettatura con nuvole di punti 3D, questi attributi vengono applicati a una singola nuvola di punti. Utilizza gli attributi dei fotogrammi per consentire ai worker di fornire maggiori informazioni sulla scena in un fotogramma o in una nuvola di punti specifici.

  • Per i processi di etichettatura di fotogrammi video, utilizza il file di configurazione della categoria dell’etichetta per specificare il tipo di attività (riquadro di delimitazione, polilinea, poligono o keypoint) da inviare ai worker.

Per i worker, specificare i valori per gli attributi della categoria dell’etichetta e gli attributi dei fotogrammi sarà facoltativo.

Importante

Devi specificare un nome per l’attributo dell’etichetta in auditLabelAttributeName solo se esegui un processo di audit per verificare o regolare le etichette. Usa questo parametro per inserire quello LabelAttributeNameutilizzato nel processo di etichettatura che ha generato le annotazioni che desideri che il lavoratore modifichi. Quando crei un lavoro di etichettatura nella console, se non hai specificato il nome di un attributo di etichetta, il nome del tuo lavoro viene utilizzato come. LabelAttributeName

I seguenti argomenti mostrano esempi di un file di configurazione delle categorie di etichette per diversi tipi di lavori di etichettatura. Spiegano inoltre lo schema e le quote di un file di configurazione delle categorie.

Esempi: file di configurazione delle categorie di etichette per lavori di etichettatura con nuvole di punti 3D

I seguenti argomenti mostrano esempi di file di configurazione delle categorie di etichette con nuvole di punti 3D per lavori di rilevamento, tracciamento degli oggetti, segmentazione semantica, regolazione ed etichettatura di verifica.

Esempio: tracciamento e rilevamento di oggetti con nuvole di punti 3D

Di seguito è riportato un esempio di file di configurazione della categoria dell’etichetta che include gli attributi della categoria dell’etichetta per un processo di etichettatura di oggetti con nuvole di punti 3D di rilevamento o monitoraggio di oggetti. Questo esempio include due attributi di fotogramma, che verranno aggiunti a tutte le nuvole di punti inviate al processo di etichettatura. L'etichetta Car includerà quattro attributi di categoria dell'etichetta: X, Y, Z e l'attributo globale, 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":"<html markup>"} }

Esempio: segmentazione semantica di nuvole di punti 3D

Di seguito è riportato un esempio di file di configurazione della categoria dell’etichetta per un processo di etichettatura della segmentazione semantica con nuvole di punti 3D.

Gli attributi di categoria dell’etichetta non sono supportati per i tipi di attività di segmentazione semantica con nuvole di punti 3D. Gli attributi dei fotogrammi sono supportati. Gli attributi di categoria dell’etichetta per un processo di etichettatura di segmentazione semantica eventualmente forniti verranno ignorati.

{ "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":"<html markup>"} }

Esempio: regolazione 3D della nuvola di punti

Di seguito è riportato un esempio di file di configurazione della categoria dell’etichetta per un processo di etichettatura per il rilevamento di oggetti con nuvole di punti 3D o per la regolazione del monitoraggio di oggetti. Per i processi di etichettatura di regolazione con segmentazione semantica con nuvole di punti 3D, categoryGlobalAttributes e categoryAttributes non sono supportati.

È necessario includere auditLabelAttributeName per specificare il nome dell'attributo dell'etichetta del precedente processo di etichettatura utilizzato per creare il processo di etichettatura di regolazione. Facoltativamente, è possibile utilizzare il parametro editsAllowed per specificare se un attributo di etichetta o fotogramma può essere modificato.

{ "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":"<html markup>"}, // include auditLabelAttributeName for label adjustment jobs "auditLabelAttributeName": "myPrevJobLabelAttributeName" }

Esempio: verifica 3D della nuvola di punti

Di seguito è riportato un esempio di file di configurazione della categoria dell’etichetta utilizzabile per un processo di etichettatura per il rilevamento di oggetti con nuvole di punti 3D o per la verifica del monitoraggio di oggetti. Per un processo di etichettatura di verifica con segmentazione semantica con nuvole di punti 3D, categoryGlobalAttributes e categoryAttributes non sono supportati.

È necessario includere auditLabelAttributeName per specificare il nome dell'attributo dell'etichetta del precedente processo di etichettatura utilizzato per creare il processo di etichettatura di verifica. Inoltre, è necessario utilizzare il parametro editsAllowed per specificare che non è possibile modificare alcuna etichetta.

{ "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":"<html markup>"}, // include auditLabelAttributeName for label verification jobs "auditLabelAttributeName": "myPrevJobLabelAttributeName" }

Esempi: file di configurazione delle categorie di etichette per lavori di etichettatura di fotogrammi video

Gli strumenti di annotazione disponibili per il worker e il tipo di attività utilizzati dipendono dal valore specificato per annotationType. Ad esempio, se desideri che i worker utilizzino i punti chiave per monitorare le modifiche nella posa di oggetti specifici su più fotogrammi, devi specificare Keypoint per annotationType. Se non specifichi un tipo di annotazione, per impostazione predefinita verrà utilizzato BoundingBox.

I seguenti argomenti mostrano esempi di file di configurazione delle categorie di fotogrammi video.

Esempio: keypoint del frame video

Di seguito è riportato un esempio di file di configurazione della categoria dell’etichetta dei punti chiave dei fotogrammi video con gli attributi della categoria dell’etichetta. Questo esempio include due attributi di fotogrammi, che verranno aggiunti a tutti i fotogrammi inviati al processo di etichettatura. L'etichetta Car includerà quattro attributi di categoria dell'etichetta: X, Y, Z e l'attributo globale, 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":"<html markup>"} }

Esempio: regolazione del fotogramma video

Di seguito è riportato un esempio di file di configurazione della categoria dell’etichetta che è possibile utilizzare per un processo di etichettatura di regolazione dei fotogrammi video.

È necessario includere auditLabelAttributeName per specificare il nome dell'attributo dell'etichetta del precedente processo di etichettatura utilizzato per creare il processo di etichettatura di verifica. Facoltativamente, è possibile utilizzare il parametro editsAllowed per specificare se le etichette, gli attributi delle categorie dell’etichetta o gli attributi dei fotogrammi possono essere modificati o meno.

{ "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":"<html markup>"}, // include auditLabelAttributeName for label adjustment jobs "auditLabelAttributeName": "myPrevJobLabelAttributeName" }

Esempio: verifica dei fotogrammi video

Di seguito è riportato un esempio di file di configurazione della categoria dell’etichetta per un processo di etichettatura di fotogrammi video.

È necessario includere auditLabelAttributeName per specificare il nome dell'attributo dell'etichetta del precedente processo di etichettatura utilizzato per creare il processo di etichettatura di verifica. Inoltre, è necessario utilizzare il parametro editsAllowed per specificare che non è possibile modificare alcuna etichetta.

{ "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":"<html markup>"}, // include auditLabelAttributeName for label adjustment jobs "auditLabelAttributeName": "myPrevJobLabelAttributeName" }

Schema del file di configurazione delle categorie di etichette

Nella tabella seguente sono elencati gli elementi che è possibile e necessario includere nel file di configurazione della categoria dell’etichetta.

Nota

Il parametro annotationType è supportato solo per i processi di etichettatura dei fotogrammi video.

Parametro

Obbligatorio

Valori accettati

Descrizione

frameAttributes

No

Elenco di oggetti JSON.

Parametri richiesti in ogni JSON oggetto:

name, type, description

minimum e maximum sono obbligatori se type è "number"

Parametri opzionali in ogni JSON oggetto:

enum, editsAllowed, isRequired

Utilizza questo parametro per creare un attributo del fotogramma da applicare a tutti i fotogrammi oppure le nuvole di punti 3D nel tuo processo di etichettatura.

Per ulteriori informazioni, consulta la terza tabella in questa sezione.
categoryGlobalAttributes

No

Elenco di oggetti JSON.

Parametri richiesti in ogni JSON oggetto:

name, type

minimum e maximum sono obbligatori se type è "number"

Parametri opzionali in ogni JSON oggetto:

description, enum, editsAllowed, isRequired

Utilizza questo parametro per creare attributi della categoria dell’etichetta da applicare a tutte le etichette specificate in labels.

Per ulteriori informazioni, consulta la terza tabella in questa sezione.
labels

Un elenco di un massimo di 30 JSON oggetti

Parametri obbligatori in ogni JSON oggetto:

label

Parametri opzionali in ogni JSON oggetto:

categoryAttributes, editsAllowed

Utilizza questo parametro per specificare le etichette o le classi. Aggiungi un elemento label per ogni classe.

Per aggiungere un attributo della categoria dell’etichetta a un'etichetta, aggiungi categoryAttributes all'etichetta.

Utilizza editsAllowed per specificare se un'etichetta può essere modificata o meno in un processo di etichettatura di regolazione. Imposta editsAllowed su "none" per i processi di etichettatura di verifica.

Per ulteriori informazioni, consulta la tabella seguente.

annotationType (supportato solo per i processi di etichettatura di fotogrammi video)

No

Stringa

Parametri accettati:

BoundingBox, Polyline, Polygon, Keypoint

Default:

BoundingBox

Consente di specificare il tipo di attività per i tuoi processi di etichettatura dei fotogrammi video. Ad esempio, per un'attività di rilevamento di oggetti con fotogrammi video poligonali, scegli Polygon.

Se non specifichi un annotationType quando crei un processo di etichettatura dei fotogrammi video, Ground Truth utilizzerà un BoundingBox per impostazione predefinita.

instructions

No

Un JSON oggetto

Parametri richiesti in ogni JSON oggetto:

"shortInstruction", "fullInstruction"

Utilizza questo parametro per aggiungere le istruzioni per aiutare i worker a completare le attività. Per ulteriori informazioni sulle istruzioni per i worker, consulta Istruzioni per il lavoratore.

Le istruzioni brevi devono contenere meno di 255 caratteri e le istruzioni lunghe devono contenere meno di 2.048 caratteri.

Per ulteriori informazioni, consulta Creare pagine di istruzioni.

auditLabelAttributeName

Obbligatorio per i tipi di attività di regolazione e verifica

Stringa

Inserisci quello LabelAttributeNameutilizzato nel lavoro di etichettatura di cui desideri modificare le annotazioni.

Utilizza questo parametro solo se crei un processo di regolazione per il fotogramma video e nuvole di punti 3D per il rilevamento di oggetti, il tracciamento di oggetti o la segmentazione semantica della nuvola di punti 3D.

Schema degli oggetti delle etichette

La tabella seguente descrive i parametri che puoi e devi usare per creare un elenco di Labels. Ogni parametro deve essere incluso in un JSON oggetto.

Parametro Obbligatorio Valori accettati Descrizione
label

Stringa

Il nome della categoria di etichette che viene visualizzato dai worker. Il nome di ciascuna categoria di etichette deve essere univoco.

categoryAttributes

No

Elenco di oggetti JSON.

Parametri richiesti in ogni JSON oggetto:

name, type

minimum e maximum obbligatori se type è "number"

Parametri opzionali in ogni JSON oggetto:

description, enum, editsAllowed, isRequired

Utilizza questo parametro per aggiungere gli attributi di categoria dell’etichetta a determinate etichette specificate in labels.

Per aggiungere uno o più attributi di categoria di etichette a un'etichetta, includi l'labelsJSONoggetto nello stesso oggettolabel. categoryAttributes JSON

Per ulteriori informazioni, consulta la tabella seguente.
editsAllowed

No

Stringa

Valori supportati:

"none": non è consentita nessuna modifica.

oppure

"any" (Impostazione predefinita): tutte le modifiche sono consentite.

Specifica se un'etichetta può essere modificata o meno dai worker.

Per i lavori di etichettatura di fotogrammi video o nuvole di punti 3D, aggiungete questo parametro a uno o più JSON oggetti nell'labelselenco per specificare se un lavoratore può modificare o meno un'etichetta.

Per i lavori di etichettatura con nuvole di punti 3D e verifica di fotogrammi video, aggiungete questo parametro con il valore "none" a ciascun JSON oggetto nell'labelselenco. Ciò renderà tutte le etichette non modificabili.

frameAttributes e schema categoryGlobalAttributes

La tabella seguente descrive i parametri che puoi e devi utilizzare per creare un attributo del fotogramma utilizzando frameAttributes e l’attributo di categoria dell’etichetta usando i parametri categoryGlobalAttributes e categoryAttributes.

Parametro

Obbligatorio

Valori accettati

Descrizione

name

Stringa

Utilizza questo parametro per assegnare un nome all'attributo di categoria o fotogramma dell’etichetta. Questo è il nome dell’attributo visualizzato dai worker.

Il nome di ogni attributo di categoria dell’etichetta nel file di configurazione della categoria dell’etichetta deve essere univoco. Gli attributi globali della categoria dell’etichetta e gli attributi della categoria dell’etichetta specifici dell'etichetta non possono avere lo stesso nome.

type

Stringa

Valori obbligatori:

"string" o "number"

Utilizza questo parametro per definire il tipo di attributo della categoria di etichetta o fotogramma.

Se specifichi "string" per type e fornisci un valore enum per questo attributo, i worker potranno scegliere tra una delle scelte fornite.

Se specifichi "string" per type e non fornisci un valore enum, i worker possono inserire testo in forma libera.

Se specifichi number per type, il worker può inserire un numero compreso tra i numeri minimum emaximum specificati.

enum

No

Elenco di stringhe

Utilizza questo parametro per definire le opzioni tra cui i worker possono scegliere per questo attributo di categoria di etichetta o fotogramma. I worker possono scegliere un valore specificato in enum. Ad esempio, se specifichi ["foo", "buzz", "bar"] per enum, i worker possono scegliere tra foo, buzz o bar.

Devi specificare "string" per type per utilizzare un elenco enum.

description

frameAttributes: Sì

categoryAttributes oppure categoryGlobalAttributes: No

Stringa

Utilizza questo parametro per aggiungere una descrizione dell'attributo di categoria di etichetta o fotogramma. Puoi utilizzare questo campo per fornire ai worker maggiori informazioni sull'attributo.

Questo campo è obbligatorio per gli attributi del fotogramma.

minimum e maximum Obbligatorio se l'attributo type è "number" Numeri interi

Utilizza questi parametri per specificare i valori minimi e massimi (inclusi) che i worker possono inserire per gli attributi numerici delle categorie di etichette o del fotogramma.

Devi specificare "number" per type per utilizzare minimum e maximum.

editsAllowed

No

Stringa

Valori obbligatori:

"none": non è consentita nessuna modifica.

oppure

"any" (Impostazione predefinita): tutte le modifiche sono consentite.

Speciifica se un attributo di categoria di etichetta o fotogramma può essere modificato o meno dai worker.

Per i lavori di regolazione ed etichettatura di verifica di fotogrammi video o nuvole di punti 3D, aggiungete questo parametro agli JSON oggetti con attributi di categoria e frame per specificare se un lavoratore può modificare o meno un attributo.

isRequired

No

Booleano

Specifica se i worker sono tenuti ad annotare un attributo. I worker non possono inviare il processo finché non vengono annotati tutti gli attributi obbligatori.

Etichetta e quote dell'attributo di categoria dell’etichetta

È possibile specificare fino a 10 attributi di categoria dell’etichetta per classe. Queste quote di 10 attributi includono gli attributi di categoria dell’etichetta globali. Ad esempio, se crei quattro attributi di categoria dell’etichetta globali e assegni tre attributi di categoria dell’etichetta all'etichetta X, tale etichetta avrà 4+3=7 attributi di categoria dell’etichetta in totale. Per tutti i limiti di categoria dell’etichetta e dell’attributo di categoria dell’etichetta, fai riferimento alla tabella riportata di seguito.

Tipo

Min

Max

Etichette (Labels)

1

30

Quota di caratteri per il nome dell'etichetta

1

16

Attributi della categoria dell’etichetta per etichetta (somma di categoryAttributes e categoryGlobalAttributes)

0

10

Attributi della categoria dell’etichetta con immissione di testo in forma libera per etichetta (somma di categoryAttributes e categoryGlobalAttributes).

0 5

Attributi del fotogramma

0

10

Attributi di immissione di testo in forma libera in frameAttributes.

0 5

Quota di caratteri per il nome dell'attributo (name)

1

16

Quota di caratteri per la descrizione dell’attributo (description)

0

128

Quota di caratteri per il tipo di attributo (type)

1

16

Valori consentiti nell'elenco enum per un attributo string

1 10

Quota di caratteri per un valore nell'elenco enum

1 16
Numero massimo di caratteri nella risposta di testo in forma libera per testo in forma libera frameAttributes 0 1000
Numero massimo di caratteri nella risposta di testo in forma libera per testo in forma libera categoryAttributes e categoryGlobalAttributes 0 80