Editor di Annotazioni
Ultralytics include un potente editor di annotazioni per etichettare le immagini con riquadri di delimitazione, poligoni, punti chiave, riquadri orientati e classificazioni. L'editor supporta il disegno manuale e le annotazioni intelligenti 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
Tipi di Attività Supportati
L'editor di annotazioni supporta tutti i 5 tipi di attività YOLO:
| Task | Strumento | Formato di Annotazione |
|---|---|---|
| Rileva | Rettangolo | Bounding box (x, y, larghezza, altezza) |
| Segmentazione | Poligono | Maschere precise al pixel (vertici del poligono) |
| Posa | Keypoint | Scheletro COCO a 17 punti |
| OBB | Box Orientata | Bounding box ruotate (4 angoli) |
| Classificazione | Selettore di Classe | Etichette 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:
- Naviga al tuo dataset
- Clicca su un'immagine per aprire il visualizzatore a schermo intero
- Clicca
Editper entrare in modalità annotazione - Seleziona lo strumento di annotazione dalla barra degli strumenti
- Disegna annotazioni sull'immagine
- Clicca
Savequando finito

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à | Descrizione | Scorciatoia |
|---|---|---|
| Disegna | Annotazione manuale con strumenti specifici per l'attività | V |
| Intelligente | Annotazione interattiva SAM(segment) | S |
Strumenti di Annotazione Manuale
Bounding Box (detect)
Disegna riquadri rettangolari attorno agli oggetti:
- Entra in modalità modifica e seleziona
Draw - Clicca e trascina per disegnare un rettangolo
- Rilascia per completare il riquadro
- Seleziona una classe dal menu a discesa

Ridimensiona e Sposta
- Trascinare le 8 maniglie angolari/laterali per ridimensionare
- Trascina il centro per spostare
- Premi
DeleteoppureBackspaceper rimuovere l'annotazione selezionata
Poligono (segment)
Disegna maschere poligonali precise:
- Entra in modalità modifica e seleziona
Draw - Clicca per aggiungere vertici
- Clicca con il tasto destro o premi
Enterper chiudere il poligono - Seleziona una classe dal menu a discesa

Modifica Vertici
- Trascina i singoli vertici per regolare
- Trascina l'intero poligono per spostare
- Clicca su un vertice e premi
Deleteper rimuoverlo
Punto Chiave (Posa)
Posiziona 17 COCO per la posa umana:
- Entra in modalità modifica e seleziona
Draw - Cliccare per posizionare i keypoint in sequenza
- Segui l'ordineCOCO
I 17 keypoint COCO sono:
| # | Keypoint | # | Keypoint |
|---|---|---|---|
| 1 | Naso | 10 | Polso sinistro |
| 2 | Occhio sinistro | 11 | Polso destro |
| 3 | Occhio destro | 12 | Anca sinistra |
| 4 | Orecchio sinistro | 13 | Anca destra |
| 5 | Orecchio destro | 14 | Ginocchio sinistro |
| 6 | Spalla sinistra | 15 | Ginocchio destro |
| 7 | Spalla destra | 16 | Caviglia sinistra |
| 8 | Gomito sinistro | 17 | Caviglia destra |
| 9 | Gomito destro |

Visibilità dei punti chiave
Ogni punto chiave ha un indicatore di visibilità: 0 = non etichettato, 1 = etichettato ma occluso, 2 = etichettati e visibili. I punti chiave occlusi (dietro altri oggetti) devono essere contrassegnati con visibilità. 1 — il modello impara a dedurre la loro posizione.
Oriented Bounding Box (OBB)
Disegnare box ruotati per oggetti angolati:
- Entra in modalità modifica e seleziona
Draw - Cliccare e trascinare per disegnare un box iniziale
- Utilizzare la maniglia di rotazione per regolare l'angolo
- Trascinare gli angoli per ridimensionare
- Seleziona una classe dal menu a discesa

Classificazione (classify)
Assegnare etichette di classe a livello di immagine:
- Entra in modalità modifica
- Viene visualizzato un pannello laterale con i pulsanti di selezione delle classi.
- Clicca sui pulsanti delle classi o premi i tasti numerici
1-9

SAM Annotazione Intelligente
Il modello Segment Anything Model (SAM) consente di aggiungere annotazioni intelligenti con pochi clic. La modalità Smart è disponibile per detect, segmente OBB.
- Entra in modalità modifica e seleziona
Smartoppure premereS - Clic sinistro per aggiungere punti positivi (includi quest'area)
- Clic destro per aggiungere punti negativi (escludi quest'area)
- SAM genera una maschera precisa in tempo reale
- Premi
EnteroppureEscapeper salvare l'annotazione

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
Suggerimenti SAM
- Inizia con un clic positivo sul centro dell'oggetto
- Aggiungi clic negativi per escludere lo sfondo
- Tenere
Alt/Optionper invertire il comportamento del clic (il clic sinistro diventa negativo, il clic destro diventa positivo) - 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 SAM
L'annotazione SAM è disponibile solo per detect, segmente OBB. Le attività di classificazione e posa richiedono l'annotazione manuale.
classe Sidebar
L'editor delle annotazioni include una barra laterale delle classi comprimibile sul lato destro dell'area di lavoro. La barra laterale fornisce:
- Cerca corsi: Filtra l'elenco delle classi digitando nel campo di ricerca. Premi
Entersu una corrispondenza esatta per selezionarla, oppure crea una nuova classe se non esiste alcuna corrispondenza. - Crea nuova classe inline: Clicca
Add classin fondo all'elenco, digita un nome e, se lo desideri, scegli un colore personalizzato. PremiEntercreare. - Modifica il nome della classe in linea: passa con il mouse sul nome di una classe e clicca sull'icona a forma di matita per rinominarla.
- Selettore colore: clicca sul campione di colore accanto a qualsiasi classe per modificarne il colore.
- Numero di annotazioni per classe: ogni riga di classe mostra un numero di annotazioni in apice.
- Espandi/comprimi: clicca sulla freccia per espandere una classe e visualizzare 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 singole annotazioni: clicca sull'icona a forma di occhio su qualsiasi riga di annotazione per attivare o 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-9per selezionare rapidamente le prime 9 classi.
Menu contestuale
Clicca con il tasto destro sulle annotazioni selezionate per aprire un menu contestuale con:
| Azione | Scorciatoia |
|---|---|
| Elimina annotazioni | Delete / Backspace |
| Porta in primo piano | Cmd/Ctrl+Shift+] |
| Invia indietro | Cmd/Ctrl+Shift+[ |
| Portare avanti | Cmd/Ctrl+] |
| Invia indietro | Cmd/Ctrl+[ |
Controlli di visibilità
Il menu a tendina della visibilità (icona a forma di occhio) consente di attivare o disattivare la visualizzazione dei singoli elementi:
| Attiva/Disattiva | Descrizione |
|---|---|
| Annotazioni | Mostra o nascondi tutte le sovrapposizioni delle annotazioni |
| Etichette di classe | Mostra o nascondi le etichette dei nomi delle classi sulle annotazioni |
| Mostra pixel | Attiva/disattiva il rendering pixelato per l'ispezione dello zoom (schermo intero) |
| Mirino | Mostra cursore a croce con coordinate pixel (modalità modifica) |
| Miniature di navigazione | Mostra barra di navigazione con miniature (schermo intero) |
| Mostra tutto | Attiva/disattiva contemporaneamente annotazioni, etichette, mirini e miniature (non influisce sui pixel). |
Cursore a mirino
In modalità modifica, una sovrapposizione a forma di mirino traccia la posizione del cursore e visualizza le coordinate dei pixel sulla tela. Ciò consente di posizionare le annotazioni con precisione. Attivalo tramite il menu a tendina della visibilità.
Anteprima SAM
In modalità Smart per segment , SAM un'anteprima della maschera in tempo reale quando si passa il mouse sull'immagine, prima di cliccare su qualsiasi punto. Ciò consente di vedere il confine di segmentazione previsto e decidere dove cliccare. Una volta aggiunti i punti positivi o negativi, l'anteprima si aggiorna per riflettere le modifiche apportate.
Modifica dei vertici dei poligoni
Per segment , è possibile modificare i vertici dei poligoni dopo il disegno:
- Sposta vertici: trascina qualsiasi maniglia dei vertici per riposizionarla
- Elimina vertici: Seleziona un vertice e premi
Deleteper rimuoverlo
Gestione Classi
Creazione di Classi
Definisci le classi di annotazione per il tuo set di dati nel Classes scheda:
- Vai al
Classesscheda - Utilizza il campo di immissione in basso per digitare il nome di una classe.
- Clicca
Addoppure premereEnter - Il colore viene assegnato automaticamente dalla Ultralytics

Aggiungi nuova classe durante l'annotazione
È possibile creare nuove classi direttamente durante l'annotazione senza uscire dall'editor:
- Disegna un'annotazione sull'immagine
- Nel menu a tendina della classe, clicca su
Add New Class - Inserire il nome della classe
- 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 sul nome di una classe nella tabella per modificarlo in linea.
- Cambia colore: clicca sul campione di colore per aprire il selettore di colori
- Ricerca: utilizza il campo di ricerca per filtrare le classi in base al nome
- Ordina: clicca sulle intestazioni delle colonne per ordinare per nome, numero di etichette o numero di immagini
Classe Colori
A ogni classe viene assegnato un colore dalla Ultralytics . È possibile personalizzare i colori utilizzando il selettore di colori su Classes scheda. I colori sono uniformi su tutta la piattaforma per facilitarne il riconoscimento.
Scorciatoie da tastiera
Annotazione efficiente con scorciatoie da tastiera:
| Scorciatoia | Azione |
|---|---|
Cmd/Ctrl+S | Salva annotazioni |
Cmd/Ctrl+Z | Annulla |
Cmd/Ctrl+Shift+Z | Ripeti |
Cmd/Ctrl+Y | Ripeti (alternativa) |
Escape | Salva / Deseleziona / Esci |
Delete / Backspace | Elimina annotazione selezionata |
1-9 | Seleziona classe 1-9 |
Cmd/Ctrl+Scroll | Ingrandisci/riduci |
Shift+Click | Annotazioni a selezione multipla |
Cmd/Ctrl+A | Seleziona tutte le annotazioni |
| Scorciatoia | Azione |
|---|---|
V | Modalità disegno (manuale) |
S | Modalità intelligente (SAM) |
| Scorciatoia | Azione |
|---|---|
Click+Drag | Disegna riquadro di delimitazione (detect) |
Click | Aggiungi punto poligonale (segment) / Posiziona punto chiave (posa) |
Right-click | Poligono completo / Aggiungi punto SAM |
Enter | Poligono completo / Salva SAM |
Escape | Salva SAM / Deseleziona / Esci dalla modalità di modifica |
| Scorciatoia | Azione |
|---|---|
Cmd/Ctrl+] | Anticipare |
Cmd/Ctrl+[ | Invia indietro |
Cmd/Ctrl+Shift+] | Porta in primo piano |
Cmd/Ctrl+Shift+[ | Invia indietro |

Visualizza tutte le scorciatoie
Fai clic sull'icona della tastiera nella barra degli strumenti delle annotazioni per aprire il riferimento alle scorciatoie.
Annulla/Ripeti
L'editor delle annotazioni conserva una cronologia completa delle operazioni annullate/ripristinate:
- Annulla:
Cmd/Ctrl+Z - Ripeti:
Cmd/Ctrl+Shift+ZoppureCmd/Ctrl+Y
Tracce storiche:
- Aggiunta di annotazioni (singole e in batch)
- Modifica delle annotazioni (spostare, ridimensionare, ruotare)
- Eliminazione delle annotazioni (singole e in batch)
- Modifica delle classi (singola e in batch)
- Riorganizzazione delle annotazioni (ordine z)
- Modifica dei vertici dei poligoni (aggiungi, rimuovi, sposta)
- Punti chiave in movimento
Annullamento illimitato
Lo stack di annullamento non ha limiti fissi: è possibile annullare tutte le modifiche apportate durante la sessione di modifica corrente, tornando allo stato originale dell'immagine quando si è fatto clic. Edit.
Salvataggio delle annotazioni
Le annotazioni vengono salvate quando si fa clic su Save oppure premere Cmd/Ctrl+S:
- Salva: Fare clic sul pulsante Salva o premere
Cmd/Ctrl+S - Annulla: Fare clic su Annulla per scartare le modifiche
- Esci: 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 set di dati con file di etichetteYOLO. La piattaforma li analizza automaticamente e li visualizza nell'editor.
Come si annotano più oggetti della stessa classe?
Dopo aver disegnato un'annotazione:
- Mantieni la stessa classe selezionata
- Disegna l'annotazione successiva
- 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
- Utilizza il filtro etichetta impostato su
Unannotatedper identificare immagini senza etichetta - Escludi le immagini non annotate dalla configurazione dell'addestramento
Quali attività supportano l'annotazione SAM ?
L'annotazione SAM è disponibile per detect, segmente OBB. Le attività di classificazione e posa utilizzano solo annotazioni manuali.