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.
Créer un fichier de configuration de catégorie d'étiquetage avec les attributs de catégorie d'étiquette et de trame
Lorsque vous créez une tâche d'étiquetage de nuage de points 3D ou de trame vidéo à l'aide de l'opération CreateLabelingJob
de l'API Amazon SageMaker, vous utilisez un fichier de configuration de catégorie d'étiquette pour spécifier vos étiquettes et vos instructions employé. 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 entrer l'élément LabelAttributeName utilisé dans la tâche d'étiquetage qui a généré les annotations que votre collaborateur doit ajuster. 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.
Rubriques
- Schéma du fichier de configuration de catégorie d'étiquette
- Exemple : Fichiers de configuration des catégories d'étiquettes pour les tâches d'étiquetage de nuage de points 3D
- Exemple : fichiers de configuration de catégorie d'étiquettes pour les tâches d'étiquetage de trame vidéo
- Création d'instructions de travail
Schéma du fichier de configuration de catégorie d'étiquette
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 |
Une liste d'objets JSON. Paramètres requis dans chaque objet JSON :
Paramètres facultatifs dans chaque objet JSON :
|
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 |
Une liste d'objets JSON. Paramètres requis dans chaque objet JSON :
Paramètres facultatifs dans chaque objet JSON :
|
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 de 30 objets JSON maximum Paramètres requis dans chaque objet JSON :
Paramètres facultatifs dans chaque objet JSON :
|
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 objet JSON Paramètres requis dans chaque objet JSON :
|
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 de travail. 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 d'instructions de travail. |
auditLabelAttributeName |
Obligatoire pour les types de tâches d'ajustement et de vérification |
Chaîne |
Entrez le nom LabelAttributeName utilisé 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. |
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 objet JSON.
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 |
Une liste d'objets JSON. Paramètres requis dans chaque objet JSON :
Paramètres facultatifs dans chaque objet JSON :
|
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'objet JSON |
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'ajustement de trame vidéo ou nuage de points 3D, ajoutez ce paramètre à un ou plusieurs objets JSON dans la liste Pour les tâches de vérification de trame vidéo ou nuage de points 3D, ajoutez ce paramètre avec la valeur |
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 d'ajustement et de vérification de trame vidéo ou nuage de points 3D, ajoutez ce paramètre aux objets JSON de catégorie d'étiquette et d'attribut de trame pour spécifier si un employé peut ou non modifier une étiquette. |
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 |
Exemple : Fichiers de configuration des catégories d'étiquettes pour les tâches d'étiquetage de nuage de points 3D
Sélectionnez un onglet dans les tableaux suivants pour afficher des exemples de fichiers de configuration de catégories d'étiquettes de nuage de points 3D pour les tâches d'étiquetage de détection d'objets, de suivi d'objets, de segmentation sémantique, d'ajustement et de vérification.
Sélectionnez un onglet dans le tableau suivant pour afficher un exemple de fichier de configuration de catégorie d'étiquettes pour les tâches d'étiquetage de vérification ou d'ajustement de nuage de points 3D.
Exemple : fichiers de configuration de catégorie d'étiquettes pour les tâches d'étiquetage de trame 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.
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>
"} }
Sélectionnez un onglet dans le tableau suivant pour afficher des exemples de fichiers de configuration de catégories d'étiquettes pour les tâches d'ajustement et de vérification des étiquettes de trame vidéo.
Création d'instructions de travail
Créez des instructions personnalisées pour l'étiquetage des tâches afin d'améliorer la précision de l'application de travail lorsqu'elle exécute ses tâches. Vos instructions sont accessibles lorsque les collaborateurs sélectionnent l'option de menu Instructions dans l'interface utilisateur de travail. Les instructions courtes doivent comporter moins de 255 caractères et les instructions longues doivent en comporter moins de 2 048.
Il existe deux types d'instructions :
-
Instructions courtes – Ces instructions sont affichées aux employés lorsqu'ils sélectionnent Instructions dans le menu de l'interface utilisateur employé. Ces instructions doivent fournir une référence facile à comprendre pour indiquer au collaborateur comment étiqueter correctement un objet.
-
Instructions complètes – Ces instructions s'affichent lorsque les employés sélectionnent Plus d'instructions dans la fenêtre contextuelle d'instructions. Nous vous recommandons de fournir des instructions détaillées pour exécuter la tâche avec plusieurs exemples illustrant les cas limites et autres situations difficiles pour étiqueter des objets.
Pour les tâches d'étiquetage de nuage de points 3D, vous pouvez ajouter des instructions employé à votre fichier de configuration de catégorie d'étiquette. Vous pouvez utiliser une seule chaîne pour créer des instructions ou ajouter une marque HTML pour personnaliser l'apparence de vos instructions et ajouter des images. Assurez-vous que toutes les images que vous incluez dans vos instructions sont accessibles au public ou, si vos instructions sont incluses dans Amazon S3, que vos employés disposent d'un accès en lecture leur permettant de les visualiser.