Vai al contenuto

Editor di Annotazioni

La piattaforma Ultralytics include un potente editor di annotazioni per etichettare immagini con bounding box, poligoni, keypoint, box orientati e classificazioni. L'editor supporta il disegno manuale e l'annotazione smart basata su SAM.

Piattaforma Ultralytics Annotazione Editor Barra Degli Strumenti Con Canvas

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

Tipi di Attività Supportati

L'editor di annotazioni supporta tutti i 5 tipi di attività YOLO:

TaskStrumentoFormato di Annotazione
RilevaRettangoloBounding box (x, y, larghezza, altezza)
SegmentazionePoligonoMaschere precise al pixel (vertici del poligono)
PosaKeypointModelli di scheletro (Persona, Mano, Volto, Cane, Scatola, personalizzato)
OBBBox OrientataBounding box ruotate (4 angoli)
ClassificazioneSelettore di ClasseEtichette a livello di immagine

Dettagli dell'attività

Rilevamento di oggetti

Cosa fa: identifica gli oggetti e la loro posizione con riquadri di delimitazione allineati agli assi.

Formato dell'etichetta:class_id center_x center_y width height (tutti normalizzati 0-1)

Esempio: 0 0.5 0.5 0.2 0.3 — Classe 0 centrata su (50%, 50%) con larghezza del 20% e altezza del 30%

Casi d'uso: conteggio delle scorte, monitoraggio del traffico, rilevamento della fauna selvatica, sistemi di sicurezza

Segmentazione delle istanze

Cosa fa: crea maschere precise al pixel per ogni istanza dell'oggetto.

Formato dell'etichetta:class_id x1 y1 x2 y2 x3 y3 ... (vertici poligonali, normalizzati 0-1)

Esempio: 0 0.1 0.1 0.9 0.1 0.9 0.9 0.1 0.9 — Maschera quadrilatera

Casi d'uso: imaging medico, veicoli autonomi, fotoritocco, analisi agricola

Stima della posa

Cosa fa: rileva i punti chiave del corpo per il tracciamento dello scheletro.

Formato dell'etichetta:class_id cx cy w h kx1 ky1 v1 kx2 ky2 v2 ...

  • Indicatori di visibilità: 0=non etichettato, 1=etichettato ma occluso, 2=etichettato e visibile

Esempio: 0 0.5 0.5 0.2 0.3 0.6 0.7 2 0.4 0.8 1 — Persona con 2 punti chiave

Casi d'uso: analisi sportiva, fisioterapia, animazione, riconoscimento dei gesti

Oriented Bounding Box (OBB)

Cosa fa: rileva oggetti ruotati con riquadri di delimitazione sensibili all'angolo.

Formato dell'etichetta:class_id x1 y1 x2 y2 x3 y3 x4 y4 (quattro punti angolari, normalizzati)

Esempio: 0 0.1 0.1 0.9 0.1 0.9 0.9 0.1 0.9 — Rettangolo ruotato

Casi d'uso: immagini aeree, analisi di documenti, ispezione della produzione, rilevamento di navi

Classificazione delle immagini

Cosa fa: assegna un'unica etichetta all'intera immagine.

Formato dell'etichetta:Basato su cartelle — immagini organizzate per nome della classe (train/cats/, train/dogs/)

Casi d'uso: moderazione dei contenuti, controllo qualità, diagnosi medica, riconoscimento delle scene

Introduzione

Per annotare le immagini:

  1. Naviga al tuo dataset
  2. Clicca su un'immagine per aprire il visualizzatore a schermo intero
  3. Clicca Edit per entrare in modalità annotazione
  4. Seleziona il tuo strumento di annotazione dalla barra degli strumenti
  5. Disegna annotazioni sull'immagine
  6. Clicca Save al termine

Piattaforma Ultralytics Annotazione Modalità Modifica A Schermo Intero Con Barra Degli Strumenti

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

Modalità di Annotazione

L'editor offre due modalità di annotazione, selezionabili dalla barra degli strumenti:

ModalitàDescrizioneScorciatoia
DisegnaAnnotazione manuale con strumenti specifici per il taskV
IntelligenteAnnotazione interattiva basata su SAM (detect/segment/obb)S

Strumenti di Annotazione Manuale

Bounding Box (detect)

Disegna riquadri rettangolari attorno agli oggetti:

  1. Accedi alla modalità di modifica e seleziona Draw
  2. Clicca e trascina per disegnare un rettangolo
  3. Rilascia per completare il riquadro
  4. Seleziona una classe dal menu a discesa

Piattaforma Ultralytics Annotazione Detect Disegno Bounding Box

Ridimensiona e Sposta

  • Trascina le 8 maniglie degli angoli/bordi per ridimensionare
  • Trascina il centro per spostare
  • Premi Delete oppure Backspace per rimuovere l'annotazione selezionata

Poligono (segment)

Disegna maschere poligonali precise:

  1. Accedi alla modalità di modifica e seleziona Draw
  2. Clicca per aggiungere vertici
  3. Fai clic destro o premi Enter per chiudere il poligono
  4. Seleziona una classe dal menu a discesa

Piattaforma Ultralytics Annotazione segment Vertici Poligono

Modifica Vertici

  • Trascina i singoli vertici per regolare
  • Trascina l'intero poligono per spostare
  • Clicca su un vertice e premi Delete per rimuoverlo

Punto Chiave (Posa)

Annota le pose utilizzando i template scheletrici. Seleziona un template dalla barra degli strumenti, clicca una volta per posizionare tutti i keypoint, quindi trascina i singoli keypoint per regolare le posizioni.

  1. Accedi alla modalità di modifica e seleziona Draw
  2. Scegli un modello di scheletro dal selettore di modelli nella barra degli strumenti

Piattaforma Ultralytics Annotazione Pose Menu A Discesa Modelli

  1. Clicca sull'immagine per posizionare tutti i keypoint contemporaneamente
  2. Trascina i singoli keypoint per regolare le loro posizioni
  3. Premi Enter per confermare o Escape per annullare

Modelli di scheletro integrati

L'editor include 5 modelli predefiniti:

ModelloPunti chiaveDescrizione
Persona17Posa umana COCO — naso, occhi, orecchie, spalle, gomiti, polsi, anche, ginocchia, caviglie
Mano21Landmark della mano MediaPipe — articolazioni di polso, pollice, indice, medio, anulare, mignolo
Volto68Punti di riferimento facciali iBUG 300W — mascella, sopracciglia, naso, occhi, bocca
Cane18Pose di animali — naso, testa, collo, spalle, zampe, coda
Riquadro4Punti chiave angolari — in alto a sinistra, in alto a destra, in basso a destra, in basso a sinistra

Piattaforma Ultralytics Annotazione Pose Scheletro Keypoints

Modelli di scheletro personalizzati

Crea template personalizzati per qualsiasi struttura di posa:

  1. Clicca il pulsante + accanto al selettore del modello
  2. Opzionalmente, clicca su Inizia da... per caricare keypoint e connessioni da un modello esistente come punto di partenza
  3. Posiziona i keypoint sulla tela cliccando
  4. Nomina ogni keypoint e personalizza i colori
  5. Collega i punti chiave selezionando due punti (le connessioni vengono disegnate automaticamente man mano che si posizionano i punti chiave in sequenza)
  6. Salva il modello per il riutilizzo su tutto il tuo dataset

Piattaforma Ultralytics Annotazione Pose Modello Personalizzato

I modelli personalizzati vengono salvati nel tuo account e sono disponibili in tutti i dataset di pose.

Flusso di Lavoro del Modello

Il sistema di template sostituisce il posizionamento manuale sequenziale dei keypoint. Invece di cliccare 17 volte per uno scheletro COCO, seleziona il template Persona e clicca una volta — tutti i keypoint vengono posizionati nel layout scheletrico corretto. Poi trascina per regolare le posizioni per la posa specifica.

Visibilità del keypoint

Ogni keypoint ha un flag di visibilità: 0 = non etichettato, 1 = etichettato ma occluso, 2 = etichettato e visibile. I keypoint occlusi (dietro altri oggetti) dovrebbero essere contrassegnati con visibilità 1 — il modello impara a inferire la loro posizione.

Oriented Bounding Box (OBB)

Disegnare box ruotati per oggetti angolati:

  1. Accedi alla modalità di modifica e seleziona Draw
  2. Cliccare e trascinare per disegnare un box iniziale
  3. Utilizzare la maniglia di rotazione per regolare l'angolo
  4. Trascina le maniglie degli angoli per ridimensionare
  5. Seleziona una classe dal menu a discesa

Piattaforma Ultralytics Annotazione Obb Bounding Box Ruotato

Classificazione (classify)

Assegnare etichette di classe a livello di immagine:

  1. Accedi alla modalità di modifica
  2. Appare un pannello laterale con i pulsanti di selezione delle classi.
  3. Clicca sui pulsanti delle classi o premi i tasti numerici 1-9

Piattaforma Ultralytics Annotazione Classifica Pannello Laterale

SAM Annotazione Intelligente

Segment Anything Model (SAM) consente l'annotazione intelligente con pochi clic. La modalità smart è disponibile per i task di detect, segment e OBB.

  1. Accedi alla modalità di modifica e seleziona Smart o premi S
  2. Clic sinistro per aggiungere punti positivi (includi quest'area)
  3. Clic destro per aggiungere punti negativi (escludi quest'area)
  4. SAM genera una maschera precisa in tempo reale
  5. Premi Enter oppure Escape per salvare l'annotazione, o abilitare applicazione automatica per flussi di lavoro con un solo clic

Piattaforma Ultralytics Annotazione SAM Maschera Punti Positivi Negativi

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

Suggerimenti SAM

  • Inizia con un clic positivo sul centro dell'oggetto
  • Aggiungi clic negativi per escludere lo sfondo
  • Mantieni Alt/Option per invertire il comportamento del clic (il clic sinistro diventa negativo, il clic destro diventa positivo)
  • Abilita applicazione automatica (A) per l'annotazione con un clic — la maschera si salva automaticamente dopo ogni clic
  • Mantieni Shift mentre l'applicazione automatica è attiva per posizionare più punti prima che la maschera venga applicata
  • Punti positivi e negativi appaiono come marcatori quadrati con + e simboli sulla tela
  • Funziona meglio per oggetti distinti con bordi chiari
  • Utilizzare 2-3 punti positivi per oggetti allungati

L'annotazione intelligente SAM può generare:

  • Poligoni per attività di segment
  • Bounding box per attività di detect
  • Box orientati per attività obb

Supporto attività SAM

L'annotazione intelligente SAM è disponibile solo per le attività di detect, segment e obb. Le attività di classificazione e stima della posa richiedono l'annotazione manuale.

Modalità di Applicazione Automatica

La modalità di applicazione automatica velocizza l'annotazione Smart salvando automaticamente la maschera SAM dopo ogni clic — senza la necessità di premere Enter. Attivalo con il pulsante di applicazione automatica nella barra degli strumenti o premi A.

ModalitàComportamento
Applicazione automatica ATTIVA (predefinito)La maschera si applica automaticamente dopo ogni click
Applicazione Automatica ATTIVATA + ShiftPosiziona prima più punti, la maschera viene applicata al rilascio
Applicazione Automatica DISATTIVATAPosizionare i punti liberamente, premere Enter per applicare

Piattaforma Ultralytics Annotazione SAM Interruttore Applicazione Automatica

Quando utilizzare l'applicazione automatica

L'applicazione automatica è ideale per dataset con oggetti ben separati, dove un singolo clic produce una maschera accurata. Per oggetti complessi o sovrapposti, disattiva l'applicazione automatica e utilizza più punti positivi/negativi per affinare la maschera prima di salvarla.

Selezione del modello SAM

Quando la modalità Smart è attiva, un selettore di modelli appare nella barra degli strumenti. Sono disponibili cinque modelli — scegli in base al compromesso velocità vs. precisione più adatto al tuo dataset:

ModelloDimensioneVelocitàNote
SAM 2.1 Tiny74,5 MBIl più Veloce
SAM 2.1 Small88 MBVelocePredefinito
SAM 2.1 Base154 MBModerata
SAM 2.1 Large428 MBPiù lentaPiù accurato di SAM 2.1
SAM 33,45 GBLa più lentaUltima generazione, novità 2025

Piattaforma Ultralytics Annotazione SAM Selettore Modello

Il cambio di modello mentre la modalità Smart è attiva reinizializza automaticamente il predittore per l'immagine corrente.

Barra laterale della classe

L'editor di annotazioni include una barra laterale delle classi a scomparsa sul lato destro della tela. La barra laterale fornisce:

  • Cerca Classi: Filtra l'elenco delle classi digitando nel campo di ricerca. Premi Enter su una corrispondenza esatta per selezionarla, o creare una nuova classe se non esiste alcuna corrispondenza.
  • Crea nuova classe in linea: Clicca Add class in fondo alla lista, digita un nome e, facoltativamente, scegli un colore personalizzato. Premi Enter da creare.
  • Modifica il nome della classe in linea: Passa il mouse su un nome di classe e clicca sull'icona della matita per rinominarlo.
  • Selettore colore: Clicca sul campione di colore accanto a qualsiasi classe per cambiarne il colore.
  • Conteggio annotazioni per classe: Ogni riga di classe mostra un conteggio in apice delle annotazioni.
  • Espandi/comprimi: Clicca sulla freccia per espandere una classe e vedere le singole annotazioni elencate sotto di essa.
  • Evidenziazione bidirezionale al passaggio del mouse: passando con il mouse su un'annotazione sulla tela, questa viene evidenziata nella barra laterale e viceversa. La barra laterale scorre automaticamente ed espande automaticamente la classe pertinente.
  • Nascondi/mostra annotazioni individuali: Clicca sull'icona dell'occhio su qualsiasi riga di annotazione per attivare/disattivare la sua visibilità sulla tela.
  • Elimina annotazioni: Clicca sull'icona del cestino su qualsiasi riga di annotazione per eliminarla.
  • Scorciatoie da tastiera: Premi 1-9 per selezionare rapidamente le prime 9 classi.

Menu Contestuale

Fai clic destro sulle annotazioni selezionate per aprire un menu contestuale con:

AzioneScorciatoia
Elimina annotazioniDelete / Backspace
Porta in Primo PianoCmd/Ctrl+Shift+]
Invia in Secondo PianoCmd/Ctrl+Shift+[
Porta AvantiCmd/Ctrl+]
Invia IndietroCmd/Ctrl+[

Controlli di visibilità

Il menu a discesa della visibilità (icona a forma di occhio) consente di attivare/disattivare la visualizzazione dei singoli elementi:

Attiva/DisattivaDescrizione
AnnotazioniMostra o nascondi tutte le sovrapposizioni di annotazioni
Etichette delle classiMostra o nascondi le etichette dei nomi delle classi sulle annotazioni
Mostra pixelAttiva/Disattiva il rendering pixelato per l'ispezione con zoom (a schermo intero)
ReticoliMostra cursore a croce con coordinate pixel (modalità modifica)
Miniature di navigazioneMostra la striscia di miniature di navigazione (schermo intero)
Mostra tuttoAttiva/Disattiva annotazioni, etichette, mirini e miniature contemporaneamente (non influisce sulla pixelatura)

Cursore a mirino

In modalità di modifica, una sovrapposizione a mirino traccia la posizione del cursore e visualizza le coordinate dei pixel sulla tela. Questo aiuta a posizionare le annotazioni con precisione. Attivala tramite il menu a discesa della visibilità.

Anteprima SAM al passaggio del mouse

In modalità Smart per i compiti di segment, SAM fornisce un'anteprima della maschera in tempo reale mentre si passa il mouse sull'immagine — prima di cliccare su qualsiasi punto. Questo permette di vedere il confine di segmentazione previsto e decidere dove cliccare. Una volta aggiunti punti positivi o negativi, l'anteprima si aggiorna per riflettere i tuoi affinamenti.

Modifica Vertici Poligono

Per le annotazioni di segmentazione, è possibile modificare i vertici del poligono dopo aver disegnato:

  • Sposta i vertici: Trascina qualsiasi maniglia di vertice per riposizionarlo
  • Elimina vertici: Seleziona un vertice e premi Delete per rimuoverlo

Gestione della classe

Creazione di Classi

Definisci le classi di annotazione per il tuo dataset nel Classes scheda:

  1. Vai a Classes scheda
  2. Utilizzare il campo di input in basso per digitare un nome di classe
  3. Clicca Add o premi Enter
  4. Un colore viene assegnato automaticamente dalla palette Ultralytics

Piattaforma Ultralytics Annotazione Scheda Classi Aggiungi Nuova Classe

Aggiungi nuova classe durante l'annotazione

È possibile creare nuove classi direttamente durante l'annotazione senza uscire dall'editor:

  1. Disegna un'annotazione sull'immagine
  2. Nel menu a discesa delle classi, clicca Add New Class
  3. Inserire il nome della classe
  4. Premere Invio per creare e assegnare

Ciò consente un flusso di lavoro continuo in cui è possibile definire classi man mano che si incontrano nuovi tipi di oggetti nei dati.

Tabella delle classi unificate

Tutte le classi presenti nel set di dati vengono gestite in una tabella unificata. Le modifiche apportate ai nomi o ai colori delle classi vengono applicate automaticamente all'intero set di dati.

Modifica di Classi

  • Rinomina: Clicca su un nome di classe nella tabella per modificarlo direttamente
  • Cambia colore: Clicca sul campione di colore per aprire il selettore colori
  • Cerca: Utilizza il campo di ricerca per filtrare le classi per nome
  • Ordina: Clicca le intestazioni delle colonne per ordinare per nome, numero di etichette o numero di immagini

Colori della classe

A ogni classe viene assegnato un colore dalla palette Ultralytics. È possibile personalizzare i colori utilizzando il selettore di colori su Classes scheda. I colori sono coerenti in tutta la piattaforma per un facile riconoscimento.

Scorciatoie da tastiera

Annotazione efficiente con scorciatoie da tastiera:

ScorciatoiaAzione
Cmd/Ctrl+SSalva annotazioni
Cmd/Ctrl+ZAnnulla
Cmd/Ctrl+Shift+ZRipeti
Cmd/Ctrl+YRipeti (alternativa)
EscapeSalva / Deseleziona / Esci
Delete / BackspaceElimina annotazione selezionata
1-9Seleziona classe 1-9
Cmd/Ctrl+ScrollZoom avanti/indietro
Shift+ClickAnnotazioni a selezione multipla
Cmd/Ctrl+ASelezionare tutte le annotazioni.
ScorciatoiaAzione
VModalità disegno (manuale)
SModalità intelligente (SAM)
ScorciatoiaAzione
Click+DragDisegna il bounding box (detect/OBB)
ClickAggiungi punto poligono (segment) / Posiziona scheletro (pose)
Right-clickCompleta poligono / Aggiungi punto negativo SAM
Shift + click/right-clickPosizionare più punti SAM prima di applicare (applicazione automatica attiva)
AAttiva/Disattiva applicazione automatica (modalità Smart)
EnterCompleta poligono / Conferma posa / Salva annotazione SAM
EscapeAnnulla posa / Salva annotazione SAM / Deseleziona / Esci
ScorciatoiaAzione
Cmd/Ctrl+]Porta avanti
Cmd/Ctrl+[Invia indietro
Cmd/Ctrl+Shift+]Porta in primo piano
Cmd/Ctrl+Shift+[Invia in secondo piano

Piattaforma Ultralytics Annotazione Finestra Di Dialogo Scorciatoie Da Tastiera

Visualizza tutte le scorciatoie

Fai clic sull'icona della tastiera nella barra degli strumenti di annotazione per aprire il riferimento delle scorciatoie.

Annulla/Ripeti

L'editor di annotazioni mantiene una cronologia completa di annulla/ripeti:

  • Annulla: Cmd/Ctrl+Z
  • Ripeti: Cmd/Ctrl+Shift+Z oppure Cmd/Ctrl+Y

Tracce della cronologia:

  • Aggiunta di annotazioni (singole e in batch)
  • Modifica delle annotazioni (sposta, ridimensiona, ruota)
  • Eliminazione delle annotazioni (singole e in batch)
  • Modifica delle classi (singola e in batch)
  • Riordinamento delle annotazioni (ordine z)
  • Modifica dei vertici del poligono (aggiungi, rimuovi, sposta)
  • Spostamento dei keypoint

Annulla illimitato

La pila di annullamento non ha un limite fisso: è possibile annullare tutte le modifiche apportate durante la sessione di modifica corrente, tornando allo stato originale dell'immagine al momento del clic. Edit.

Salvataggio delle annotazioni

Le annotazioni vengono salvate quando si clicca Save o premi Cmd/Ctrl+S:

  • Salva: Fare clic sul pulsante Salva o premere Cmd/Ctrl+S
  • Annulla: Fare clic su Annulla per scartare le modifiche
  • Escape: Salva se ci sono modifiche non salvate, altrimenti esce dalla modalità di modifica

Salva il tuo lavoro

Salvare sempre prima di passare a un'altra immagine. Le modifiche non salvate andranno perse.

FAQ

Quanto è precisa l'annotazione SAM?

SAM fornisce maschere di alta qualità per la maggior parte degli oggetti. L'accuratezza dipende da:

  • Distintività dell'oggetto dallo sfondo
  • Qualità e risoluzione dell'immagine
  • Numero di punti positivi/negativi forniti

Per ottenere risultati ottimali, inizia con un punto positivo al centro dell'oggetto e aggiungi punti negativi per escludere oggetti vicini.

Posso importare annotazioni esistenti?

Sì, carica il tuo dataset con file di etichette in formato YOLO. La Piattaforma li analizza e visualizza automaticamente nell'editor.

Come si annotano più oggetti della stessa classe?

Dopo aver disegnato un'annotazione:

  1. Mantieni la stessa classe selezionata
  2. Disegna l'annotazione successiva
  3. Ripeti finché tutti gli oggetti non sono etichettati

La scorciatoia da tastiera 1-9 seleziona rapidamente le classi.

È possibile addestrare su dataset parzialmente annotati?

Sì, ma per risultati ottimali:

  • Etichetta tutti gli oggetti delle tue classi target in ogni immagine
  • Utilizzare il filtro etichette impostato su Unannotated per identificare immagini non etichettate
  • Escludere le immagini non annotate dalla configurazione di addestramento

Quale modello SAM dovrei usare?

Inizia con SAM 2.1 Small (il predefinito) — è veloce e preciso per la maggior parte degli oggetti. Passa a SAM 2.1 Large quando hai bisogno di una maggiore precisione delle maschere su forme complesse. Utilizza SAM 2.1 Tiny per la massima velocità su oggetti semplici e ad alto contrasto. SAM 3 è il modello di ultima generazione e può produrre risultati migliori su immagini complesse, ma è significativamente più lento.

Quali task supportano l'annotazione intelligente SAM?

L'annotazione smart SAM è disponibile per i task di detect, segment e OBB. I task di classificazione e posa utilizzano solo l'annotazione manuale.

Posso creare modelli di scheletro personalizzati per l'annotazione della posa?

Sì. Clicca il pulsante + accanto al selettore del modello di scheletro per aprire l'editor di modelli. Posiziona i keypoint, nominali, disegna le connessioni e salva. I modelli personalizzati sono memorizzati nel tuo account e disponibili per tutti i dataset di pose.

Come si passa da un template di scheletro all'altro?

Fai clic sul menu a discesa di selezione del modello nella barra degli strumenti di annotazione. Seleziona qualsiasi modello predefinito (Persona, Mano, Volto, Cane, Box) o i tuoi modelli personalizzati salvati. Il modello selezionato determina quali keypoint vengono posizionati quando fai clic sull'immagine.



📅 Creato 2 mesi fa ✏️ Aggiornato 5 giorni fa
glenn-jochermykolaxboikosergiuwaxmann

Commenti