Link to this sectionEditor de Anotações#

A Ultralytics Platform inclui um poderoso editor de anotações para rotular imagens com caixas delimitadoras (bounding boxes), polígonos, pontos-chave, caixas orientadas e classificações. O editor oferece suporte para desenho manual e anotação inteligente baseada em 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

Link to this sectionTipos de tarefa suportados#

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

Link to this sectionDetalhes da Tarefa#

Link to this sectionComo Começar#

Para anotar imagens:

1. Navega até ao teu conjunto de dados
2. Clica numa imagem para abrir o visualizador em ecrã inteiro
3. Clica em Edit para entrar no modo de anotação
4. Seleciona a tua ferramenta de anotação na barra de ferramentas
5. Desenha as anotações na imagem
6. Clica em Save quando terminares

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

Link to this sectionModos de Anotação#

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

Link to this sectionFerramentas de Anotação Manual#

Link to this sectionCaixa Delimitadora (Detecção)#

Desenha caixas retangulares à volta dos objetos:

1. Entra no modo de edição e seleciona Draw
2. Clica e arrasta para desenhar um retângulo
3. Solta para completar a caixa
4. Seleciona uma classe na lista suspensa

Link to this sectionPolígono (Segmento)#

Desenha máscaras de polígono precisas:

1. Entra no modo de edição e seleciona Draw
2. Clica para adicionar vértices, ou mantém pressionado Shift e move o rato para desenhar pontos densos à mão livre
3. Clica no primeiro vértice, ou pressiona Enter ou Escape para fechar o polígono
4. Seleciona uma classe na lista suspensa

Link to this sectionPonto-chave (Pose)#

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

1. Entra no modo de edição e seleciona Draw
2. Escolhe um modelo de esqueleto no seletor de modelos na barra de ferramentas

3. Clica na imagem para colocar todos os pontos-chave de uma só vez
4. Arrasta os pontos-chave individuais para ajustar as suas posições
5. Pressiona Enter para confirmar ou Escape para cancelar

Link to this sectionModelos de esqueleto integrados#

O editor inclui 5 modelos integrados:

Link to this sectionModelos de esqueleto personalizados#

Crie modelos personalizados para qualquer estrutura de pose:

1. Clique no botão + ao lado do seletor de modelo
2. Opcionalmente, clique em Start from... para carregar keypoints e conexões de um modelo existente como ponto de partida
3. Posicione 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 dataset

Modelos personalizados são salvos na sua conta e disponibilizados em todos os datasets de pose.

Link to this sectionCaixa Delimitadora Orientada (OBB)#

Desenhe caixas rotacionadas para objetos angulados:

1. Entra no modo de edição e seleciona 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 de canto para redimensionar
5. Seleciona uma classe na lista suspensa

Link to this sectionClassificação (Classify)#

Atribua rótulos de classe ao 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

Link to this sectionAnotação Inteligente#

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

Link to this sectionAnotação Inteligente SAM#

Com um modelo SAM selecionado:

1. Entre no modo de edição e selecione Smart ou pressione S
2. Clique no objeto que desejas 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] --> 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
• Bounding boxes para tarefas de detecção
• Caixas orientadas para tarefas OBB

Link to this sectionModo Auto-Apply#

O modo auto-apply 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 auto-apply na barra de ferramentas ou pressione A.

Link to this sectionSeleçã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 dataset:

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

Link to this sectionAnotação inteligente YOLO#

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

1. Entre no modo de edição e selecione Smart ou pressione 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

Link to this sectionBarra lateral de classes#

O editor de anotação inclui uma barra lateral de classes recolhível no lado direito da tela. A barra lateral oferece:

• 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 existir 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.
• Realce 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 e expande 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.

Link to this sectionMenu de contexto#

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

Link to this sectionControles de visibilidade#

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

Link to this sectionCursor de retícula#

No modo de edição, uma sobreposição de retícula rastreia a posição do cursor e exibe coordenadas de pixel na tela. Isso ajuda a colocar anotações com precisão. Alterne através do menu suspenso de visibilidade.

Link to this sectionPré-visualização ao passar o mouse (SAM)#

No modo Smart, o SAM fornece uma pré-visualização em tempo real antes de você 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 para a tarefa ativa.

Link to this sectionEdição de vértices de polígono#

Para anotações de segmentação, você pode editar os vértices do polígono após desenhá-los:

• 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

Link to this sectionGerenciamento de classes#

Link to this sectionCriando classes#

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

1. Navegue até a guia 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 da paleta da Ultralytics

Link to this sectionAdicionar 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. No menu suspenso de classes, clique em Add New Class
3. Digite o nome da classe
4. Pressione Enter para criar e atribuir

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

Link to this sectionEditando 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 nome, contagem de rótulos ou contagem de imagens

Link to this sectionCores das classes#

Cada classe recebe uma cor da paleta da Ultralytics. Você pode personalizar as cores usando o seletor de cores na guia Classes. As cores são consistentes em toda a plataforma para facilitar o reconhecimento.

Link to this sectionAtalhos de teclado#

Anotação eficiente com atalhos de teclado:

Link to this sectionDesfazer/Refazer#

O editor de anotação 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, girar)
• Exclusão de anotações (individual e em lote)
• Alteração de classes (individual e em lote)
• Reordenamento de anotações (ordem z)
• Edição de vértices de polígono (adicionar, remover, mover)
• Movimentação de pontos-chave (keypoints)

Link to this sectionSalvando 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

Link to this sectionFAQ#

Link to this sectionQuão precisa é a 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 obter melhores resultados, comece clicando 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 o fundo.

Link to this sectionPosso importar anotações existentes?#

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

Link to this sectionComo faço para anotar 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 rapidamente as classes.

Link to this sectionPosso treinar com conjuntos de dados 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 (Não rotulado) 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

Link to this sectionQual modelo SAM devo usar?#

SAM 3 é o modelo padrão e a última geração — comece por ele para obter máscaras da mais alta qualidade. Mude para o 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.

Link to this sectionQuais tarefas suportam a anotação inteligente SAM?#

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

Link to this sectionPosso 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. Os modelos personalizados são armazenados na sua conta e ficam disponíveis em todos os conjuntos de dados de pose.

Link to this sectionComo faço para 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.