Editor di annotazioni#

Ultralytics Platform include un editor di annotazione per etichettare immagini con riquadri delimitatori, poligoni, punti chiave, riquadri orientati e classificazioni. L'editor supporta il disegno manuale, l'annotazione intelligente basata su SAM e le previsioni di modelli YOLO compatibili.

graph TB
    subgraph Draw["Draw Mode"]
        A[Box]:::start & B[Polygon]:::start & C[Classify]:::start & D[Keypoint]:::start & E[OBB]:::start
    end
    subgraph AI["AI-Assisted"]
        F[SAM Smart]:::start
        G[YOLO Predict]:::start
    end
    Draw --> H[Save Labels]:::out
    AI --> H

    classDef start fill:#4CAF50,color:#fff
    classDef out fill:#9C27B0,color:#fff

Tipi di attività supportati#

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

Dettagli attività#

Iniziare#

Per annotare le immagini:

1. Vai al tuo dataset
2. Fai clic una volta su un'immagine per aprire l'editor di annotazione a schermo intero
3. Usa la modalità predefinita Draw o passa a Smart dove supportato
4. Seleziona una classe e aggiungi o regola le annotazioni direttamente sull'immagine
5. Passa a un'altra immagine o chiudi l'editor; le modifiche vengono salvate automaticamente dopo ogni modifica

Per i dataset che puoi modificare, i controlli di annotazione sono attivi non appena il visualizzatore a schermo intero si apre sul desktop. Non esiste una modalità di modifica separata o un pulsante Edit. Su dispositivi mobili, e quando non disponi dell'accesso di modifica, il visualizzatore a schermo intero è di sola lettura.

graph LR
    A[Open Dataset]:::start --> B[Click Image]:::proc
    B --> C[Annotate in Fullscreen]:::proc
    C --> D[Changes Auto-Save]:::out
    D --> E[Next Image]:::proc
    E --> B

    classDef start fill:#4CAF50,color:#fff
    classDef proc fill:#2196F3,color:#fff
    classDef out fill:#9C27B0,color:#fff

Modalità di annotazione#

Draw è la modalità predefinita per le attività di annotazione spaziale. Per i dataset di rilevamento, segmentazione, semantica e OBB, la barra degli strumenti fornisce anche la modalità Smart quando l'annotazione intelligente è disponibile:

L'annotazione della posa utilizza Draw con un modello di scheletro. La classificazione utilizza direttamente la barra laterale delle classi e non mostra la barra degli strumenti di disegno.

L'annotazione Smart non è attualmente disponibile per i dataset connessi.

Strumenti della modalità Draw#

Bounding Box (Detect)#

Disegna box rettangolari attorno agli oggetti:

1. Seleziona una classe nella barra laterale delle classi
2. Nella modalità predefinita Draw, fai clic e trascina per disegnare un rettangolo
3. Rilascia per completare il box

Poligono (Segment)#

Disegna maschere poligonali precise:

1. Seleziona una classe nella barra laterale delle classi
2. Nella modalità predefinita Draw, fai clic per aggiungere vertici, oppure tieni premuto Shift e muovi il mouse per disegnare a mano libera punti densi
3. Fai doppio clic, fai clic sul primo vertice o premi Enter o Escape per chiudere il poligono

Keypoint (Pose)#

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

1. Seleziona una classe nella barra laterale delle classi
2. Nella modalità predefinita Draw, scegli un modello di scheletro dal selettore di modelli nella barra degli strumenti
3. Clicca sull'immagine per posizionare tutti i keypoint in una volta sola
4. Trascina i singoli keypoint per regolare le loro posizioni

Template di scheletro integrati#

L'editor include 5 template integrati:

Modelli di scheletro personalizzati#

Crea modelli personalizzati per qualsiasi struttura di posa:

1. Clicca sul pulsante + accanto al selettore del modello
2. Opzionalmente, clicca su Inizia da... per caricare punti chiave e connessioni da un modello esistente come punto di partenza
3. Posiziona i punti chiave sulla tela cliccando
4. Dai un nome a ogni punto chiave e personalizza i colori
5. Collega i punti chiave selezionando due punti (le connessioni vengono disegnate automaticamente mentre posizioni i punti chiave in sequenza)
6. Salva il modello per riutilizzarlo in tutto il tuo set di dati

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

Oriented Bounding Box (OBB)#

Disegna riquadri ruotati per oggetti angolati:

1. Seleziona una classe nella barra laterale delle classi
2. Nella modalità predefinita Draw, fai clic e trascina per disegnare un riquadro iniziale
3. Usa la maniglia di rotazione per regolare l'angolo
4. Trascina le maniglie d'angolo per ridimensionare

Classificazione (Classify)#

Assegna etichette di classe a livello di immagine:

1. Fai clic su un'immagine per aprire l'editor a schermo intero
2. Seleziona una classe nella barra laterale delle classi o premi un tasto numerico da 1-9

Annotazione intelligente#

L'annotazione intelligente aggiunge un'annotazione assistita dal modello all'editor. In modalità Smart, puoi usare Segment Anything Model (SAM) per l'annotazione basata su clic oppure usare modelli Ultralytics YOLO pre-addestrati e i tuoi modelli YOLO ottimizzati per aggiungere previsioni come annotazioni. L'annotazione intelligente è disponibile per le attività detect, segment, semantic e OBB.

Annotazione intelligente SAM#

Con un modello SAM selezionato:

1. Seleziona Smart o premi S
2. Clicca sull'oggetto che vuoi annotare — SAM genera una maschera iniziale in tempo reale
3. Affina la maschera con ulteriori clic: clicca fuori dalla maschera corrente per aggiungere copertura, oppure clicca dentro la maschera corrente per sottrarre regioni
4. Premi Enter o Escape per salvare l'annotazione, oppure attiva auto-apply per flussi di lavoro con un solo clic

graph LR
    A[Press S]:::start --> B[Left-click Object]:::proc
    B --> C[SAM Generates Mask]:::proc
    C --> D{Auto-apply?}:::decide
    D -->|Yes| E[Mask Applied Automatically]:::out
    D -->|No| F{Accurate?}:::decide
    F -->|Yes| G[Enter to Save]:::out
    F -->|No| H[Add +/- Points]:::proc
    H --> C

    classDef start fill:#4CAF50,color:#fff
    classDef proc fill:#2196F3,color:#fff
    classDef decide fill:#FF9800,color:#fff
    classDef out fill:#9C27B0,color:#fff

L'annotazione intelligente SAM può generare:

• Poligoni per attività di segmentazione
• Riquadri di delimitazione per attività di rilevamento
• Riquadri orientati per attività OBB

Modalità di auto-applicazione#

La modalità di applicazione automatica velocizza l'annotazione intelligente salvando automaticamente la maschera SAM dopo ogni clic — non è necessario premere Enter. Attivala con il pulsante di applicazione automatica nella barra degli strumenti o premi A.

Selezione del modello SAM#

Quando la modalità Smart è attiva, nella barra degli strumenti appare un selettore di modelli. Sono disponibili cinque modelli SAM: scegli in base al compromesso tra velocità e precisione adatto al tuo set di dati:

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

Annotazione intelligente YOLO#

Con un modello YOLO selezionato, l'annotazione intelligente può aggiungere previsioni dai modelli Ultralytics preaddestrati o dai tuoi modelli ottimizzati.

1. Seleziona Smart o premi S
2. Seleziona un modello YOLO dal selettore di modelli nella barra degli strumenti (Official o My Models)
3. Fai clic su Predict
4. Rivedi le annotazioni aggiunte ed effettua le correzioni necessarie

Barra laterale delle classi#

L'editor di annotazioni include una barra laterale a scomparsa sul lato destro dell'area di lavoro. La barra fornisce:

• Cerca classi: Filtra l'elenco delle classi digitando nel campo di ricerca. Premi Enter su una corrispondenza esatta per selezionarla, oppure crea una nuova classe se non esiste alcuna corrispondenza.
• Crea una nuova classe inline: Fai clic su Add class in fondo all'elenco, digita un nome e facoltativamente scegli un colore personalizzato. Premi Enter per creare.
• Modifica nome classe in linea: Passa il cursore su un nome classe e fai clic sull'icona della matita per rinominarlo.
• Selettore colore: Fai clic sul campione di colore accanto a qualsiasi classe per cambiarne il colore.
• Conteggio annotazioni per classe: Ogni riga di classe mostra in apice il numero di annotazioni.
• Espandi/comprimi: Fai clic sulla freccia per espandere una classe e vedere le singole annotazioni elencate al suo interno.
• Evidenziazione bidirezionale al passaggio del mouse: Passare il mouse su un'annotazione nell'area di lavoro la evidenzia nella barra laterale, e viceversa. La barra laterale scorre automaticamente alla classe pertinente.
• Nascondi/mostra singole annotazioni: Fai clic sull'icona dell'occhio su qualsiasi riga di annotazione per attivare o disattivare la sua visibilità nell'area di lavoro.
• Elimina annotazioni: Fai clic 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 con il tasto destro sulle annotazioni selezionate per aprire un menu contestuale con:

Controlli di visibilità#

Il menu a discesa della visibilità (icona dell'occhio) ti consente di attivare la visualizzazione dei singoli elementi:

Cursore a mirino#

Durante l'annotazione, una sovrapposizione a reticolo traccia la posizione del cursore e visualizza le coordinate dei pixel sulla tela. Questo aiuta a posizionare le annotazioni con precisione. Attivalo tramite il menu a discesa della visibilità.

Anteprima al passaggio del mouse SAM#

In modalità Smart, SAM fornisce un'anteprima in tempo reale al passaggio del mouse prima che tu faccia clic su qualsiasi punto. Questa anteprima è disponibile per le attività detect, segment, semantic e OBB. Una volta aggiunti i clic di rifinitura, l'anteprima si aggiorna per riflettere la maschera corrente e il tipo di annotazione per l'attività attiva.

Modifica dei vertici dei poligoni#

Per le annotazioni di segmentazione, puoi modificare i vertici del poligono dopo averli disegnati:

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

Gestione delle classi#

Creazione di classi#

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

1. Vai alla scheda Classes
2. Usa il campo di input in basso per digitare un nome di classe
3. Fai clic su Add o premi Enter
4. Viene assegnato automaticamente un colore dalla tavolozza Ultralytics

Aggiungi nuova classe durante l'annotazione#

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

1. Disegna un'annotazione sull'immagine
2. Nella barra laterale delle classi, fai clic su Add class (o digita un nuovo nome nella casella di ricerca della barra laterale)
3. Inserisci il nome della classe
4. Premi Invio per creare e assegnare

Ciò consente un flusso di lavoro fluido in cui puoi definire le classi man mano che incontri nuovi tipi di oggetti nei tuoi dati.

Modifica delle classi#

• Rinomina: Fai clic su un nome classe nella tabella per modificarlo in linea
• Cambia colore: Fai clic sul campione di colore per aprire il selettore colore
• Cerca: Usa il campo di ricerca per filtrare le classi per nome
• Ordina: Fai clic sulle intestazioni di colonna per ordinare per indice, nome, conteggio annotazioni o conteggio immagini

Colori delle classi#

A ogni classe viene assegnato un colore dalla tavolozza di Ultralytics. Puoi personalizzare i colori usando il selettore di colori nella scheda Classes; i colori selezionati vengono usati in tutto quel dataset.

Scorciatoie da tastiera#

Annotazione efficiente con scorciatoie da tastiera:

Annulla/Ripristina#

L'editor di annotazione mantiene una cronologia completa di annullamento/ripristino:

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

La cronologia tiene traccia di:

• Aggiunta di annotazioni (singole e in blocco)
• Modifica di annotazioni (spostamento, ridimensionamento, rotazione)
• Eliminazione di annotazioni (singole e in blocco)
• Modifica delle classi (singole e in blocco)
• Riordino delle annotazioni (z-order)
• Modifica dei vertici del poligono (aggiunta, rimozione, spostamento)
• Spostamento dei punti chiave

Salvataggio delle annotazioni#

Le modifiche vengono salvate automaticamente un secondo dopo l'ultima modifica dell'annotazione. Vengono salvate anche quando passi a un'altra immagine o chiudi l'editor a schermo intero.

• Salva ora: Fai clic sul pulsante di salvataggio o premi Cmd/Ctrl+S
• Chiudi: Fai clic sul pulsante di chiusura, fai clic all'esterno dell'immagine o premi Escape; la chiusura attiva un salvataggio in background per le modifiche in sospeso

FAQ#

Quanto è accurata l'annotazione SAM?#

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

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

Per ottenere i migliori risultati, inizia con un clic sul centro dell'oggetto, quindi usa clic all'esterno della maschera per aggiungere copertura e clic all'interno della maschera per sottrarre oggetti vicini o lo sfondo.

Posso importare annotazioni esistenti?#

Sì, caricate il vostro dataset con file di etichette in formato YOLO. La Platform li analizza e li mostra automaticamente nell'editor.

Come annoto più oggetti della stessa classe?#

Dopo aver disegnato un'annotazione:

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

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

Posso addestrare su dataset parzialmente annotati?#

Sì, ma per ottenere i migliori risultati:

• Etichetta tutti gli oggetti delle tue classi target in ogni immagine
• Usa il filtro Annotations impostato su Unannotated per identificare le immagini che necessitano ancora di annotazione

Quale modello SAM dovrei usare?#

SAM 3 è il modello predefinito e di ultima generazione: inizia da lì per maschere di altissima qualità. Passa a SAM 2.1 Small per un flusso di lavoro interattivo più veloce su oggetti comuni, o a SAM 2.1 Large quando hai bisogno di una maggiore precisione della maschera su forme complesse. Usa SAM 2.1 Tiny per la massima velocità su oggetti semplici ad alto contrasto.

Quali attività supportano l'annotazione intelligente SAM?#

L'annotazione intelligente SAM è disponibile per le attività detect, segment, semantic e OBB. Le attività di classificazione e posa utilizzano solo l'annotazione manuale.

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

Sì. Fai clic sul pulsante + accanto al selettore del modello di scheletro per aprire l'editor di modelli. Posiziona i punti chiave, assegna loro un nome, disegna le connessioni e salva. I modelli personalizzati sono archiviati nel tuo account e disponibili per tutti i dataset di posa.

Come passo da un modello di scheletro all'altro?#

Fai clic sul menu a discesa del selettore del modello nella barra degli strumenti di annotazione. Seleziona qualsiasi modello integrato (Persona, Mano, Viso, Cane, Scatola) o i tuoi modelli personalizzati salvati. Il modello selezionato determina quali punti chiave vengono posizionati quando fai clic sull'immagine.