Editor de Anotação

A Ultralytics Platform inclui um poderoso editor de anotação para rotular imagens com caixas delimitadoras (bounding boxes), polígonos, keypoints, caixas orientadas e classificações. O editor oferece suporte a desenho manual e anotação inteligente via SAM.

graph TB
    subgraph Manual["Manual Tools"]
        A[Box] & B[Polygon] & C[Keypoint] & D[OBB] & E[Classify]
    end
    subgraph AI["AI-Assisted"]
        F[SAM Smart]
    end
    Manual --> H[Save Labels]
    AI --> H

Tipos de Tarefas Suportadas

O editor de anotação oferece suporte a todos os 5 tipos de tarefas YOLO:

Detalhes da Tarefa

Primeiros passos

Para anotar imagens:

1. Navegue até seu conjunto de dados
2. Clique em uma imagem para abrir o visualizador em tela cheia
3. Clique em Edit para entrar no modo de anotação
4. Selecione sua ferramenta de anotação na barra de ferramentas
5. Desenhe as anotações na imagem
6. Clique em Save quando terminar

graph LR
    A[Open Dataset] --> B[Click Image]
    B --> C[Click Edit]
    C --> D[Draw Annotations]
    D --> E[Save]
    E --> F[Next Image]
    F --> B

    style C fill:#2196F3,color:#fff
    style D fill:#FF9800,color:#fff
    style E fill:#4CAF50,color:#fff

Modos de Anotação

O editor oferece dois modos de anotação, selecionáveis na barra de ferramentas:

Ferramentas de Anotação Manual

Caixa Delimitadora (Detecção)

Desenhe caixas retangulares ao redor dos objetos:

1. Entre no modo de edição e selecione Draw
2. Clique e arraste para desenhar um retângulo
3. Solte para concluir a caixa
4. Selecione uma classe no menu suspenso

Polígono (Segmentação)

Desenhe máscaras de polígono precisas:

1. Entre no modo de edição e selecione Draw
2. Clique para adicionar vértices, ou segure Shift e mova o mouse para desenhar pontos densos à mão livre
3. Clique no primeiro vértice, ou pressione Enter ou Escape para fechar o polígono
4. Selecione uma classe no menu suspenso

Keypoint (Pose)

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

1. Entre no modo de edição e selecione Draw
2. Escolha um modelo de esqueleto no seletor de modelos na barra de ferramentas

3. Clique na imagem para posicionar todos os keypoints de uma vez
4. Arraste keypoints individuais para ajustar suas posições
5. Pressione Enter para confirmar ou Escape para cancelar

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... (Começar a partir de...) para carregar pontos-chave e conexões de um modelo existente como ponto de partida
3. Coloque pontos-chave na tela clicando
4. Nomeie cada ponto-chave e personalize as cores
5. Conecte os pontos-chave selecionando dois pontos (as conexões são desenhadas automaticamente conforme você coloca pontos-chave sequenciais)
6. Salve o modelo para reutilização em todo o seu conjunto de dados

Modelos personalizados são salvos em sua conta e estão disponíveis em todos os conjuntos de dados de pose.

Caixa Delimitadora Orientada (OBB)

Desenhe caixas rotacionadas para objetos angulados:

1. Entre no modo de edição e selecione Draw
2. Clique e arraste para desenhar uma caixa inicial
3. Use a alça de rotação para ajustar o ângulo
4. Arraste as alças dos cantos para redimensionar
5. Selecione uma classe no menu suspenso

Classificação (Classify)

Atribua rótulos de classe no nível da imagem:

1. Entre no modo de edição
2. Um painel lateral aparece com botões de seleção de classe
3. Clique nos botões de classe ou pressione as teclas numéricas 1-9

Anotação Inteligente

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

Anotação Inteligente SAM

Com um modelo SAM selecionado:

1. Entre no modo de edição e selecione Smart (Inteligente) ou pressione 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 ative auto-apply (aplicação automática) para fluxos de trabalho de um clique

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

    style A fill:#2196F3,color:#fff
    style C fill:#FF9800,color:#fff
    style E fill:#4CAF50,color:#fff
    style G fill:#4CAF50,color:#fff

A anotação inteligente SAM pode gerar:

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

Modo de Aplicação Automática

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 aplicação automática na barra de ferramentas ou pressione A.

Seleção de modelo SAM

Quando o modo Inteligente está ativo, um seletor de modelo 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:

Trocar modelos enquanto o modo Inteligente está ativo reinicializa o preditor para a imagem atual automaticamente.

Anotação Inteligente YOLO

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

1. Entre no modo de edição e selecione Smart (Inteligente) ou pressione S
2. Selecione um modelo YOLO no seletor de modelos na barra de ferramentas (Official ou My Models)
3. Clique em Predict (Prever)
4. Revise as anotações adicionadas e faça as correções necessárias

Barra lateral de classes

O editor de anotação 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 em linha: Clique em Add class (Adicionar classe) na parte inferior da lista, digite um nome e, opcionalmente, escolha uma cor personalizada. Pressione Enter para criar.
• Editar nome da classe em linha: Passe o mouse sobre o nome de uma classe e clique no ícone de lápis para renomeá-la.
• 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.
• Realce bidirecional ao passar o mouse: Passar o mouse sobre uma anotação na tela destaca-a na barra lateral e vice-versa. A barra lateral rola e expande automaticamente para a classe relevante.
• Ocultar/mostrar anotações individuais: Clica no ícone de olho em qualquer linha de anotação para alternar a sua visibilidade na tela.
• Eliminar anotações: Clica no ícone de lixeira em qualquer linha de anotação para a eliminar.
• Atalhos de teclado: Prime 1-9 para selecionar rapidamente as primeiras 9 classes.

Menu de Contexto

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

Controlos de Visibilidade

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

Cursor de Retícula

No modo de edição, uma sobreposição de retícula 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-a através do menu pendente de visibilidade.

Pré-visualização ao passar o rato SAM

No modo Inteligente, o SAM fornece uma pré-visualização em tempo real ao passar o rato antes de clicares em quaisquer pontos. Esta pré-visualização está disponível para tarefas de detect, segment e OBB. Assim que adicionas cliques de refinamento, a pré-visualização atualiza-se para refletir a máscara atual e o tipo de anotação para a tarefa ativa.

Edição de Vértices de Polígono

Para anotações de segmentação, podes editar os vértices do polígono após o desenho:

• Mover vértices: Arrastar qualquer alça de vértice para a 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 para o teu conjunto de dados no separador Classes:

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

Adicionar Nova Classe Durante a Anotação

Podes criar novas classes diretamente enquanto fazes anotações sem sair do editor:

1. Desenha uma anotação na imagem
2. No menu pendente de classe, clica em Add New Class
3. Insere o nome da classe
4. Prime Enter para criar e atribuir

Isto permite um fluxo de trabalho fluido onde podes definir classes à medida que encontras novos tipos de objetos nos teus dados.

Editar Classes

• Mudar o nome: Clica num nome de classe na tabela para o editar em linha
• Mudar cor: Clica na amostra de cor para abrir o seletor de cores
• Pesquisar: Usa o campo de pesquisa para filtrar classes por nome
• Ordenar: Clica nos cabeçalhos das colunas para ordenar por nome, contagem de etiquetas ou contagem de imagens

Cores das Classes

Cada classe recebe uma cor da paleta Ultralytics. Podes personalizar as cores usando o seletor de cores no separador Classes. As cores são consistentes em toda a plataforma para um reconhecimento fácil.

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 (únicas e em lote)
• Edição de anotações (mover, redimensionar, rotacionar)
• Exclusão de anotações (únicas e em lote)
• Alteração de classes (únicas e em lote)
• Reorganização de anotações (z-order)
• Edição de vértices de polígono (adicionar, remover, mover)
• Movimentação de keypoints

Salvando anotações

As anotações são salvas quando você clica em Save ou pressiona Cmd/Ctrl+S:

• Salvar: Clique no botão salvar ou pressione Cmd/Ctrl+S
• Cancelar: Clique em cancelar para descartar as alterações
• Escape: Salva se houver alterações não salvas, caso contrário, sai do modo de edição

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, então use cliques fora da máscara para adicionar cobertura e cliques dentro da máscara para subtrair objetos próximos ou o fundo.

Posso importar anotações existentes?

Sim, carregue seu dataset com arquivos de rótulo no formato YOLO. A plataforma analisa e exibe automaticamente as anotações no editor.

Como anoto múltiplos 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 rapidamente as classes.

Posso treinar em datasets parcialmente anotados?

Sim, mas para melhores resultados:

• Rotule todos os objetos das suas classes alvo em cada imagem
• Use o filtro de rótulo definido como Unlabeled para identificar imagens que ainda precisam de anotação
• Imagens não rotuladas são excluídas do treinamento; apenas imagens rotuladas contribuem para a perda

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 o SAM 2.1 Tiny para velocidade máxima em objetos simples e de alto contraste.

Quais tarefas suportam a anotação inteligente SAM?

A anotação inteligente SAM está disponível para tarefas de detect, segment e OBB. 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 + próximo ao seletor de modelo de esqueleto para abrir o editor de modelos. Coloque keypoints, nomeie-os, desenhe conexões e salve. Modelos personalizados são armazenados na sua conta e ficam disponíveis em todos os datasets de pose.

Como alterno 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 keypoints serão colocados quando você clicar na imagem.