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["Shape set by the dataset task"]
        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 fornece ferramentas de anotação para 6 tipos de tarefas YOLO:

Depth ground truth é um mapa emparelhado que carregas, não algo que desenhas, por isso o editor abre apenas como leitura num dataset de profundidade.

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 padrão Draw, ou alterna para Smart onde 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 ecrã inteiro abre no computador. Não existe um modo de edição separado ou um botão Edit. No telemóvel, e quando não tens acesso de edição, o visualizador em ecrã inteiro é 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 detect, segment, semantic e OBB, a barra de ferramentas também fornece o modo Smart quando a anotação inteligente está disponível:

A anotação de pose usa Draw com um modelo de esqueleto — o botão Smart aparece mas fica desativado e marcado como "Em breve". A classificação usa a barra lateral de classes diretamente e não exibe nenhuma barra de ferramentas de desenho ou botão Smart.

A anotação inteligente não está disponível no momento para conjuntos de dados conectados com suporte de armazenamento em nuvem ou On Premise.

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 padrão Draw, 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 padrão Draw, clica para adicionar vértices, ou segura Shift e move o rato para desenhar pontos densos à mão livre
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 padrão Draw, escolhe um modelo de esqueleto no 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

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 padrão Draw, 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 auxiliada por modelo ao editor. No modo inteligente, podes usar o Segment Anything Model (SAM) para anotação baseada em cliques ou usar modelos Ultralytics YOLO pré-treinados e os teus próprios modelos YOLO afinados para adicionar predições como anotações. A anotação inteligente está disponível para as tarefas 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. Prime Enter ou Escape para guardar a anotação, ou ativa a aplicação automática para fluxos de trabalho com 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 ao guardar automaticamente a máscara SAM após cada clique — sem necessidade de premir Enter. Alterna-o com o botão de aplicação automática na barra de ferramentas ou prime 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:

Alternar de modelos enquanto o modo inteligente 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. Seleciona 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: Filtra a lista de classes escrevendo no campo de pesquisa. Prime Enter numa correspondência exata para selecioná-la, ou cria uma nova classe se não existir nenhuma correspondência.
• Criar nova classe inline: Clica em Add class na parte inferior da lista, escreve um nome e opcionalmente escolhe uma cor personalizada. Prime 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 uma classe inteira: Clica no ícone de olho em uma linha de classe para ocultar ou mostrar todas as anotações dessa classe de uma só vez.
• 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: Pressiona 1-9 para selecionar rapidamente as primeiras 9 classes, ou H para alternar a visibilidade de todas as anotações na imagem.

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
• Eliminar vértices: Seleciona um vértice e prime Delete para removê-lo

Gerenciamento de classes#

Criando classes#

Define classes de anotação para o teu conjunto de dados no separador Classes:

1. Navega até ao separador Classes
2. Use o campo de entrada na parte inferior para digitar um nome de classe
3. Clica em Add ou prime 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, clica em Add class (ou escreve 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 Ultralytics. Podes personalizar cores usando o seletor de cores no separador Classes; as cores selecionadas são usadas 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 guardar ou prime Cmd/Ctrl+S
• Fechar: Clica no botão fechar, clica fora da imagem ou prime Escape; fechar aciona um salvamento em segundo plano para alterações pendentes

FAQ#