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á.
Criar um arquivo de configuração de categoria de rotulagem com atributos de categoria e quadro de rótulo
Ao criar um trabalho de rotulagem de nuvem de pontos 3D ou quadro de vídeo usando a operação de SageMaker API da AmazonCreateLabelingJob
, você usa um arquivo de configuração de categoria de etiqueta para especificar suas etiquetas e instruções de trabalho. 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 trabalhadores 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 trabalhadores 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, polilinha, polígono ou ponto-chave) enviada aos trabalhadores.
Para trabalhadores, 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 LabelAttributeNameusado no trabalho de etiquetagem que gerou as anotações que você deseja que seu trabalhador ajuste. Quando você cria um trabalho de rotulagem no console, se você não especificou um nome de atributo de rótulo, o nome do seu trabalho é usado como LabelAttributeName o.
Tópicos
Esquema do arquivo de configuração da categoria de rótulo
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ó é suportado para 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 (suportado somente para 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 ter mais informações, consulte Criar instruções do operador. |
auditLabelAttributeName |
Necessário para tipos de tarefas de ajuste e verificação |
String |
Insira o LabelAttributeNameusado na tarefa de etiquetagem da qual você 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. |
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 trabalhadores. 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 com suporte:
ou
|
Especifica se um rótulo pode ou não ser editado pelos trabalhadores. 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 |
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 trabalhadores 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 trabalhadores 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 trabalhadores. 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 trabalhador pode ou não editar um atributo. |
isRequired |
Não |
Booleano |
Especifica se os trabalhadores precisam anotar um atributo. Os trabalhadores 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 |
Exemplo: arquivos de configuração de categoria de rotulagem para trabalhos de rotulagem de nuvem de pontos 3D
Selecione uma guia nas tabelas a seguir para ver exemplos de arquivos de configuração de categorias de rótulos de nuvem de pontos 3D para tarefas de detecção, rastreamento de objetos, segmentação semântica, ajuste e verificação de rotulagem.
Selecione uma guia na tabela a seguir para ver um exemplo de um arquivo de configuração de categoria de rótulo para trabalhos de verificação ou ajuste de nuvem de pontos 3D.
Exemplo: arquivos de configuração de categoria de rótulo 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.
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>
"} }
Selecione uma guia da tabela a seguir para ver exemplos de arquivos de configuração de categoria de rótulo para trabalhos de verificação e ajuste de quadro de vídeo.
Criar instruções do operador
Crie instruções personalizadas para rotular trabalhos para melhorar a precisão do seu trabalhador ao concluir sua tarefa. As instruções ficam acessíveis quando os operadores selecionam a opção de menu Instruções na interface do usuário do operador. As instruções curtas devem ter menos de 255 caracteres e a instrução longa deve ter menos de 2.048 caracteres.
Existem dois tipos de instruções:
-
Instruções curtas – essas instruções são mostradas aos operadores quando eles selecionam Instruções no menu da interface do usuário do operador. Elas devem fornecer uma referência fácil para mostrar ao operador a maneira correta de rotular um objeto.
-
Instruções completas – essas instruções são mostradas quando os operadores selecionam Mais instruções nas instruções da janela pop-up. Recomendamos que você forneça instruções detalhadas para concluir a tarefa com vários exemplos mostrando casos extremos e outras situações difíceis para rotular objetos.
Para trabalhos de rotulagem de nuvem de pontos 3D e quadro de vídeo, é possível adicionar instruções do operador ao arquivo de configuração da categoria de rótulo. Você pode usar uma única string para criar instruções ou pode adicionar uma marca HTML para personalizar a aparência das instruções e adicionar imagens. Verifique se todas as imagens incluídas nas instruções estão disponíveis publicamente ou se as instruções estão no Amazon S3, e se os operadores têm acesso de leitura para que possam visualizá-las.