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.

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 | Modelli di scheletro (Persona, Mano, Volto, Cane, Scatola, personalizzato) |
| 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 il tuo strumento di annotazione dalla barra degli strumenti
- Disegna annotazioni sull'immagine
- Clicca
Saveal termine

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 il task | V |
| Intelligente | Annotazione interattiva basata su SAM (detect/segment/obb) | S |
Strumenti di Annotazione Manuale
Bounding Box (detect)
Disegna riquadri rettangolari attorno agli oggetti:
- Accedi alla modalità di 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
- Trascina le 8 maniglie degli angoli/bordi per ridimensionare
- Trascina il centro per spostare
- Premi
DeleteoppureBackspaceper rimuovere l'annotazione selezionata
Poligono (segment)
Disegna maschere poligonali precise:
- Accedi alla modalità di modifica e seleziona
Draw - Clicca per aggiungere vertici
- Fai clic 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)
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.
- Accedi alla modalità di modifica e seleziona
Draw - Scegli un modello di scheletro dal selettore di modelli nella barra degli strumenti

- Clicca sull'immagine per posizionare tutti i keypoint contemporaneamente
- Trascina i singoli keypoint per regolare le loro posizioni
- Premi
Enterper confermare oEscapeper annullare
Modelli di scheletro integrati
L'editor include 5 modelli predefiniti:
| Modello | Punti chiave | Descrizione |
|---|---|---|
| Persona | 17 | Posa umana COCO — naso, occhi, orecchie, spalle, gomiti, polsi, anche, ginocchia, caviglie |
| Mano | 21 | Landmark della mano MediaPipe — articolazioni di polso, pollice, indice, medio, anulare, mignolo |
| Volto | 68 | Punti di riferimento facciali iBUG 300W — mascella, sopracciglia, naso, occhi, bocca |
| Cane | 18 | Pose di animali — naso, testa, collo, spalle, zampe, coda |
| Riquadro | 4 | Punti chiave angolari — in alto a sinistra, in alto a destra, in basso a destra, in basso a sinistra |

Modelli di scheletro personalizzati
Crea template personalizzati per qualsiasi struttura di posa:
- Clicca il pulsante + accanto al selettore del modello
- Opzionalmente, clicca su Inizia da... per caricare keypoint e connessioni da un modello esistente come punto di partenza
- Posiziona i keypoint sulla tela cliccando
- Nomina ogni keypoint e personalizza i colori
- Collega i punti chiave selezionando due punti (le connessioni vengono disegnate automaticamente man mano che si posizionano i punti chiave in sequenza)
- Salva il modello per il riutilizzo su tutto il tuo dataset

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:
- Accedi alla modalità di modifica e seleziona
Draw - Cliccare e trascinare per disegnare un box iniziale
- Utilizzare la maniglia di rotazione per regolare l'angolo
- Trascina le maniglie degli angoli per ridimensionare
- Seleziona una classe dal menu a discesa

Classificazione (classify)
Assegnare etichette di classe a livello di immagine:
- Accedi alla modalità di modifica
- Appare 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
Segment Anything Model (SAM) consente l'annotazione intelligente con pochi clic. La modalità smart è disponibile per i task di detect, segment e OBB.
- Accedi alla modalità di modifica e seleziona
Smarto premiS - 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, o abilitare applicazione automatica per flussi di lavoro con un solo clic

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/Optionper 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
Shiftmentre 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 + Shift | Posiziona prima più punti, la maschera viene applicata al rilascio |
| Applicazione Automatica DISATTIVATA | Posizionare i punti liberamente, premere Enter per applicare |

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:
| Modello | Dimensione | Velocità | Note |
|---|---|---|---|
| SAM 2.1 Tiny | 74,5 MB | Il più Veloce | |
| SAM 2.1 Small | 88 MB | Veloce | Predefinito |
| SAM 2.1 Base | 154 MB | Moderata | |
| SAM 2.1 Large | 428 MB | Più lenta | Più accurato di SAM 2.1 |
| SAM 3 | 3,45 GB | La più lenta | Ultima generazione, novità 2025 |

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
Entersu una corrispondenza esatta per selezionarla, o creare una nuova classe se non esiste alcuna corrispondenza. - Crea nuova classe in linea: Clicca
Add classin fondo alla lista, digita un nome e, facoltativamente, scegli un colore personalizzato. PremiEnterda 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-9per selezionare rapidamente le prime 9 classi.
Menu Contestuale
Fai clic destro sulle annotazioni selezionate per aprire un menu contestuale con:
| Azione | Scorciatoia |
|---|---|
| Elimina annotazioni | Delete / Backspace |
| Porta in Primo Piano | Cmd/Ctrl+Shift+] |
| Invia in Secondo Piano | Cmd/Ctrl+Shift+[ |
| Porta Avanti | Cmd/Ctrl+] |
| Invia Indietro | Cmd/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/Disattiva | Descrizione |
|---|---|
| Annotazioni | Mostra o nascondi tutte le sovrapposizioni di annotazioni |
| Etichette delle classi | Mostra o nascondi le etichette dei nomi delle classi sulle annotazioni |
| Mostra pixel | Attiva/Disattiva il rendering pixelato per l'ispezione con zoom (a schermo intero) |
| Reticoli | Mostra cursore a croce con coordinate pixel (modalità modifica) |
| Miniature di navigazione | Mostra la striscia di miniature di navigazione (schermo intero) |
| Mostra tutto | Attiva/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
Deleteper rimuoverlo
Gestione della classe
Creazione di Classi
Definisci le classi di annotazione per il tuo dataset nel Classes scheda:
- Vai a
Classesscheda - Utilizzare il campo di input in basso per digitare un nome di classe
- Clicca
Addo premiEnter - Un colore viene assegnato automaticamente dalla palette 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 discesa delle classi, clicca
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 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:
| 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 | Zoom avanti/indietro |
Shift+Click | Annotazioni a selezione multipla |
Cmd/Ctrl+A | Selezionare tutte le annotazioni. |
| Scorciatoia | Azione |
|---|---|
V | Modalità disegno (manuale) |
S | Modalità intelligente (SAM) |
| Scorciatoia | Azione |
|---|---|
Click+Drag | Disegna il bounding box (detect/OBB) |
Click | Aggiungi punto poligono (segment) / Posiziona scheletro (pose) |
Right-click | Completa poligono / Aggiungi punto negativo SAM |
Shift + click/right-click | Posizionare più punti SAM prima di applicare (applicazione automatica attiva) |
A | Attiva/Disattiva applicazione automatica (modalità Smart) |
Enter | Completa poligono / Conferma posa / Salva annotazione SAM |
Escape | Annulla posa / Salva annotazione SAM / Deseleziona / Esci |
| Scorciatoia | Azione |
|---|---|
Cmd/Ctrl+] | Porta avanti |
Cmd/Ctrl+[ | Invia indietro |
Cmd/Ctrl+Shift+] | Porta in primo piano |
Cmd/Ctrl+Shift+[ | Invia in secondo piano |

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+ZoppureCmd/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:
- 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
- Utilizzare il filtro etichette impostato su
Unannotatedper 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.