Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Archivo de configuración de categorías de etiquetado con referencia de categorías de etiquetas y atributos de marco
Cuando crea un trabajo de etiquetado de fotogramas de vídeo o nubes de puntos 3D mediante la SageMaker API operación de AmazonCreateLabelingJob
, utiliza un archivo de configuración de categorías de etiquetas para especificar las etiquetas y las instrucciones de trabajo. Si lo desea, también puede incluir lo siguiente en el archivo de atributos de categorías de etiquetas:
-
Puede proporcionar atributos de categorías de etiquetas para los tipos de tareas de detección y seguimiento de objetos en fotogramas de vídeo y nubes de puntos 3D. Los trabajadores pueden utilizar uno o varios atributos para proporcionar más información sobre un objeto. Por ejemplo, quizá convenga utilizar el atributo ocluido para que los trabajadores identifiquen cuándo está parcialmente obstruido un objeto. Puede especificar un atributo de categorías de etiquetas para una sola etiqueta mediante el parámetro
categoryAttributes
o para todas las etiquetas mediante el parámetrocategoryGlobalAttributes
. -
Puede proporcionar atributos de fotogramas para los tipos de tareas de detección de objetos y seguimiento de objetos en fotogramas de vídeo y nubes de puntos 3D utilizando
frameAttributes
. Cuando crea un atributo de fotogramas, aparece en cada fotograma o nube de puntos de la tarea del trabajador. En los trabajos de etiquetado de fotogramas de vídeo, son atributos que los trabajadores asignan a un fotograma de vídeo completo. En los trabajos de etiquetado en nubes de puntos 3D, estos atributos se aplican a una sola nube de puntos. Utilice los atributos de fotogramas para que los trabajadores proporcionen más información sobre la escena en un fotograma o una nube de puntos específicos. -
Para los trabajos de etiquetado de fotogramas de vídeo, utilice el archivo de configuración de categorías de etiquetas para especificar el tipo de tarea (cuadro delimitador, polilínea, polígono o punto clave) que se enviará a los trabajadores.
Los trabajadores podrán especificar de manera opcional valores para los atributos de categorías de etiquetas y los atributos de fotogramas.
importante
Solo debe proporcionar un nombre de atributo de etiqueta en auditLabelAttributeName
si está ejecutando un trabajo de auditoría para verificar o ajustar etiquetas. Utilice este parámetro para introducir las LabelAttributeNameutilizadas en el trabajo de etiquetado que generó las anotaciones que desea que ajuste su trabajador. Al crear un trabajo de etiquetado en la consola, si no especificó un nombre de atributo de etiqueta, se utilizará el nombre del trabajo como. LabelAttributeName
En los temas siguientes se muestran ejemplos de un archivo de configuración de categorías de etiquetas para distintos tipos de trabajos de etiquetado. También explican el esquema y las cuotas de un archivo de configuración de categorías.
Temas
- Ejemplos: archivos de configuración de categorías de etiquetas para trabajos de etiquetado de nubes de puntos 3D
- Ejemplos: archivos de configuración de categorías de etiquetas para trabajos de etiquetado de fotogramas de vídeo
- Esquema del fichero de configuración de categorías de etiquetas
- Cuotas de atributos de etiquetas y de categorías de etiquetas
Ejemplos: archivos de configuración de categorías de etiquetas para trabajos de etiquetado de nubes de puntos 3D
En los temas siguientes se muestran ejemplos de archivos de configuración de categorías de etiquetas de nubes de puntos 3D para tareas de detección, seguimiento de objetos, segmentación semántica, ajuste y etiquetado de verificación.
Temas
Ejemplo: seguimiento y detección de objetos mediante nubes de puntos en 3D
A continuación se ofrece un ejemplo de archivo de configuración de categorías de etiquetas que incluye atributos de categorías de etiquetas para un trabajo de etiquetado de detección o seguimiento de objetos en nubes de puntos 3D. Este ejemplo incluye dos atributos de fotograma, que se añadirán a todas las nubes de puntos enviadas al trabajo de etiquetado. La etiqueta Car
incluirá cuatro atributos de categorías de etiquetas: X
, Y
, Z
y el atributo 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>
"} }
Ejemplo: segmentación semántica de nubes de puntos 3D
A continuación se ofrece un ejemplo del archivo de configuración de categorías de etiquetas para un trabajo de etiquetado de segmentación en nubes de puntos 3D.
Los tipos de tareas de segmentación semántica en nubes de puntos 3D no admiten atributos de categorías de etiquetas. Se admiten atributos de fotogramas. Si proporciona atributos de categorías de etiquetas para un trabajo de etiquetado de segmentación semántica, no se tendrán en cuenta.
{ "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>"} }
Ejemplo: ajuste de nubes de puntos 3D
A continuación se ofrece un ejemplo de archivo de configuración de categorías de etiquetas para un trabajo de etiquetado de ajuste de detección o seguimiento de objetos en nubes de puntos. No se admiten categoryGlobalAttributes
y categoryAttributes
en los trabajos de etiquetado de ajuste de segmentación semántica en nubes de puntos 3D.
Debe incluir auditLabelAttributeName
para especificar el nombre del atributo de etiquetas del trabajo de etiquetado anterior que utiliza para crear el trabajo de etiquetado de ajuste. Opcionalmente, puede utilizar el parámetro editsAllowed
para especificar si se puede editar o no un atributo de etiquetas o de fotogramas.
{ "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
" }
Ejemplo: verificación de nubes de puntos en 3D
A continuación se ofrece un ejemplo de archivo de configuración de categorías de etiquetas que puede utilizar para un trabajo de etiquetado de verificación de detección o seguimiento de objetos en nubes de puntos 3D. No se admiten categoryGlobalAttributes
y categoryAttributes
en los trabajos de etiquetado de verificación de segmentación semántica en nubes de puntos 3D.
Debe incluir auditLabelAttributeName
para especificar el nombre del atributo de etiquetas del trabajo de etiquetado anterior que utiliza para crear el trabajo de etiquetado de verificación. Además, debe utilizar el parámetro editsAllowed
para especificar que no se pueda editar ninguna etiqueta.
{ "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
" }
Ejemplos: archivos de configuración de categorías de etiquetas para trabajos de etiquetado de fotogramas de vídeo
Las herramientas de anotación disponibles para el trabajador y el tipo de tarea que utilice dependen del valor que especifique para annotationType
. Por ejemplo, si desea que los trabajadores utilicen puntos clave para realizar un seguimiento de los cambios en la postura de objetos específicos en varios fotogramas, debe especificar Keypoint
para annotationType
. Si no especifica un tipo de anotación, se utilizará BoundingBox
de manera predeterminada.
En los temas siguientes se muestran ejemplos de archivos de configuración de categorías de fotogramas de vídeo.
Temas
Ejemplo: punto clave de un fotograma de vídeo
A continuación se ofrece un ejemplo de archivo de configuración de categorías de etiquetas de puntos clave en fotogramas de vídeo con atributos de categorías de etiquetas. Este ejemplo incluye dos atributos de fotogramas, que se añadirán a todos los fotogramas enviados al trabajo de etiquetado. La etiqueta Car
incluirá cuatro atributos de categorías de etiquetas: X
, Y
, Z
y el atributo 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>
"} }
Ejemplo: ajuste de fotogramas de vídeo
A continuación se ofrece un ejemplo de archivo de configuración de categorías de etiquetas que puede utilizar para un trabajo de etiquetado de ajuste de fotogramas de vídeo.
Debe incluir auditLabelAttributeName
para especificar el nombre del atributo de etiquetas del trabajo de etiquetado anterior que utiliza para crear el trabajo de etiquetado de verificación. Opcionalmente, puede utilizar el parámetro editsAllowed
para especificar si se pueden editar o no etiquetas, atributos de categorías de etiquetas o atributos de fotogramas.
{ "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
" }
Ejemplo: verificación de fotogramas de vídeo
A continuación se ofrece un ejemplo de archivo de configuración de categorías de etiquetas para un trabajo de etiquetado de fotogramas de vídeo.
Debe incluir auditLabelAttributeName
para especificar el nombre del atributo de etiquetas del trabajo de etiquetado anterior que utiliza para crear el trabajo de etiquetado de verificación. Además, debe utilizar el parámetro editsAllowed
para especificar que no se pueda editar ninguna etiqueta.
{ "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
" }
Esquema del fichero de configuración de categorías de etiquetas
En la tabla siguiente se enumeran los elementos que puede y debe incluir en el archivo de configuración de categorías de etiquetas.
nota
El parámetro annotationType
solo se admite para los trabajos de etiquetado de fotogramas de vídeo.
Parámetro |
Obligatoria |
Valores aceptados |
Descripción |
---|---|---|---|
frameAttributes |
No |
Una lista de objetos JSON. Parámetros necesarios en cada JSON objeto:
Parámetros opcionales en cada JSON objeto:
|
Utilice este parámetro para crear un atributo de fotogramas que se aplique a todos los fotogramas o nubes de puntos 3D del trabajo de etiquetado. Consulte la tercera tabla de esta sección para obtener más información. |
categoryGlobalAttributes |
No |
Una lista de objetos JSON. Parámetros necesarios en cada JSON objeto:
Parámetros opcionales en cada JSON objeto:
|
Utilice este parámetro para crear atributos de categorías de etiquetas que se apliquen a todas las etiquetas especificadas en |
labels |
Sí |
Una lista de hasta 30 JSON objetos Parámetros necesarios en cada JSON objeto:
Parámetros opcionales en cada JSON objeto:
|
Utilice este parámetro para especificar las etiquetas o las clases. Agregue una Para agregar un atributo de categorías a una etiqueta, agregue Utilice Para obtener más información, consulte la siguiente tabla. |
annotationType (solo se admite para los trabajos de etiquetado de fotogramas de vídeo) |
No |
Cadena Parámetros aceptados:
Valor predeterminado:
|
Utilice esta opción para especificar el tipo de tarea para trabajos de etiquetado de fotogramas de vídeo. Por ejemplo, para una tarea de detección de objetos poligonales en fotogramas de vídeo, elija Si no especifica |
instructions |
No |
Un JSON objeto Parámetros necesarios en cada JSON objeto:
|
Utilice este parámetro para agregar instrucciones de trabajo para ayudar a los trabajadores a llevar a cabo sus tareas. Para obtener más información acerca de las instrucciones de trabajo, consulte Instrucciones de trabajo. Las instrucciones breves deben tener menos de 255 caracteres y las instrucciones largas, menos de 2048 caracteres. Para obtener más información, consulte Crear páginas de instrucciones. |
auditLabelAttributeName |
Necesario para los tipos de tareas de ajuste y verificación |
Cadena |
Introduzca los LabelAttributeNameutilizados en el trabajo de etiquetado cuyas anotaciones desee ajustar. Utilice este parámetro solo si está creando un trabajo de ajuste para detección de objetos en fotogramas de vídeo y nubes de puntos 3D, seguimiento de objetos o segmentación semántica en nubes de puntos 3D. |
Etiqueta el esquema de objetos
En la siguiente tabla se describen los parámetros que puede y debe utilizar para crear una lista de Labels
. Cada parámetro debe incluirse en un JSON objeto.
Parámetro | Obligatoria | Valores aceptados | Descripción |
---|---|---|---|
label |
Sí |
Cadena |
El nombre de la categoría de etiquetas que se muestra a los trabajadores. El nombre de cada categoría de etiquetas debe ser único. |
categoryAttributes |
No |
Una lista de objetos JSON. Parámetros necesarios en cada JSON objeto:
Parámetros opcionales en cada JSON objeto:
|
Utilice este parámetro para agregar atributos de categorías de etiquetas a etiquetas concretas especificadas en Para añadir uno o más atributos de categoría de etiqueta a una etiqueta, incluya el |
editsAllowed |
No |
Cadena Valores admitidos:
o
|
Especifica si los trabajadores pueden editar o no una etiqueta. Para los trabajos de etiquetado y ajuste de fotogramas de vídeo o nubes de puntos 3D, añada este parámetro a uno o varios JSON objetos de la Para los trabajos de etiquetado y verificación de cuadros de vídeo y nubes de puntos en 3D, añada este parámetro con el valor |
frameAttributes y categoryGlobalAttributes esquema
En la tabla siguiente se describen los parámetros que puede y debe utilizar para crear atributos de fotogramas utilizando frameAttributes
y atributos de categorías de etiquetas utilizando los parámetros categoryGlobalAttributes
y categoryAttributes
.
Parámetro |
Obligatoria |
Valores aceptados |
Descripción |
---|---|---|---|
name |
Sí |
Cadena |
Utilice este parámetro para asignar un nombre al atributo de categorías de etiquetas. Este es el nombre del atributo que ven los trabajadores. El nombre de cada atributo de categorías de etiquetas debe ser único en el archivo de configuración de categorías de etiquetas. Los atributos de categorías de etiquetas globales y los atributos de categorías de etiquetas específicas no pueden tener el mismo nombre. |
type |
Sí |
Cadena Valores requeridos:
|
Utilice este parámetro para definir el tipo de categoría de etiquetas o de atributo de fotogramas. Si especifica Si especifica Si especifica |
enum |
No |
Lista de cadenas |
Utilice este parámetro para definir opciones que los trabajadores pueden elegir para este atributo de categorías de etiquetas. Los trabajadores pueden elegir un valor especificado en Debe especificar |
description |
|
Cadena |
Utilice este parámetro para agregar una descripción del atributo de categorías de etiquetas o de fotogramas. Puede utilizar este campo para dar a los trabajadores más información acerca del atributo. Este campo solo es necesario para los atributos de fotogramas. |
minimum y maximum |
Es obligatorio si el atributo type es "number" . |
Enteros |
Utilice estos parámetros para especificar los valores mínimos y máximos (inclusivos) que los trabajadores pueden introducir para los atributos de categorías de etiquetas numéricas o de fotogramas. Debe especificar |
editsAllowed |
No |
Cadena Valores requeridos:
o
|
Especifica si los trabajadores pueden editar un atributo de categorías de etiquetas o de fotogramas. Para los trabajos de etiquetado de verificación y ajuste de cuadros de vídeo o nubes de puntos 3D, añada este parámetro a JSON los objetos de categorías y atributos de fotogramas de etiquetas para especificar si un trabajador puede editar un atributo o no. |
isRequired |
No |
Booleano |
Especifica si los trabajadores deben anotar un atributo. Los trabajadores no pueden enviar el trabajo hasta que se hayan anotado todos los atributos necesarios. |
Cuotas de atributos de etiquetas y de categorías de etiquetas
Puede especificar hasta 10 atributos de categorías de etiquetas por clase. Esta cuota de 10 atributos incluye atributos de categorías de etiquetas globales. Por ejemplo, si crea cuatro atributos de categorías de etiquetas globales y, a continuación, asigna tres atributos de categorías de etiquetas a la etiqueta X
, dicha etiqueta tendrá 4+3=7 atributos de categorías de etiquetas en total. Para ver todos los límites de categorías de etiquetas y de atributos de categorías de etiquetas, consulte la tabla siguiente.
Tipo |
Mínimo |
Máximo |
---|---|---|
Etiquetas ( |
1 |
30 |
Cuota de caracteres del nombre de la etiqueta |
1 |
16 |
Etiquete los atributos de categorías por etiqueta (suma de |
0 |
10 |
Atributos de categorías de etiquetas con entrada de texto de formato libre por etiqueta (suma de |
0 | 5 |
Atributos de fotogramas |
0 |
10 |
Atributos de entrada de texto de formato libre en |
0 | 5 |
Cuota de caracteres del nombre de atributo ( |
1 |
16 |
Cuota de caracteres de la descripción del atributo ( |
0 |
128 |
Cuota de caracteres del tipo de atributo ( |
1 |
16 |
Valores permitidos en la lista |
1 | 10 |
Cuota de caracteres para un valor de la lista |
1 | 16 |
Número máximo de caracteres en la respuesta de texto de formato libre para texto de formato libre frameAttributes |
0 | 1 000 |
Máximo de caracteres en la respuesta de texto de formato libre para texto de formato libre categoryAttributes y categoryGlobalAttributes |
0 | 80 |