Editor de Anotação
Ultralytics inclui um poderoso editor de anotações para rotular imagens com caixas delimitadoras, polígonos, pontos-chave, caixas orientadas e classificações. O editor suporta desenho manual e anotações inteligentes 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 Suportados
O editor de anotações suporta todos os 5 tipos de tarefas YOLO:
| Tarefa | Ferramenta | Formato de Anotação |
|---|---|---|
| Detectar | Retângulo | Caixas delimitadoras (x, y, largura, altura) |
| Segmentar | Polígono | Máscaras pixel a pixel (vértices do polígono) |
| Pose | Ponto-chave | Esqueleto COCO de 17 pontos |
| OBB | Caixa Orientada | Caixas delimitadoras rotacionadas (4 cantos) |
| Classificar | Seletor de Classe | Rótulos ao nível da imagem |
Detalhes da tarefa
Detecção de Objetos
O que faz: Identifica objetos e suas localizações com caixas delimitadoras alinhadas com os eixos.
Formato da etiqueta:class_id center_x center_y width height (todos normalizados de 0 a 1)
Exemplo: 0 0.5 0.5 0.2 0.3 — Classe 0 centrada em (50%, 50%) com 20% de largura e 30% de altura
Casos de uso: Contagem de inventário, monitoramento de tráfego, detecção de animais selvagens, sistemas de segurança
Segmentação de Instância
O que faz: Cria máscaras com precisão de pixel para cada instância de objeto.
Formato da etiqueta:class_id x1 y1 x2 y2 x3 y3 ... (vértices do polígono, normalizados 0-1)
Exemplo: 0 0.1 0.1 0.9 0.1 0.9 0.9 0.1 0.9 — Máscara quadrilateral
Casos de uso: Imagens médicas, veículos autónomos, edição de fotos, análise agrícola
Estimativa de Pose
O que faz: Deteta pontos-chave do corpo para rastreamento do esqueleto.
Formato da etiqueta:class_id cx cy w h kx1 ky1 v1 kx2 ky2 v2 ...
- Sinalizadores de visibilidade:
0=sem rótulo,1=rotulado, mas ocluído,2=rotulado e visível
Exemplo: 0 0.5 0.5 0.2 0.3 0.6 0.7 2 0.4 0.8 1 — Pessoa com 2 pontos-chave
Casos de uso: Análise desportiva, fisioterapia, animação, reconhecimento de gestos
Caixa Delimitadora Orientada (OBB)
O que faz: Deteta objetos rodados com caixas delimitadoras sensíveis ao ângulo.
Formato da etiqueta:class_id x1 y1 x2 y2 x3 y3 x4 y4 (quatro pontos de canto, normalizados)
Exemplo: 0 0.1 0.1 0.9 0.1 0.9 0.9 0.1 0.9 — Retângulo rodado
Casos de uso: Imagens aéreas, análise de documentos, inspeção de fabricação, deteção de navios
Classificação de Imagem
O que faz: Atribui uma única etiqueta a toda a imagem.
Formato da etiqueta:Baseado em pastas — imagens organizadas por nome da classe (train/cats/, train/dogs/)
Casos de uso: moderação de conteúdo, controlo de qualidade, diagnóstico médico, reconhecimento de cena
Começando
Para anotar imagens:
- Navegue até o seu conjunto de dados
- Clique em uma imagem para abrir o visualizador em tela cheia
- Clique
Editpara entrar no modo de anotação - Selecione a sua ferramenta de anotação na barra de ferramentas
- Desenhe anotações na imagem
- Clique
Savequando 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:
| Modo | Descrição | Atalho |
|---|---|---|
| Desenhar | Anotação manual com ferramentas específicas para a tarefa | V |
| Inteligente | Anotação interativa SAM(segment) | S |
Ferramentas de Anotação Manual
Caixa Delimitadora (detect)
Desenhe caixas retangulares ao redor dos objetos:
- Entre no modo de edição e selecione
Draw - Clique e arraste para desenhar um retângulo
- Solte para completar a caixa
- Selecione uma classe no menu suspenso

Redimensionar e Mover
- Arraste as 8 alças dos cantos/bordas para redimensionar
- Arraste o centro para mover
- Pressione
DeleteouBackspacepara remover a anotação selecionada
Polígono (segment)
Desenhe máscaras de polígono precisas:
- Entre no modo de edição e selecione
Draw - Clique para adicionar vértices
- Clique com o botão direito do rato ou pressione
Enterpara fechar o polígono - Selecione uma classe no menu suspenso

Editar Vértices
- Arraste vértices individuais para ajustar
- Arraste o polígono inteiro para mover
- Clique em um vértice e pressione
Deletepara removê-lo
Ponto Chave (Pose)
Coloque 17 COCO para a pose humana:
- Entre no modo de edição e selecione
Draw - Clique para posicionar keypoints em sequência
- Siga a ordemCOCO
Os 17 keypoints COCO são:
| # | Ponto-chave | # | Ponto-chave |
|---|---|---|---|
| 1 | Nariz | 10 | Pulso esquerdo |
| 2 | Olho esquerdo | 11 | Punho direito |
| 3 | Olho direito | 12 | Quadril esquerdo |
| 4 | Orelha esquerda | 13 | Quadril direito |
| 5 | Orelha direita | 14 | Joelho esquerdo |
| 6 | Ombro esquerdo | 15 | Joelho direito |
| 7 | Ombro direito | 16 | Tornozelo esquerdo |
| 8 | Cotovelo esquerdo | 17 | Tornozelo direito |
| 9 | Cotovelo direito |

Visibilidade dos pontos-chave
Cada ponto-chave tem um sinalizador de visibilidade: 0 = sem rótulo, 1 = rotulado, mas ocluído, 2 = rotulados e visíveis. Pontos-chave ocultos (atrás de outros objetos) devem ser marcados com visibilidade. 1 — o modelo aprende a inferir a sua posição.
Caixa Delimitadora Orientada (OBB)
Desenhe caixas rotacionadas para objetos angulados:
- Entre no modo de edição e selecione
Draw - Clique e arraste para desenhar uma caixa inicial
- Use o manipulador de rotação para ajustar o ângulo
- Arraste as alças dos cantos para redimensionar
- Selecione uma classe no menu suspenso

Classificação (classify)
Atribua rótulos de classe em nível de imagem:
- Entrar no modo de edição
- Um painel lateral aparece com botões de seleção de classe
- Clique nos botões de classe ou pressione as teclas numéricas
1-9

Anotação Inteligente SAM
O Segmento Anything Model (SAM) permite anotações inteligentes com apenas alguns cliques. O modo inteligente está disponível para detect, segmente tarefas OBB.
- Entre no modo de edição e selecione
Smartou pressioneS - Clique com o botão esquerdo para adicionar pontos positivos (incluir esta área)
- Clique com o botão direito para adicionar pontos negativos (excluir esta área)
- O SAM gera uma máscara precisa em tempo real
- Pressione
EnterouEscapepara guardar a anotação

graph LR
A[Press S] --> B[Left-click Object]
B --> C[SAM Generates Mask]
C --> D{Accurate?}
D -->|Yes| E[Enter to Save]
D -->|No| F[Add +/- Points]
F --> C
style A fill:#2196F3,color:#fff
style C fill:#FF9800,color:#fff
style E fill:#4CAF50,color:#fff
Dicas do SAM
- Comece com um clique positivo no centro do objeto
- Adicione cliques negativos para excluir o fundo
- Segurar
Alt/Optionpara inverter o comportamento do clique (o clique esquerdo torna-se negativo, o clique direito torna-se positivo) - Funciona melhor para objetos distintos com bordas claras
- Use 2-3 pontos positivos para objetos alongados
A anotação inteligente SAM pode gerar:
- Polígonos para tarefas de segmentação
- Caixas delimitadoras para tarefas de detecção
- Caixas orientadas para tarefas OBB
Suporte à SAM
A anotação SAM está disponível apenas para detect, segmente OBB. As tarefas de classificação e pose requerem anotação manual.
classe Sidebar
O editor de anotações inclui uma barra lateral de classes recolhível no lado direito da tela. A barra lateral oferece:
- Pesquisar aulas: Filtre a lista de aulas digitando no campo de pesquisa. Pressione
Enterem uma correspondência exata para selecioná-la ou crie uma nova classe se não houver correspondência. - Criar nova classe inline: Clique
Add classna parte inferior da lista, digite um nome e, opcionalmente, escolha uma cor personalizada. PressioneEntercriar. - Editar nome da classe inline: Passe o cursor sobre o nome de uma classe e clique no ícone do lápis para renomeá-la.
- Seletor de cores: clique na amostra de cor ao lado de qualquer classe para alterar a sua cor.
- Contagem de anotações por classe: cada linha da classe mostra uma contagem de anotações em sobrescrito.
- Expandir/recolher: Clique na seta para expandir uma classe e ver as anotações individuais listadas abaixo dela.
- Destaque bidirecional ao passar o cursor: ao passar o cursor sobre uma anotação na tela, ela é destacada 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 do olho em qualquer linha de anotação para alternar a sua visibilidade na tela.
- Eliminar anotações: Clique no ícone de lixo em qualquer linha de anotação para eliminá-la.
- Atalhos de teclado: Pressione
1-9para selecionar rapidamente as primeiras 9 aulas.
Menu de contexto
Clique com o botão direito do rato nas anotações selecionadas para abrir um menu de contexto com:
| Ação | Atalho |
|---|---|
| Eliminar anotação(ões) | Delete / Backspace |
| Trazer para a frente | Cmd/Ctrl+Shift+] |
| Enviar para trás | Cmd/Ctrl+Shift+[ |
| Avançar | Cmd/Ctrl+] |
| Enviar para trás | Cmd/Ctrl+[ |
Controlos de visibilidade
O menu suspenso de visibilidade (ícone de olho) permite alternar a exibição de elementos individuais:
| Alternar | Descrição |
|---|---|
| Anotações | Mostrar ou ocultar todas as sobreposições de anotações |
| Etiquetas de classe | Mostrar ou ocultar rótulos de nomes de classes nas anotações |
| Mostrar pixels | Alternar renderização pixelizada para inspeção com zoom (ecrã inteiro) |
| Mira | Mostrar cursor em forma de cruz com coordenadas em pixels (modo de edição) |
| Miniaturas de navegação | Mostrar faixa de miniaturas de navegação (ecrã inteiro) |
| Mostrar tudo | Alterne anotações, rótulos, miras e miniaturas de uma só vez (não afeta pixels) |
Cursor em forma de cruz
No modo de edição, uma sobreposição em forma de cruz rastreia a posição do cursor e exibe as coordenadas de pixels na tela. Isso ajuda a colocar anotações com precisão. Alterne essa função através do menu suspenso de visibilidade.
Pré-visualização do SAM
No modo inteligente para segment , SAM uma pré-visualização da máscara em tempo real ao passar o cursor sobre a imagem — antes de clicar em qualquer ponto. Isso permite ver o limite de segmentação previsto e decidir onde clicar. Depois de adicionar pontos positivos ou negativos, a pré-visualização é atualizada para refletir os seus refinamentos.
Edição de vértices de polígonos
Para segment , pode editar os vértices do polígono após desenhar:
- Mover vértices: Arraste qualquer alça de vértice para reposicioná-la
- Apagar vértices: Selecione um vértice e pressione
Deletepara removê-lo
Gestão de classes
Criação de Classes
Defina classes de anotação para o seu conjunto de dados no Classes tab:
- Navegue até o
Classesaba - Use o campo de entrada na parte inferior para digitar um nome de classe
- Clique
Addou pressioneEnter - Uma cor é atribuída automaticamente a partir da Ultralytics .

Adicionar nova classe durante a anotação
Você pode criar novas classes diretamente enquanto faz anotações, sem sair do editor:
- Desenhe uma anotação na imagem
- No menu suspenso da turma, clique em
Add New Class - Insira o nome da classe
- Pressione Enter para criar e atribuir
Isso permite um fluxo de trabalho contínuo, no qual é possível definir classes à medida que novos tipos de objetos são encontrados nos dados.
Tabela de classes unificadas
Todas as classes do seu conjunto de dados são geridas numa tabela unificada. As alterações nos nomes ou cores das classes são aplicadas automaticamente em todo o conjunto de dados.
Edição de Classes
- Renomear: Clique no nome de uma classe na tabela para editá-lo inline
- Alterar cor: Clique na amostra de cor para abrir o seletor de cores
- Pesquisa: Use o campo de pesquisa para filtrar as aulas por nome
- Ordenar: Clique nos cabeçalhos das colunas para ordenar por nome, número de etiquetas ou número de imagens.
Cores da classe
Cada classe recebe uma cor da Ultralytics . Você pode personalizar as cores usando o seletor de cores na Classes A guia. As cores são consistentes em toda a plataforma para facilitar o reconhecimento.
Atalhos de Teclado
Anotação eficiente com atalhos de teclado:
| Atalho | Ação |
|---|---|
Cmd/Ctrl+S | Guardar anotações |
Cmd/Ctrl+Z | Desfazer |
Cmd/Ctrl+Shift+Z | Refazer |
Cmd/Ctrl+Y | Refazer (alternativa) |
Escape | Guardar / Desmarcar / Sair |
Delete / Backspace | Excluir anotação selecionada |
1-9 | Selecionar classe 1-9 |
Cmd/Ctrl+Scroll | Aumentar/diminuir |
Shift+Click | Anotações com seleção múltipla |
Cmd/Ctrl+A | Selecionar todas as anotações |
| Atalho | Ação |
|---|---|
V | Modo de desenho (manual) |
S | Modo inteligente (SAM) |
| Atalho | Ação |
|---|---|
Click+Drag | Desenhar caixa delimitadora (detect) |
Click | Adicionar ponto poligonal (segment) / Colocar ponto-chave (pose) |
Right-click | Polígono completo / Adicionar ponto SAM |
Enter | Polígono completo / Guardar SAM |
Escape | Guardar SAM / Desmarcar / Sair do modo de edição |
| Atalho | Ação |
|---|---|
Cmd/Ctrl+] | Avançar |
Cmd/Ctrl+[ | Enviar para trás |
Cmd/Ctrl+Shift+] | Trazer para a frente |
Cmd/Ctrl+Shift+[ | Enviar para trás |

Ver Todos os Atalhos
Clique no ícone do teclado na barra de ferramentas de anotação para abrir a referência de atalhos.
Desfazer/Refazer
O editor de anotações mantém um histórico completo de desfazer/refazer:
- Desfazer:
Cmd/Ctrl+Z - Refazer:
Cmd/Ctrl+Shift+ZouCmd/Ctrl+Y
Histórico:
- Adicionar anotações (únicas e em lote)
- Editar anotações (mover, redimensionar, rodar)
- Eliminar anotações (individuais e em lote)
- Alteração de classes (únicas e em lote)
- Reordenar anotações (ordem z)
- Editar vértices de polígonos (adicionar, remover, mover)
- Pontos-chave em movimento
Desfazer ilimitado
A pilha de desfazer não tem limite fixo — pode desfazer todas as alterações feitas durante a sessão de edição atual, voltando ao estado original da imagem quando clicou em Edit.
Salvando Anotações
As anotações são guardadas quando clica em Save ou pressione Cmd/Ctrl+S:
- Salvar: Clique no botão salvar ou pressione
Cmd/Ctrl+S - Cancelar: Clique em cancelar para descartar as alterações
- Sair: guarda se houver alterações não guardadas, caso contrário, sai do modo de edição
Salvar Seu Trabalho
Sempre salve antes de navegar para outra imagem. As alterações não salvas serão perdidas.
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 ponto positivo no centro do objeto e adicione pontos negativos para excluir objetos próximos.
Posso importar anotações existentes?
Sim, carregue o seu conjunto de dados com ficheiros de etiquetasYOLO. A plataforma analisa-os automaticamente e exibe-os no editor.
Como anoto múltiplos objetos da mesma classe?
Após desenhar uma anotação:
- Mantenha a mesma classe selecionada
- Desenhe a próxima anotação
- Repita até que todos os objetos estejam rotulados
O atalho de teclado 1-9 seleciona classes rapidamente.
Posso 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 etiqueta definido para
Unannotatedpara identificar imagens sem rótulo - Excluir imagens não anotadas da configuração de treino
Quais tarefas suportam a anotação SAM ?
A anotação SAM está disponível para detect, segmente OBB. As tarefas de classificação e pose utilizam apenas anotação manual.