Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Fichier de configuration des catégories d'étiquetage avec référence aux attributs de catégorie et de cadre
Lorsque vous créez une tâche d'étiquetage de nuages de points ou d'images vidéo en 3D à l'aide de l' SageMaker APIopération AmazonCreateLabelingJob
, vous utilisez un fichier de configuration des catégories d'étiquettes pour spécifier vos étiquettes et les instructions de travail. Vous pouvez également fournir ce qui suit dans votre fichier d'attributs de catégorie d'étiquette :
-
Vous pouvez fournir des attributs de catégorie d'étiquette pour les types de tâches de suivi et de détection d'objets dans les trames vidéo et les nuages de points 3D. Les employés peuvent affecter un ou plusieurs attributs aux annotations pour fournir plus d'informations sur cet objet. Par exemple, vous pouvez utiliser l'attribut occluded pour que les collaborateurs identifient les objets partiellement bloqués. Vous pouvez spécifier un attribut de catégorie d'étiquette pour une seule étiquette à l'aide du paramètre
categoryAttributes
ou pour toutes les étiquettes à l'aide du paramètrecategoryGlobalAttributes
. -
Vous pouvez fournir attributs de trame pour les types de tâches de suivi et de détection d'objets dans les trames vidéo et les nuages de points 3D à l'aide
frameAttributes
. Lorsque vous créez un attribut d'image, il apparaît sur chaque trame ou nuage de points de la tâche employé. Dans les tâches d'étiquetage de trame vidéo, il s'agit d'attributs que les employés attribuent à une trame vidéo entière. Pour les tâches d'étiquetage de nuage de points 3D, ces attributs sont appliqués à un nuage de points unique. Utilisez les attributs de cadre pour que les employés fournissent plus d'informations sur la scène dans une trame ou un nuage de points spécifique. -
Pour les tâches d'étiquetage de trame vidéo, vous utilisez le fichier de configuration de catégorie d'étiquettes pour spécifier le type de tâche (cadre de délimitation, polyligne, polygone ou point clé) envoyé aux employés.
Pour les employés, la spécification de valeurs pour les attributs de catégorie d'étiquette et les attributs de trame sera facultative.
Important
Vous ne devez fournir un nom d'attribut d'étiquette dans auditLabelAttributeName
que si vous exécutez une tâche d'audit pour vérifier ou ajuster des étiquettes. Utilisez ce paramètre pour saisir la valeur LabelAttributeNameutilisée dans la tâche d'étiquetage qui a généré les annotations que vous souhaitez que votre collaborateur ajuste. Lorsque vous créez une tâche d'étiquetage dans la console, si vous n'avez pas spécifié de nom d'attribut d'étiquette, le nom de votre tâche est utilisé comme LabelAttributeName.
Les rubriques suivantes présentent des exemples de fichier de configuration de catégories d'étiquettes pour différents types de tâches d'étiquetage. Ils expliquent également le schéma et les quotas d'un fichier de configuration de catégorie.
Rubriques
- Exemples : fichiers de configuration des catégories d'étiquettes pour les tâches d'étiquetage de nuages de points 3D
- Exemples : fichiers de configuration des catégories d'étiquettes pour les tâches d'étiquetage d'images vidéo
- Schéma du fichier de configuration des catégories d'étiquettes
- Quotas d'attribut d'étiquette et de catégorie d'étiquette
Exemples : fichiers de configuration des catégories d'étiquettes pour les tâches d'étiquetage de nuages de points 3D
Les rubriques suivantes présentent des exemples de fichiers de configuration de catégories d'étiquettes de nuages de points 3D pour les tâches de détection d'objets, de suivi d'objets, de segmentation sémantique, d'ajustement et d'étiquetage de vérification.
Rubriques
Exemple : suivi et détection d'objets dans un nuage de points 3D
Voici un exemple de fichier de configuration de catégorie d'étiquette qui inclut des attributs de catégorie d'étiquette pour une tâche d'étiquetage de détection ou de suivi d'objets de nuage de points 3D. Cet exemple inclut deux attributs de trame, qui seront ajoutés à tous les nuages de points soumis à la tâche d'étiquetage. L'étiquette Car
inclura quatre attributs de catégorie d'étiquette :X
, Y
, Z
et l'attribut global 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>
"} }
Exemple : segmentation sémantique d'un nuage de points 3D
Voici un exemple de fichier de configuration de catégorie d'étiquette pour une tâche d'étiquetage par segmentation sémantique de nuages de points 3D.
Les attributs de catégorie d'étiquette ne sont pas pris en charge pour les types de tâches de segmentation sémantique de nuage de points 3D. Les attributs de trame sont pris en charge. Si vous fournissez des attributs de catégorie d'étiquette pour une tâche d'étiquetage de segmentation sémantique, ils seront ignorés.
{ "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>"} }
Exemple : réglage d'un nuage de points 3D
Voici un exemple de fichier de configuration de catégorie d'étiquette pour une tâche d'étiquetage de détection d'objets de nuage de points ou de suivi d'objets. Pour les tâches d'étiquetage d'ajustement de segmentation sémantique de nuage de points 3D, categoryGlobalAttributes
et categoryAttributes
ne sont pas pris en charge.
Vous devez inclure auditLabelAttributeName
pour spécifier le nom d'attribut d'étiquette de la tâche d'étiquetage précédent que vous utilisez pour créer la tâche d'étiquetage d'ajustement. Le cas échéant, vous pouvez utiliser le paramètre editsAllowed
pour spécifier si un attribut d'étiquette ou de trame peut être modifié ou non.
{ "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
" }
Exemple : vérification d'un nuage de points 3D
Voici un exemple de fichier de configuration de catégorie d'étiquette que vous pouvez utiliser pour une tâche de vérification des étiquettes de détection ou de suivi d'objets dans un nuage de points 3D. Pour une tâche de vérification des étiquettes de segmentation sémantique dans un nuage de points 3D, categoryGlobalAttributes
et categoryAttributes
ne sont pas pris en charge.
Vous devez inclure auditLabelAttributeName
pour spécifier le nom d'attribut d'étiquette de la tâche d'étiquetage précédent que vous utilisez pour créer la tâche d'étiquetage de vérification. En outre, vous devez utiliser le paramètre editsAllowed
pour spécifier qu'aucune étiquette ne peut être modifiée.
{ "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
" }
Exemples : fichiers de configuration des catégories d'étiquettes pour les tâches d'étiquetage d'images vidéo
Les outils d'annotation disponibles pour votre employé et le type de tâche utilisé dépendent de la valeur que vous spécifiez pour annotationType
. Par exemple, si vous souhaitez que les employés utilisent des points clés pour suivre les modifications de la pose d'objets spécifiques sur plusieurs trames, vous devez spécifier Keypoint
pour annotationType
. Si vous ne spécifiez aucun type d'annotation, BoundingBox
sera utilisé par défaut.
Les rubriques suivantes présentent des exemples de fichiers de configuration de catégories d'images vidéo.
Rubriques
Exemple : point clé d'une image vidéo
Voici un exemple de fichier de configuration de catégorie d'étiquette de point clé pour une trame vidéo avec attributs de catégorie d'étiquette. Cet exemple inclut deux attributs de trame, qui seront ajoutés à toutes les trames soumises à la tâche d'étiquetage. L'étiquette Car
inclura quatre attributs de catégorie d'étiquette :X
, Y
, Z
et l'attribut global 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>
"} }
Exemple : réglage de l'image vidéo
Voici un exemple de fichier de configuration de catégorie d'étiquette que vous pouvez utiliser pour une tâche d'ajustement des étiquettes de trame vidéo.
Vous devez inclure auditLabelAttributeName
pour spécifier le nom d'attribut d'étiquette de la tâche d'étiquetage précédent que vous utilisez pour créer la tâche d'étiquetage de vérification. Le cas échéant, vous pouvez utiliser le paramètre editsAllowed
pour spécifier si les étiquettes, les attributs de catégorie d'étiquette ou les attributs de trame peuvent être modifiés.
{ "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
" }
Exemple : vérification des images vidéo
Voici un exemple de fichier de configuration de catégorie d'étiquette pour une tâche d'étiquetage de trame vidéo.
Vous devez inclure auditLabelAttributeName
pour spécifier le nom d'attribut d'étiquette de la tâche d'étiquetage précédent que vous utilisez pour créer la tâche d'étiquetage de vérification. En outre, vous devez utiliser le paramètre editsAllowed
pour spécifier qu'aucune étiquette ne peut être modifiée.
{ "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
" }
Schéma du fichier de configuration des catégories d'étiquettes
Le tableau suivant répertorie les éléments que vous pouvez et devez inclure dans votre fichier de configuration de catégorie d'étiquette.
Note
Le paramètre annotationType
est uniquement pris en charge pour les tâches d'étiquetage de trame vidéo.
Paramètre |
Obligatoire |
Valeurs acceptées |
Description |
---|---|---|---|
frameAttributes |
Non |
Liste d’objets JSON. Paramètres requis dans chaque JSON objet :
Paramètres facultatifs dans chaque JSON objet :
|
Utilisez ce paramètre pour créer un attribut de trame appliqué à toutes les trames ou à tous les nuages de points 3D dans votre tâche d'étiquetage. Consultez le troisième tableau de cette section pour plus d'informations. |
categoryGlobalAttributes |
Non |
Liste d’objets JSON. Paramètres requis dans chaque JSON objet :
Paramètres facultatifs dans chaque JSON objet :
|
Utilisez ce paramètre pour créer des attributs de catégorie d'étiquette appliqués à toutes les étiquettes que vous spécifiez dans |
labels |
Oui |
Une liste contenant jusqu'à 30 JSON objets Paramètres requis dans chaque JSON objet :
Paramètres facultatifs dans chaque JSON objet :
|
Utilisez ce paramètre pour spécifier vos étiquettes ou classes. Ajoutez un élément Pour ajouter un attribut de catégorie d'étiquette à une étiquette, ajoutez Utilisez Pour plus d'informations, veuillez consulter le tableau suivant. |
annotationType (uniquement pris en charge pour les tâches d'étiquetage de trame vidéo) |
Non |
Chaîne Paramètres acceptés :
Par défaut :
|
Utilisez cette option pour spécifier le type de tâche pour vos tâches d'étiquetage de trame vidéo. Par exemple, pour une tâche de détection d'objet de trame vidéo par polygone, choisissez Si vous ne spécifiez aucun |
instructions |
Non |
Un JSON objet Paramètres requis dans chaque JSON objet :
|
Utilisez ce paramètre pour ajouter des instructions de travail destinées à aider vos collaborateurs à accomplir leurs tâches. Pour de plus amples informations sur les instructions de travail, veuillez consulter Instructions à l’intention des travailleurs. Les instructions courtes doivent comporter moins de 255 caractères et les instructions longues doivent en comporter moins de 2 048. Pour de plus amples informations, veuillez consulter Création de pages d'instructions. |
auditLabelAttributeName |
Obligatoire pour les types de tâches d'ajustement et de vérification |
Chaîne |
Entrez la valeur LabelAttributeNameutilisée dans la tâche d'étiquetage dont vous souhaitez ajuster les annotations. Utilisez ce paramètre uniquement si vous créez une tâche d'ajustement de détection ou de suivi d'objets dans une trame vidéo ou un nuage de points 3D, ou de segmentation sémantique dans un nuage de points 3D. |
Schéma de l'objet Labels
Le tableau suivant décrit les paramètres que vous pouvez et devez utiliser pour créer une liste de Labels
. Chaque paramètre doit être inclus dans un JSON objet.
Paramètre | Obligatoire | Valeurs acceptées | Description |
---|---|---|---|
label |
Oui |
Chaîne |
Nom de la catégorie d'étiquettes qui s'affiche pour les employés. Chaque nom de catégorie d'étiquette doit être unique. |
categoryAttributes |
Non |
Liste d’objets JSON. Paramètres requis dans chaque JSON objet :
Paramètres facultatifs dans chaque JSON objet :
|
Utilisez ce paramètre pour ajouter des attributs de catégorie d'étiquette à des étiquettes spécifiques que vous spécifiez dans Pour ajouter un ou plusieurs attributs de catégorie d'étiquette à une étiquette, incluez l' |
editsAllowed |
Non |
Chaîne Valeurs prises en charge :
or
|
Spécifie si une étiquette peut ou non être modifiée par les employés. Pour les tâches d'étiquetage d'images vidéo ou de nuages de points 3D, ajoutez ce paramètre à un ou plusieurs JSON objets de la Pour les tâches d'étiquetage de nuages de points 3D et de vérification d'images vidéo, ajoutez ce paramètre avec la valeur |
frameAttributes et categoryGlobalAttributes schéma
Le tableau suivant décrit les paramètres que vous pouvez et devez utiliser pour créer un attribut de trame à l'aide de frameAttributes
et un attribut de catégorie d'étiquette à l'aide des paramètres categoryGlobalAttributes
et categoryAttributes
.
Paramètre |
Obligatoire |
Valeurs acceptées |
Description |
---|---|---|---|
name |
Oui |
Chaîne |
Utilisez ce paramètre pour attribuer un nom à votre attribut de catégorie d'étiquette. Il s'agit du nom que les employés voient pour cet attribut. Chaque nom d'attribut de catégorie d'étiquette dans votre fichier de configuration de catégorie d'étiquette doit être unique. Les attributs de catégorie d'étiquette globale et les attributs de catégorie d'étiquette spécifiques à une étiquette ne peuvent pas avoir le même nom. |
type |
Oui |
Chaîne Valeurs requises :
|
Utilisez ce paramètre pour définir le type d'attribut de catégorie d'étiquette ou de trame. Si vous spécifiez Si vous spécifiez Si vous spécifiez |
enum |
Non |
Liste de chaînes |
Utilisez ce paramètre pour définir les options que les employés peuvent choisir pour cet attribut de catégorie d'étiquette. Les collaborateurs peuvent choisir l'une des valeurs spécifiées dans Vous devez spécifier |
description |
|
Chaîne |
Utilisez ce paramètre pour ajouter une description de l'attribut de catégorie d'étiquette ou de trame. Vous pouvez utiliser ce champ pour donner aux employés plus d'informations sur l'attribut. Ce champ n'est obligatoire que pour les attributs de trame. |
minimum et maximum |
Obligatoire si l'attribut type est "number" |
Entiers |
Utilisez ces paramètres pour spécifier les valeurs minimales et maximales (inclusivement) que les employés peuvent saisir pour les attributs de catégorie d'étiquette numérique ou de trame. Vous devez spécifier |
editsAllowed |
Non |
Chaîne Valeurs requises :
or
|
Spécifie si une catégorie d'étiquette ou un attribut de trame peut ou non être modifié par les employés. Pour les tâches de réglage et d'étiquetage de vérification d'images vidéo ou de nuages de points 3D, ajoutez ce paramètre pour étiqueter les JSON objets de catégorie et d'attribut d'image afin de spécifier si un utilisateur peut modifier un attribut ou non. |
isRequired |
Non |
Booléen |
Spécifie si les employés doivent annoter un attribut. Les employés ne peuvent pas soumettre la tâche tant que tous les attributs requis n'ont pas été annotés. |
Quotas d'attribut d'étiquette et de catégorie d'étiquette
Vous pouvez spécifier jusqu'à 10 attributs de catégorie d'étiquettes par classe. Ces quotas de 10 attributs incluent des attributs de catégorie d'étiquette globale. Par exemple, si vous créez quatre attributs de catégorie d'étiquette globale, puis que vous affectez trois attributs de catégorie d'étiquette à l'étiquette X
, cette étiquette aura 4+3=7 attributs de catégorie d'étiquette au total. Pour connaître toutes les limites des attributs de catégorie d'étiquette et des catégories d'étiquette, veuillez consulter le tableau suivant.
Type |
Min |
Max |
---|---|---|
Étiquettes ( |
1 |
30 |
Quota de caractères du nom de l'étiquette |
1 |
16 |
Attributs de catégorie d'étiquette par étiquette (somme de |
0 USD |
10 |
Attributs de catégorie d'étiquette de saisie de texte libre par étiquette (somme de |
0 | 5 |
Attributs de trame |
0 USD |
10 |
Attributs de saisie de texte libre dans |
0 | 5 |
Quota de caractères du nom d'attribut ( |
1 |
16 |
Quota de caractères de la description d'attribut ( |
0 |
128 |
Quota de caractères du type d'attribut ( |
1 |
16 |
Valeurs autorisées dans la liste |
1 | 10 |
Quota de caractères pour une valeur dans la liste |
1 | 16 |
Nombre maximal de caractères dans la réponse de texte libre pour le texte libre frameAttributes |
0 | 1 000 |
Nombre maximal de caractères dans la réponse de texte libre pour le texte libre categoryAttributes et categoryGlobalAttributes |
0 | 80 |