Editor de Anotações#

Ultralytics Platform inclui um editor de anotação para rotular imagens com caixas delimitadoras, polígonos, pontos-chave, caixas orientadas e classificações. O editor suporta desenho manual, anotação inteligente potencializada por SAM e predições de modelos YOLO compatíveis.

graph TB
    subgraph Draw["Draw Mode"]
        A[Box]:::start & B[Polygon]:::start & C[Classify]:::start & D[Keypoint]:::start & E[OBB]:::start
    end
    subgraph AI["AI-Assisted"]
        F[SAM Smart]:::start
        G[YOLO Predict]:::start
    end
    Draw --> H[Save Labels]:::out
    AI --> H

    classDef start fill:#4CAF50,color:#fff
    classDef out fill:#9C27B0,color:#fff

Tipos de tarefas suportados#

O editor de anotações suporta todos os 6 tipos de tarefas YOLO:

Detalhes da Tarefa#

Começando#

Para anotar imagens:

1. Navegue até seu conjunto de dados
2. Clica uma vez numa imagem para abrir o editor de anotação em tela inteira
3. Usa o modo Draw padrão ou muda para Smart onde for suportado
4. Seleciona uma classe e adiciona ou ajusta anotações diretamente na imagem
5. Continua para outra imagem ou fecha o editor; as alterações são guardadas automaticamente após cada edição

Para conjuntos de dados que podes editar, os controlos de anotação ficam ativos assim que o visualizador em tela inteira abre no computador. Não existe um modo de edição separado ou um botão Edit. Em dispositivos móveis, e quando não tens acesso de edição, o visualizador em tela inteira é apenas de leitura.

graph LR
    A[Open Dataset]:::start --> B[Click Image]:::proc
    B --> C[Annotate in Fullscreen]:::proc
    C --> D[Changes Auto-Save]:::out
    D --> E[Next Image]:::proc
    E --> B

    classDef start fill:#4CAF50,color:#fff
    classDef proc fill:#2196F3,color:#fff
    classDef out fill:#9C27B0,color:#fff

Modos de Anotação#

Draw é o modo padrão para tarefas de anotação espacial. Para conjuntos de dados de deteção, segmentação, semântica e OBB, a barra de ferramentas também disponibiliza o modo Smart quando a anotação inteligente está disponível:

A anotação de pose utiliza Draw com um modelo de esqueleto. A classificação utiliza diretamente a barra lateral de classes e não mostra a barra de ferramentas de desenho.

A anotação inteligente não está atualmente disponível para conjuntos de dados ligados.

Ferramentas do Modo Draw#

Caixa Delimitadora (Detect)#

Desenhe caixas retangulares ao redor de objetos:

1. Seleciona uma classe na barra lateral de classes
2. No modo Draw padrão, clica e arrasta para desenhar um retângulo
3. Solte para completar a caixa

Polígono (Segment)#

Desenhe máscaras de polígono precisas:

1. Seleciona uma classe na barra lateral de classes
2. No modo Draw padrão, clica para adicionar vértices, ou segura Shift e move o rato para desenhar à mão livre pontos densos
3. Faz duplo clique, clica no primeiro vértice ou prime Enter ou Escape para fechar o polígono

Ponto-chave (Pose)#

Anote poses usando modelos de esqueleto. Selecione um modelo na barra de ferramentas, clique uma vez para posicionar todos os pontos-chave e, em seguida, arraste pontos-chave individuais para ajustar as posições.

1. Seleciona uma classe na barra lateral de classes
2. No modo Draw padrão, escolhe um modelo de esqueleto a partir do seletor de modelos na barra de ferramentas
3. Clique na imagem para posicionar todos os pontos-chave de uma vez
4. Arraste pontos-chave individuais para ajustar suas posições

Modelos de Esqueleto Integrados#

O editor inclui 5 modelos integrados:

Modelos de Esqueleto Personalizados#

Crie modelos personalizados para qualquer estrutura de pose:

1. Clique no botão + ao lado do seletor de modelos
2. Opcionalmente, clique em Start from... para carregar keypoints e conexões de um modelo existente como ponto de partida
3. Coloque os keypoints na tela clicando
4. Nomeie cada keypoint e personalize as cores
5. Conecte os keypoints selecionando dois pontos (as conexões são desenhadas automaticamente à medida que você coloca os keypoints sequencialmente)
6. Salve o modelo para reutilização em todo o seu conjunto de dados

Os modelos personalizados são guardados na tua conta e ficam disponíveis em todos os conjuntos de dados de pose.

Caixa Delimitadora Orientada (OBB)#

Desenhe caixas rotacionadas para objetos inclinados:

1. Seleciona uma classe na barra lateral de classes
2. No modo Draw padrão, clica e arrasta para desenhar uma caixa inicial
3. Use a alça de rotação para ajustar o ângulo
4. Arraste as alças de canto para redimensionar

Classificação (Classify)#

Atribua rótulos de classe em nível de imagem:

1. Clica numa imagem para abrir o editor em tela inteira
2. Seleciona uma classe na barra lateral de classes, ou prime uma tecla numérica de 1-9

Anotação Inteligente#

A anotação inteligente adiciona anotação assistida por modelo ao editor. No modo Inteligente, podes usar o Segment Anything Model (SAM) para anotação baseada em cliques ou usar modelos YOLO da Ultralytics pré-treinados e os teus próprios modelos YOLO ajustados para adicionar previsões como anotações. A anotação inteligente está disponível para tarefas de detect, segment, semantic e OBB.

Anotação Inteligente SAM#

Com um modelo SAM selecionado:

1. Seleciona Smart ou prime S
2. Clique no objeto que você deseja anotar — o SAM gera uma máscara inicial em tempo real
3. Refine a máscara com cliques adicionais: clique fora da máscara atual para adicionar cobertura ou clique dentro da máscara atual para subtrair regiões
4. Pressione Enter ou Escape para salvar a anotação, ou habilite auto-apply para fluxos de trabalho de um clique

graph LR
    A[Press S]:::start --> B[Left-click Object]:::proc
    B --> C[SAM Generates Mask]:::proc
    C --> D{Auto-apply?}:::decide
    D -->|Yes| E[Mask Applied Automatically]:::out
    D -->|No| F{Accurate?}:::decide
    F -->|Yes| G[Enter to Save]:::out
    F -->|No| H[Add +/- Points]:::proc
    H --> C

    classDef start fill:#4CAF50,color:#fff
    classDef proc fill:#2196F3,color:#fff
    classDef decide fill:#FF9800,color:#fff
    classDef out fill:#9C27B0,color:#fff

A anotação inteligente SAM pode gerar:

• Polígonos para tarefas de segmentação
• Bounding boxes para tarefas de detecção
• Caixas orientadas para tarefas de OBB

Modo de Aplicação Automática (Auto-Apply)#

O modo de aplicação automática acelera a anotação Inteligente salvando automaticamente a máscara SAM após cada clique — não há necessidade de pressionar Enter. Alterne-o com o botão de auto-apply na barra de ferramentas ou pressione A.

Seleção de Modelo SAM#

Quando o modo Inteligente está ativo, um seletor de modelos aparece na barra de ferramentas. Cinco modelos SAM estão disponíveis — escolha com base no equilíbrio entre velocidade e precisão que se adapta ao seu conjunto de dados:

Mudar de modelo enquanto o modo Smart está ativo reinicializa automaticamente o preditor para a imagem atual.

Anotação Inteligente YOLO#

Com um modelo YOLO selecionado, a anotação inteligente pode adicionar predições de modelos Ultralytics pré-treinados ou seus próprios modelos ajustados.

1. Seleciona Smart ou prime S
2. Selecione um modelo YOLO no seletor de modelos na barra de ferramentas (Official ou My Models)
3. Clique em Predict
4. Revise as anotações adicionadas e faça as correções necessárias

Barra lateral de classes#

O editor de anotações inclui uma barra lateral de classes recolhível no lado direito da tela. A barra lateral fornece:

• Pesquisar classes: Filtre a lista de classes digitando no campo de pesquisa. Pressione Enter em uma correspondência exata para selecioná-la, ou crie uma nova classe se não houver correspondência.
• Criar nova classe inline: Clique em Add class na parte inferior da lista, digite um nome e opcionalmente escolha uma cor personalizada. Pressione Enter para criar.
• Editar nome da classe inline: Passe o mouse sobre um nome de classe e clique no ícone de lápis para renomeá-lo.
• Seletor de cores: Clique na amostra de cor ao lado de qualquer classe para alterar sua cor.
• Contagem de anotações por classe: Cada linha de classe mostra uma contagem sobrescrita de anotações.
• Expandir/recolher: Clique no chevron para expandir uma classe e ver as anotações individuais listadas abaixo dela.
• Destaque bidirecional ao passar o mouse: Passar o mouse sobre uma anotação na tela a destaca na barra lateral, e vice-versa. A barra lateral rola automaticamente para a classe relevante.
• Ocultar/mostrar anotações individuais: Clique no ícone de olho em qualquer linha de anotação para alternar sua visibilidade na tela.
• Excluir anotações: Clique no ícone de lixeira em qualquer linha de anotação para excluí-la.
• Atalhos de teclado: Pressione 1-9 para selecionar rapidamente as primeiras 9 classes.

Menu de contexto#

Clique com o botão direito em anotações selecionadas para abrir um menu de contexto com:

Controles de visibilidade#

O menu suspenso de visibilidade (ícone de olho) permite alternar a exibição de elementos individuais:

Cursor de retícula#

Durante a anotação, uma sobreposição de mira acompanha a posição do cursor e apresenta as coordenadas de píxeis na tela. Isto ajuda a colocar anotações com precisão. Alterna esta opção através do menu pendente de visibilidade.

Pré-visualização ao passar o mouse SAM#

No modo inteligente, o SAM fornece uma pré-visualização em tempo real ao passar o mouse antes de clicar em qualquer ponto. Esta pré-visualização está disponível para tarefas de detect, segment, semantic e OBB. Depois de adicionar cliques de refinamento, a pré-visualização é atualizada para refletir a máscara atual e o tipo de anotação da tarefa ativa.

Edição de vértice de polígono#

Para anotações de segmentação, você pode editar vértices de polígono após o desenho:

• Mover vértices: Arraste qualquer alça de vértice para reposicioná-lo
• Excluir vértices: Selecione um vértice e pressione Delete para removê-lo

Gerenciamento de classes#

Criando classes#

Defina classes de anotação para seu conjunto de dados na aba Classes:

1. Navegue até a aba Classes
2. Use o campo de entrada na parte inferior para digitar um nome de classe
3. Clique em Add ou pressione Enter
4. Uma cor é atribuída automaticamente a partir da paleta Ultralytics

Adicionar nova classe durante a anotação#

Você pode criar novas classes diretamente enquanto anota, sem sair do editor:

1. Desenhe uma anotação na imagem
2. Na barra lateral de classes, clique em Add class (ou digite um novo nome na caixa de pesquisa da barra lateral)
3. Insira o nome da classe
4. Pressione Enter para criar e atribuir

Isso permite um fluxo de trabalho contínuo onde você pode definir classes conforme encontra novos tipos de objetos em seus dados.

Editando classes#

• Renomear: Clique em um nome de classe na tabela para editá-lo inline
• Alterar cor: Clique na amostra de cor para abrir o seletor de cores
• Pesquisar: Use o campo de pesquisa para filtrar classes por nome
• Classificar: Clique nos cabeçalhos das colunas para classificar por índice, nome, contagem de anotações ou contagem de imagens

Cores das classes#

A cada classe é atribuída uma cor da paleta do Ultralytics. Podes personalizar as cores utilizando o seletor de cores no separador Classes; as cores selecionadas são utilizadas em todo esse conjunto de dados.

Atalhos de teclado#

Anotação eficiente com atalhos de teclado:

Desfazer/Refazer#

O editor de anotações mantém um histórico completo de desfazer/refazer:

• Desfazer: Cmd/Ctrl+Z
• Refazer: Cmd/Ctrl+Y

O histórico rastreia:

• Adição de anotações (individual e em lote)
• Edição de anotações (mover, redimensionar, rotacionar)
• Exclusão de anotações (individual e em lote)
• Mudança de classes (individual e em lote)
• Reordenação de anotações (ordem z)
• Edição de vértices de polígono (adicionar, remover, mover)
• Movimentação de pontos-chave

Salvando anotações#

As alterações são guardadas automaticamente um segundo após a última edição de anotação. Também são guardadas quando mudas para outra imagem ou fechas o editor em tela inteira.

• Guardar agora: Clica no botão de guardar ou prime Cmd/Ctrl+S
• Fechar: Clica no botão de fechar, clica fora da imagem ou prime Escape; o fecho aciona um salvamento em segundo plano para as alterações pendentes

FAQ#

Qual é a precisão da anotação SAM?#

O SAM fornece máscaras de alta qualidade para a maioria dos objetos. A precisão depende de:

• Distinção do objeto em relação ao fundo
• Qualidade e resolução da imagem
• Número de pontos positivos/negativos fornecidos

Para melhores resultados, comece com um clique no centro do objeto, depois use cliques fora da máscara para adicionar cobertura e cliques dentro da máscara para subtrair objetos próximos ou fundo.

Posso importar anotações existentes?#

Sim, faça upload do seu conjunto de dados com arquivos de rótulo no formato YOLO. A Platform os analisa e exibe automaticamente no editor.

Como anoto vários objetos da mesma classe?#

Após desenhar uma anotação:

1. Mantenha a mesma classe selecionada
2. Desenhe a próxima anotação
3. Repita até que todos os objetos estejam rotulados

O atalho de teclado 1-9 seleciona classes rapidamente.

Posso treinar com conjuntos de dados parcialmente anotados?#

Sim, mas para melhores resultados:

• Rotule todos os objetos de suas classes alvo em cada imagem
• Use o filtro Annotations definido como Unannotated para identificar imagens que ainda precisam de anotação

Qual modelo SAM devo usar?#

SAM 3 é o padrão e o modelo de última geração — comece por ele para obter máscaras de maior qualidade. Mude para SAM 2.1 Small para um fluxo de trabalho interativo mais rápido em objetos comuns, ou SAM 2.1 Large quando precisar de maior precisão de máscara em formas complexas. Use SAM 2.1 Tiny para velocidade máxima em objetos simples de alto contraste.

Quais tarefas suportam a anotação inteligente SAM?#

A anotação inteligente SAM está disponível para tarefas de detect, segment, semantic e OBB. As tarefas de classificação e pose usam apenas anotação manual.

Posso criar modelos de esqueleto personalizados para anotação de pose?#

Sim. Clique no botão + ao lado do seletor de modelo de esqueleto para abrir o editor de modelos. Coloque pontos-chave, nomeie-os, desenhe conexões e salve. Modelos personalizados são armazenados em sua conta e estão disponíveis em todos os conjuntos de dados de pose.

Como alternar entre modelos de esqueleto?#

Clique no menu suspenso do seletor de modelos na barra de ferramentas de anotação. Selecione qualquer modelo integrado (Pessoa, Mão, Rosto, Cachorro, Caixa) ou seus modelos personalizados salvos. O modelo selecionado determina quais pontos-chave são colocados quando você clica na imagem.