As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Arquivo de configuração de categorias de rotulagem com referência de atributos de categorias e quadros de rótulo
Quando criar um trabalho de rotulagem de nuvem de pontos 3D ou quadro de vídeo usando a operação CreateLabelingJob
de API do Amazon SageMaker, use um arquivo de configuração de categoria de rótulo para especificar seus rótulos e as instruções do operador. Opcionalmente, você pode fornecer o seguinte em seu arquivo de atributo de categoria de rótulo:
-
Você pode fornecer atributos de categoria de rótulo para quadros de vídeo e rastreamento de objetos de nuvem de pontos 3D e tipos de tarefas de detecção de objetos. Os operadores podem usar um ou mais atributos para fornecer mais informações sobre esse objeto. Por exemplo, você pode querer usar o atributo obstruído para que os operadores identifiquem quando um objeto está parcialmente obstruído. É possível especificar um atributo de categoria de rótulo para um único rótulo usando o parâmetro
categoryAttributes
ou para todos os rótulos que usam o parâmetrocategoryGlobalAttributes
. -
Você pode fornecer atributos de quadro para de rótulo para rastreamento de objetos quadros de vídeo de nuvem de pontos 3D e tipos de tarefas de detecção de objetos usando
frameAttributes
. Quando você cria um atributo de quadro, ele aparece em cada quadro ou nuvem de pontos na tarefa do operador. Em trabalhos de rotulagem de quadros de vídeo, esses são atributos que os operadores atribuem a um quadro de vídeo inteiro. Para trabalhos de rotulagem de nuvem de pontos 3D, esses atributos são aplicados a uma única nuvem de pontos. Use atributos de quadro para que os operadores forneçam mais informações sobre a cena em um quadro específico ou nuvem de pontos. -
Para trabalhos de rotulagem de quadros de vídeo, você usa o arquivo de configuração da categoria de rótulo para especificar o tipo de tarefa (caixa delimitadora, linha poligonal, polígono ou ponto-chave) enviada aos operadores.
Para operadores, especificar valores para atributos de categoria de rótulo e atributos de quadro será opcional.
Importante
Você só deverá fornecer um nome de atributo de rótulo em auditLabelAttributeName
se estiver executando um trabalho de auditoria para verificar ou ajustar rótulos. Use esse parâmetro para inserir o LabelAttributeName usado no trabalho de rotulagem que gerou as anotações que você deseja que o operador ajuste. Ao criar um trabalho de rotulagem no console, se você não especificou um nome de atributo de rótulo, o Nome do trabalho é usado como LabelAttributeName.
Os tópicos a seguir mostram exemplos de um arquivo de configuração de categoria de rótulo para diferentes tipos de trabalhos de rotulagem. Eles também explicam o esquema e as cotas de um arquivo de configuração de categoria.
Tópicos
- Exemplos: arquivos de configuração de categoria de rótulo para trabalhos de rotulagem de nuvem de pontos 3D
- Exemplo: arquivos de configuração de categoria de rótulos para trabalhos de rotulagem de quadros de vídeo
- Esquema do arquivo de configuração da categoria de rótulos
- Cotas de rótulo e de atributo da categoria de rótulo
Exemplos: arquivos de configuração de categoria de rótulo para trabalhos de rotulagem de nuvem de pontos 3D
Os seguintes tópicos evidenciam exemplos de arquivos de configuração de categorias de rótulos de nuvem de pontos 3D para trabalhos de rotulagem de detecção de objetos, rastreamento de objetos, segmentação semântica, ajuste e verificação:
Tópicos
Exemplo: rastreamento de objetos de nuvem de pontos 3D e detecção de objetos
Veja a seguir um exemplo de um arquivo de configuração de categoria de rótulo que inclui atributos de categoria de rótulo para uma tarefa de detecção de objetos de nuvem de pontos 3D ou de rotulagem de rastreamento de objetos. Este exemplo inclui dois atributos de quadro, que serão adicionados a todas as nuvens de pontos enviadas ao trabalho de rotulagem. O rótulo Car
incluirá quatro atributos de categoria de rótulo - X
,Y
,Z
e o 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>
"} }
Exemplo: Segmentação semântica da nuvem de pontos 3D
Veja a seguir um exemplo um arquivo de configuração de categoria de rótulo para um trabalho de rotulagem de segmentação semântica de nuvem de pontos 3D.
Os atributos da categoria de rótulo não são compatíveis para tipos de tarefas de segmentação semântica de nuvem de pontos 3D. Os atributos do quadro são compatíveis. Se você fornecer atributos da categoria de rótulo para um trabalho de rotulagem de segmentação semântica, eles serão ignorados.
{ "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>"} }
Exemplo: ajuste da nuvem de pontos 3D
Veja a seguir um exemplo de um arquivo de configuração de categoria de rótulo para uma tarefa de rotulagem de detecção de objetos em nuvem de pontos 3D ou ajuste de rastreamento de objetos. Não há compatibilidade com trabalhos de rotulagem de segmentação semântica de nuvem de pontos 3D categoryGlobalAttributes
e categoryAttributes
.
Você deve incluir auditLabelAttributeName
para especificar o nome do atributo da rótulo da tarefa de rotulagem anterior que você usa para criar a tarefa de rotulagem de ajuste. Opcionalmente, você pode usar o parâmetro editsAllowed
para especificar se um atributo de rótulo ou quadro pode ou não ser editado.
{ "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
" }
Exemplo: verificação da nuvem de pontos 3D
Veja a seguir um exemplo de um arquivo de configuração de categoria de rótulo que você pode usar para um trabalho de identificação de detecção de objetos em nuvem de pontos 3D ou verificação de rastreamento de objetos. Não há compatibilidade com trabalhos de rotulagem de verificação de segmentação semântica de nuvem de pontos 3D categoryGlobalAttributes
e categoryAttributes
.
Você deve incluir auditLabelAttributeName
para especificar o nome do atributo da rótulo da tarefa de rotulagem anterior que você usa para criar a tarefa de rotulagem de verificação. Além disso, você deve usar o parâmetro editsAllowed
para especificar que nenhum rótulo pode ser editado.
{ "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
" }
Exemplo: arquivos de configuração de categoria de rótulos para trabalhos de rotulagem de quadros de vídeo
As ferramentas de anotação disponíveis para seu operador e o tipo de tarefa usado dependem do valor que você especifica para annotationType
. Por exemplo, se você quiser que os operadores usem pontos-chave para rastrear alterações na pose de objetos específicos em vários quadros, você especificaria Keypoint
para annotationType
. Se você não especificar um tipo de anotação, BoundingBox
será usado por padrão.
Os tópicos a seguir evidenciam exemplos de arquivos de configuração da categoria de quadros de vídeo.
Tópicos
Exemplo: ponto-chave de quadros de vídeo
Veja a seguir um exemplo de um arquivo de configuração de categoria de rótulo de ponto-chave de quadro de vídeo com atributos de categoria de rótulo. Este exemplo inclui dois atributos de quadro, que serão adicionados a todos os quadros enviados ao trabalho de rotulagem. O rótulo Car
incluirá quatro atributos de categoria de rótulo - X
, Y
, Z
e o 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>
"} }
Exemplo: ajuste do quadro de vídeo
A seguir está um exemplo de um arquivo de configuração de categoria de rótulo que você pode usar para um trabalho de rotulagem de ajuste de quadro de vídeo.
Você deve incluir auditLabelAttributeName
para especificar o nome do atributo da rótulo da tarefa de rotulagem anterior que você usa para criar a tarefa de rotulagem de verificação. Opcionalmente, você pode usar o parâmetro editsAllowed
para especificar se rótulos, atributos de categoria e rótulo ou atributos de quadro podem ou não ser editados.
{ "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
" }
Exemplo: verificação de quadros de vídeo
Veja a seguir um exemplo de um arquivo de configuração de categoria de rótulo para um trabalho de rotulagem de quadros de vídeo.
Você deve incluir auditLabelAttributeName
para especificar o nome do atributo da rótulo da tarefa de rotulagem anterior que você usa para criar a tarefa de rotulagem de verificação. Além disso, você deve usar o parâmetro editsAllowed
para especificar que nenhum rótulo pode ser editado.
{ "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 do arquivo de configuração da categoria de rótulos
A tabela a seguir lista os elementos que você pode e deve incluir no arquivo de configuração da categoria de rótulo.
nota
O parâmetro annotationType
só é compatível com trabalhos de rotulagem de quadros de vídeo.
Parâmetro |
Obrigatório |
Valores aceitos |
Descrição |
---|---|---|---|
frameAttributes |
Não |
Uma lista de objetos JSON. Parâmetros necessários em cada objeto JSON:
Parâmetros opcionais em cada objeto JSON:
|
Use esse parâmetro para criar um atributo de quadro que seja aplicado a todos os quadros ou nuvens de pontos 3D em seu trabalho de rotulagem. Consulte a terceira tabela nesta seção para obter mais informações. |
categoryGlobalAttributes |
Não |
Uma lista de objetos JSON. Parâmetros necessários em cada objeto JSON:
Parâmetros opcionais em cada objeto JSON:
|
Use esse parâmetro para criar atributos da categoria de rótulo que são aplicados a todos os rótulos especificados em |
labels |
Sim |
Uma lista de até 30 objetos JSON Parâmetros necessários em cada objeto JSON:
Parâmetros opcionais em cada objeto JSON:
|
Use esse parâmetro para especificar os rótulos, ou classes. Adicione um Para adicionar um atributo da categoria de rótulo a um rótulo, adicione Use Consulte a tabela a seguir para obter mais informações. |
annotationType (compatível somente com trabalhos de rotulagem de quadros de vídeo) |
Não |
String Parâmetros aceitos:
Padrão:
|
Use isso para especificar o tipo de tarefa para seus trabalhos de rotulagem de quadros de vídeo. Por exemplo, para uma tarefa de detecção de objetos de quadro de vídeo poligonal, escolha Se você não especificar um |
instructions |
Não |
Um objeto JSON Parâmetros necessários em cada objeto JSON:
|
Use esse parâmetro para adicionar instruções do operador para ajudar os operadores a concluir suas tarefas. Para obter mais informações sobre instruções do operador, consulte Instruções do operador. As instruções curtas devem ter menos de 255 caracteres e a instrução longa deve ter menos de 2.048 caracteres. Para obter mais informações, consulte Criar páginas de instrução. |
auditLabelAttributeName |
Necessário para tipos de tarefas de ajuste e verificação |
String |
Insira o LabelAttributeName usado no trabalho de rotulagem do qual deseja ajustar as anotações. Use esse parâmetro somente se estiver criando um trabalho de ajuste para quadro de vídeo e detecção de objeto de nuvem de pontos 3D ou segmentação semântica de nuvem de pontos 3D. |
Esquema de objetos de rótulos
A tabela a seguir descreve os parâmetros que você pode e deve usar para criar uma lista de Labels
. Cada parâmetro deve ser incluído em um objeto JSON.
Parâmetro | Obrigatório | Valores aceitos | Descrição |
---|---|---|---|
label |
Sim |
String |
O nome da categoria de rótulo que é exibida para os operadores. O nome de cada categoria de rótulo deve ser exclusivo. |
categoryAttributes |
Não |
Uma lista de objetos JSON. Parâmetros necessários em cada objeto JSON:
Parâmetros opcionais em cada objeto JSON:
|
Use esse parâmetro para adicionar atributos da categoria de rótulo a rótulos específicos determinados em Para adicionar um ou mais atributos de categoria de rótulo a um rótulo, inclua o objeto JSON |
editsAllowed |
Não |
String Valores compatíveis:
ou
|
Especifica se um rótulo pode ou não ser editado pelos operadores. Para trabalhos de rotulagem de ajuste de quadros de vídeo ou nuvem de pontos 3D, adicione esse parâmetro a um ou mais objetos JSON na lista Para trabalhos de rotulagem de nuvem de pontos 3D e verificação de quadros de vídeo, adicione esse parâmetro com o valor |
Esquema frameAttributes e categoryGlobalAttributes
A tabela a seguir descreve os parâmetros que você pode e deve usar para criar atributos de quadro usando frameAttributes
e atributo de categoria de rótulo usando os parâmetros categoryGlobalAttributes
e categoryAttributes
.
Parâmetro |
Obrigatório |
Valores aceitos |
Descrição |
---|---|---|---|
name |
Sim |
String |
Use esse parâmetro para atribuir um nome ao atributo da categoria de rótulo ou quadro. Esse é o nome de atributo que os operadores veem. Cada nome de atributo de categoria de rótulo em seu arquivo de configuração de categoria de rótulo deve ser exclusivo. Os atributos globais da categoria do rótulo e os atributos específicos da categoria do rótulo não podem ter o mesmo nome. |
type |
Sim |
String Valores obrigatórios:
|
Use esse parâmetro para definir o tipo de atributo da categoria de rótulo ou quadro. Se você especificar Se você especificar Se você especificar |
enum |
Não |
Lista de strings |
Use esse parâmetro para definir opções que os operadores podem escolher para essa categoria de rótulo ou atributo de quadro. Os operadores podem escolher um valor especificado em Você deve especificar |
description |
|
String |
Use esse parâmetro para adicionar uma descrição da categoria de rótulo ou atributo de quadro. Você pode usar esse campo para fornecer aos operadores mais informações sobre o atributo. Esse campo só é obrigatório para atributos de quadro. |
minimum e maximum |
Necessário se o atributo type for "number" |
Números inteiros |
Use esses parâmetros para especificar valores mínimos e máximos (inclusivos) que os operadores podem inserir para categoria de rótulo ou atributos de quadro numéricos. Você deve especificar |
editsAllowed |
Não |
String Valores obrigatórios:
ou
|
Especifica se uma categoria de rótulo ou atributo de quadro pode ou não ser editado pelos operadores. Para trabalhos de ajuste e rotulagem de verificação de quadros de vídeo ou nuvem de pontos 3D, adicione esse parâmetro aos objetos JSON de categoria de rótulo e atributo de quadro para especificar se um operador pode ou não editar um atributo. |
isRequired |
Não |
Booleano |
Especifica se os operadores precisam anotar um atributo. Os operadores não podem enviar o trabalho até que todos os atributos necessários sejam anotados. |
Cotas de rótulo e de atributo da categoria de rótulo
É possível especificar até 10 atributos da categoria de rótulo por classe. Essas cotas de 10 atributos incluem atributos da categoria de rótulo global. Por exemplo, se você criar quatro atributos da categoria de rótulo global e, depois, atribuir três atributos da categoria de rótulo ao rótulo X
, esse rótulo terá 4+3=7 atributos da categoria de rótulo no total. Para todas as categorias de rótulo e todos os limites de atributo da categoria de rótulo, consulte a tabela a seguir.
Tipo |
Mín. |
Máx |
---|---|---|
Rótulos ( |
1 |
30 |
Quota de caracteres do nome do rótulo |
1 |
16 |
Atributos da categoria de rótulo por rótulo (soma de |
0 |
10 |
Atributos da categoria da rótulo de entrada de texto em formato livre por rótulo (soma de |
0 | 5 |
Atributos de quadro |
0 |
10 |
Atributos de entrada de texto em formato livre em |
0 | 5 |
Quota de caracteres do nome do atributo ( |
1 |
16 |
Quota de caracteres da descrição do atributo ( |
0 |
128 |
Quota de caracteres do tipo de atributo ( |
1 |
16 |
Valores permitidos na lista |
1 | 10 |
Cota de caracteres para um valor na lista |
1 | 16 |
Máximo de caracteres na resposta de texto de formato livre para texto de formato livre frameAttributes |
0 | 1000 |
Máximo de caracteres na resposta de texto de formato livre para texto de formato livre categoryAttributes e categoryGlobalAttributes |
0 | 80 |