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 parametrocategoryGlobalAttributes
. -
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.
Argomenti
- Esempi: file di configurazione delle categorie di etichette per lavori di etichettatura con nuvole di punti 3D
- Esempi: file di configurazione delle categorie di etichette per lavori di etichettatura di fotogrammi video
- Schema del file di configurazione delle categorie di etichette
- Etichetta e quote dell'attributo di categoria dell’etichetta
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.
Argomenti
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.
Argomenti
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:
Parametri opzionali in ogni JSON oggetto:
|
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:
Parametri opzionali in ogni JSON oggetto:
|
Utilizza questo parametro per creare attributi della categoria dell’etichetta da applicare a tutte le etichette specificate in |
labels |
Sì |
Un elenco di un massimo di 30 JSON oggetti Parametri obbligatori in ogni JSON oggetto:
Parametri opzionali in ogni JSON oggetto:
|
Utilizza questo parametro per specificare le etichette o le classi. Aggiungi un elemento Per aggiungere un attributo della categoria dell’etichetta a un'etichetta, aggiungi Utilizza Per ulteriori informazioni, consulta la tabella seguente. |
annotationType (supportato solo per i processi di etichettatura di fotogrammi video) |
No |
Stringa Parametri accettati:
Default:
|
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 Se non specifichi un |
instructions |
No |
Un JSON oggetto Parametri richiesti in ogni JSON oggetto:
|
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 |
Sì |
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:
Parametri opzionali in ogni JSON oggetto:
|
Utilizza questo parametro per aggiungere gli attributi di categoria dell’etichetta a determinate etichette specificate in Per aggiungere uno o più attributi di categoria di etichette a un'etichetta, includi l' |
editsAllowed |
No |
Stringa Valori supportati:
oppure
|
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' Per i lavori di etichettatura con nuvole di punti 3D e verifica di fotogrammi video, aggiungete questo parametro con il valore |
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 |
Sì |
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 |
Sì |
Stringa Valori obbligatori:
|
Utilizza questo parametro per definire il tipo di attributo della categoria di etichetta o fotogramma. Se specifichi Se specifichi Se specifichi |
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 Devi specificare |
description |
|
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 |
editsAllowed |
No |
Stringa Valori obbligatori:
oppure
|
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 ( |
1 |
30 |
Quota di caratteri per il nome dell'etichetta |
1 |
16 |
Attributi della categoria dell’etichetta per etichetta (somma di |
0 |
10 |
Attributi della categoria dell’etichetta con immissione di testo in forma libera per etichetta (somma di |
0 | 5 |
Attributi del fotogramma |
0 |
10 |
Attributi di immissione di testo in forma libera in |
0 | 5 |
Quota di caratteri per il nome dell'attributo ( |
1 |
16 |
Quota di caratteri per la descrizione dell’attributo ( |
0 |
128 |
Quota di caratteri per il tipo di attributo ( |
1 |
16 |
Valori consentiti nell'elenco |
1 | 10 |
Quota di caratteri per un valore nell'elenco |
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 |