Editor de Anotações#

A Ultralytics Platform inclui um editor de anotações para etiquetar imagens com caixas delimitadoras, polígonos, pontos-chave, caixas orientadas e classificações. O editor suporta desenho manual, anotação inteligente com tecnologia SAM e previsõ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:

A verdade de referência de profundidade é um mapa emparelhado que carregas, não algo que desenhas, por isso o editor abre no modo somente leitura num conjunto de dados de profundidade.

Detalhes da tarefa#

Introdução#

Para anotar imagens:

1. Navega até ao teu conjunto de dados
2. Clica uma vez numa imagem para abrir o editor de anotações em ecrã inteiro
3. Usa o modo predefinido Draw ou muda para Smart quando disponível
4. Seleciona uma classe e adiciona ou ajusta anotações diretamente na imagem
5. Avança para outra imagem ou fecha o editor; as alterações são guardadas automaticamente após cada edição

Nos conjuntos de dados que podes editar, os controlos de anotação ficam ativos assim que o visualizador em ecrã inteiro é aberto no computador. Não existe um modo de edição separado nem um botão Edit. No telemóvel, e quando não tens acesso de edição, o visualizador em ecrã inteiro é somente 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 detecção, segmentação, semântica, pose 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; seu modo Smart oferece apenas modelos de pose YOLO, sem seletor SAM ou botão de aplicação automática. 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á atualmente disponível para conjuntos de dados ligados com armazenamento na nuvem ou On Premise.

Ferramentas do modo Desenhar#

Caixa delimitadora (Deteção)#

Desenha caixas retangulares à volta dos objetos:

1. Seleciona uma classe na barra lateral de classes
2. No modo predefinido Draw, clica e arrasta para desenhar um retângulo
3. Solta para concluir a caixa

Polígono (Segmentação)#

Desenha máscaras poligonais precisas:

1. Seleciona uma classe na barra lateral de classes
2. No modo predefinido Draw, clica para adicionar vértices ou mantém Shift premido 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)#

Anota poses usando modelos de esqueleto. Seleciona um modelo na barra de ferramentas, clica uma vez para posicionar todos os pontos-chave e, em seguida, arrasta pontos-chave individuais para ajustar as posições.

1. Seleciona uma classe na barra lateral de classes
2. No modo predefinido Draw, escolhe um modelo de esqueleto no seletor de modelos da barra de ferramentas
3. Clica na imagem para posicionar todos os pontos-chave de uma só vez
4. Arrasta pontos-chave individuais para ajustar as respetivas posições

Modelos de esqueleto integrados#

O editor inclui 5 modelos integrados:

Modelos personalizados de esqueleto#

Cria modelos personalizados para qualquer estrutura de pose:

1. Clica no botão + junto ao seletor de modelos
2. Opcionalmente, clica em Começar a partir de... para carregar pontos-chave e ligações de um modelo existente como ponto de partida
3. Coloca pontos-chave na tela clicando
4. Atribui um nome a cada ponto-chave e personaliza as cores
5. Liga pontos-chave selecionando dois pontos (as ligações são desenhadas automaticamente à medida que colocas pontos-chave sequenciais)
6. Guarda o modelo para o reutilizares em todo o teu conjunto de dados

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

Caixa delimitadora orientada (OBB)#

Desenha caixas rodadas para objetos inclinados:

1. Seleciona uma classe na barra lateral de classes
2. No modo predefinido Draw, clica e arrasta para desenhar uma caixa inicial
3. Usa a alça de rotação para ajustar o ângulo
4. Arrasta as alças dos cantos para redimensionar

Classificação (Classify)#

Atribui etiquetas de classe ao nível da imagem:

1. Clica numa imagem para abrir o editor em ecrã inteiro
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 Segment Anything Model (SAM) para anotação baseada em cliques ou usar modelos YOLO pré-treinados da Ultralytics e os teus próprios modelos YOLO ajustados para adicionar predições como anotações. A anotação inteligente SAM está disponível para as tarefas detect, segment, semantic e OBB; a anotação inteligente YOLO também cobre pose.

Anotação inteligente com SAM#

Com um modelo SAM selecionado:

1. Seleciona Smart ou prime S
2. Clica no objeto que queres anotar — o SAM gera uma máscara inicial em tempo real
3. Refina a máscara com cliques adicionais: clica fora da máscara atual para adicionar cobertura ou clica dentro da máscara atual para subtrair regiões
4. Prime Enter ou Escape para guardares a anotação ou ativa auto-apply 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 com SAM pode gerar:

• Polígonos para tarefas de segmentação
• Caixas delimitadoras para tarefas de deteção
• Caixas orientadas para tarefas OBB

Modo de aplicação automática#

O modo de aplicação automática acelera a anotação inteligente ao guardar automaticamente a máscara SAM após cada clique — não é necessário premir Enter. Alterna-o com o botão de aplicação automática na barra de ferramentas ou prime A.

Seleção do modelo SAM#

Quando o modo Inteligente está ativo, um seletor de modelo aparece na barra de ferramentas. Seis modelos SAM estão disponíveis — escolhe com base no compromisso entre velocidade e precisão que melhor se adapta ao teu conjunto de dados:

A troca de modelos enquanto o modo inteligente está ativo reinicializa o preditor para a imagem atual automaticamente.

Anotação inteligente com YOLO#

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

1. Seleciona Smart ou prime S
2. Seleciona um modelo YOLO no seletor de modelos da barra de ferramentas (Official ou My Models)
3. Clica em Predict
4. Revê as anotações adicionadas e faz as correções necessárias

Anotação em Lote#

A anotação em lote executa um modelo YOLO em todo um conjunto de dados em vez da imagem aberta. Abre-a a partir da página do conjunto de dados com Mais ações > Anotação em Lote, ou a partir da ação Inferência em Tudo no alerta após uma predição YOLO no editor. Está disponível para editores de conjuntos de dados em conjuntos de dados hospedados na plataforma com até três canais de imagem, para todas as tarefas, exceto profundidade.

1. Seleciona um modelo a partir do seletor (Official ou My Models)
2. Ajusta os controles deslizantes de confiança (padrão 0.25) e IoU (padrão 0.7) — a faixa de Execução de teste mostra o que o modelo encontra em algumas imagens de exemplo à medida que os moves
3. Ativa Incluir imagens anotadas para executar também sobre imagens que já possuem rótulos; a execução adiciona o que o modelo encontra e mantém os rótulos que já possuem
4. Revisa o Custo Estimado e clica em Iniciar

Por padrão, apenas imagens não anotadas são anotadas e os rótulos existentes nunca são alterados. Uma execução precisa de classes de conjuntos de dados. Se as classes do modelo diferirem das do conjunto de dados, uma etapa de Mapear classes mapeia cada classe do modelo para uma classe do conjunto de dados ou a ignora, e em um conjunto de dados sem classes, ela as cria — a execução é iniciada apenas após a existência das classes. Iniciar uma execução salva primeiro uma versão do conjunto de dados, para que possas restaurar o conjunto de dados se não gostares do resultado.

A página do conjunto de dados mostra o progresso da execução, e Parar mantém e cobra as imagens processadas até o momento. Quando a execução termina, um resumo mostra as imagens processadas e as anotações e classes adicionadas.

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 a selecionar ou cria uma nova classe se não existir nenhuma correspondência.
• Criar uma nova classe em linha: Clica em Add class na parte inferior da lista, escreve um nome e, opcionalmente, escolhe uma cor personalizada. Prime Enter para criar.
• Editar o nome da classe em linha: Passa o cursor sobre um nome de classe e clica no ícone do lápis para o renomear.
• Seletor de cores: Clica na amostra de cor junto a qualquer classe para alterar a sua cor.
• Contagem de anotações por classe: Cada linha de classe apresenta uma contagem em sobrescrito das anotações.
• Expandir/recolher: Clica no chevron para expandir uma classe e ver as anotações individuais listadas abaixo dela.
• Realce bidirecional ao passar o cursor: Passar o cursor sobre uma anotação na tela realça-a na barra lateral e vice-versa. A barra lateral desloca-se automaticamente até à classe relevante.
• Ocultar/mostrar uma classe inteira: Clica no ícone do olho numa linha de classe para ocultar ou mostrar simultaneamente todas as anotações dessa classe.
• Ocultar/mostrar anotações individuais: Clica no ícone do olho em qualquer linha de anotação para alternar a sua visibilidade na tela.
• Eliminar anotações: Clica no ícone do caixote do lixo em qualquer linha de anotação para a eliminar.
• Atalhos de teclado: Prime 1-9 para selecionares rapidamente as primeiras 9 classes ou H para alternares a visibilidade de todas as anotações da imagem.

Menu de contexto#

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

Controlos de visibilidade#

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

Cursor em forma de mira#

Durante a anotação, uma sobreposição em forma de mira acompanha a posição do cursor e apresenta as coordenadas dos pixels na tela. Isso ajuda a posicionar as anotações com precisão. Ative ou desative essa opção no menu pendente de visibilidade.

Pré-visualização ao passar o cursor com SAM#

No modo Smart, o SAM fornece uma pré-visualização em tempo real ao passar o cursor, antes de clicares em qualquer ponto. Esta pré-visualização está disponível para as tarefas detect, segment, semantic e OBB. Depois de adicionares 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 dos vértices do polígono#

Para anotações de segmentação, podes editar os vértices do polígono depois de o desenhar:

• Mover vértices: Arrasta qualquer marcador de vértice para o reposicionar
• Eliminar vértices: Seleciona um vértice e prime Delete para o remover

Gestão de classes#

Criar classes#

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

1. Navega até ao separador Classes
2. Utiliza o campo de entrada na parte inferior para escrever o nome de uma classe
3. Clica em Add ou prime Enter
4. É atribuída automaticamente uma cor da paleta da Ultralytics

Adicionar uma nova classe durante a anotação#

Podes criar novas classes diretamente durante a anotação, sem sair do editor:

1. Desenha 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. Introduz o nome da classe
4. Prime Enter para criar e atribuir

Isto permite um fluxo de trabalho contínuo, no qual podes definir classes à medida que encontras novos tipos de objetos nos teus dados.

Editar classes#

• Mudar o nome: Clica no nome de uma classe na tabela para o editar diretamente
• Alterar a cor: Clica na amostra de cor para abrir o seletor de cores
• Pesquisar: Utiliza o campo de pesquisa para filtrar as classes pelo nome
• Ordenar: Clica nos cabeçalhos das colunas para ordenar por índice, nome, número de anotações ou número de imagens

Cores das classes#

É atribuída a cada classe uma cor da paleta da Ultralytics. Podes personalizar as cores utilizando o seletor de cores no separador Classes; as cores selecionadas são utilizadas em todo o 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 ações de desfazer/refazer:

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

O histórico regista:

• Adicionar anotações (individuais e em lote)
• Editar anotações (mover, redimensionar, rodar)
• Eliminar anotações (individuais e em lote)
• Alterar classes (individualmente e em lote)
• Reordenar anotações (ordem Z)
• Editar vértices de polígonos (adicionar, remover, mover)
• Mover pontos-chave

Guardar anotações#

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

• 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; fechar ativa uma gravação em segundo plano das alterações pendentes

Perguntas frequentes#