Link to this sectionEditor de Anotações#

A Ultralytics Platform inclui um poderoso editor de anotações para rotular imagens com caixas delimitadoras, polígonos, pontos-chave, caixas orientadas e classificações. O editor oferece suporte a 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 tarefas suportados#

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

Link to this sectionDetalhes da Tarefa#

Link to this sectionComeçando#

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 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

Link to this sectionModos de Anotação#

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

Link to this sectionFerramentas de Anotação Manual#

Link to this sectionCaixa Delimitadora (Detect)#

Desenhe caixas retangulares ao redor de objetos:

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

Link to this sectionPolígono (Segment)#

Desenhe máscaras de polígono precisas:

1. Entre no modo de edição e selecione Draw
2. Clique para adicionar vértices, ou mantenha Shift pressionado 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

Link to this sectionPonto-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. 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 pontos-chave de uma vez
4. Arraste pontos-chave individuais para ajustar suas posições
5. Pressione 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 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 salvos na sua conta e ficam disponíveis em todos os conjuntos de dados de pose.

Link to this sectionCaixa Delimitadora Orientada (OBB)#

Desenhe caixas rotacionadas para objetos inclinados:

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 de canto para redimensionar
5. Selecione uma classe no menu suspenso

Link to this sectionClassificação (Classify)#

Atribua rótulos de classe em nível de 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 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 Ultralytics YOLO pré-treinados e seus 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 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] --> 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 de OBB

Link to this sectionModo 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.

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 conjunto de dados:

Mudar de modelo enquanto o modo Inteligente está ativo re-inicializa o preditor automaticamente para a imagem atual.

Link to this sectionAnotaçã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. 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çõ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.

Link to this sectionMenu de contexto#

Clique com o botão direito em 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 posicionar anotações com precisão. Alterne-a através do menu suspenso de visibilidade.

Link to this sectionPré-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.

Link to this sectionEdiçã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

Link to this sectionGerenciamento de classes#

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

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. 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.

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 índice, nome, contagem de anotações ou contagem de imagens

Link to this sectionCores das classes#

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

Link to this sectionAtalhos de teclado#

Anotação eficiente com atalhos de teclado:

Link to this sectionDesfazer/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

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 sectionQual é 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.

Link to this sectionPosso 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.

Link to this sectionComo 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.

Link to this sectionPosso 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
• 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 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.

Link to this sectionQuais 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.

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. Modelos personalizados são armazenados em sua conta e estão disponíveis em todos os conjuntos de dados de pose.

Link to this sectionComo 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.