Editor di annotazioni

Ultralytics Platform include un potente editor di annotazioni per etichettare le immagini con bounding box, poligoni, keypoint, box orientati e classificazioni. L'editor supporta il disegno manuale e l'annotazione intelligente 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à supportate

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

Dettagli del task

Introduzione

Per annotare le immagini:

1. Naviga verso il tuo dataset
2. Clicca su un'immagine per aprire il visualizzatore a schermo intero
3. Clicca su Edit per entrare in modalità annotazione
4. Seleziona il tuo strumento di annotazione dalla barra degli strumenti
5. Disegna le annotazioni sull'immagine
6. Clicca su Save quando hai 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 fornisce due modalità di annotazione, selezionabili dalla barra degli strumenti:

Strumenti di annotazione manuale

Bounding Box (Rilevamento)

Disegna box rettangolari attorno agli oggetti:

1. Entra in modalità di modifica e seleziona Draw
2. Clicca e trascina per disegnare un rettangolo
3. Rilascia per completare il box
4. Seleziona una classe dal menu a tendina

Poligono (Segmentazione)

Disegna maschere poligonali precise:

1. Entra in modalità di modifica e seleziona Draw
2. Clicca per aggiungere vertici, oppure tieni premuto Shift e sposta il mouse per disegnare a mano libera punti densi
3. Clicca sul primo vertice, oppure premi Enter o Escape per chiudere il poligono
4. Seleziona una classe dal menu a tendina

Keypoint (Posa)

Annota le pose usando i template di scheletri. 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. Entra in modalità di modifica e seleziona Draw
2. Scegli un template di scheletro dal selettore di template nella barra degli strumenti

3. Clicca sull'immagine per posizionare tutti i keypoint in una volta
4. Trascina i singoli keypoint per regolare le loro posizioni
5. Premi Enter per confermare o Escape per annullare

Template di scheletri 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. Facoltativamente, clicca su Start from... per caricare keypoint e connessioni da un modello esistente come punto di partenza
3. Posiziona i keypoint sulla tela cliccando
4. Dai un nome a ogni keypoint e personalizza i colori
5. Collega i keypoint selezionando due punti (le connessioni vengono disegnate automaticamente man mano che posizioni i keypoint in sequenza)
6. Salva il modello per riutilizzarlo in tutto il tuo dataset

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

Oriented Bounding Box (OBB)

Disegna box ruotati per oggetti angolati:

1. Entra in modalità di modifica e seleziona Draw
2. Clicca e trascina per disegnare un box iniziale
3. Usa la maniglia di rotazione per regolare l'angolo
4. Trascina le maniglie d'angolo per ridimensionare
5. Seleziona una classe dal menu a tendina

Classificazione (Classify)

Assegna etichette di classe a livello di immagine:

1. Entra in modalità modifica
2. Appare un pannello laterale con i pulsanti di selezione della classe
3. Clicca sui pulsanti della classe o premi i tasti numerici 1-9

Smart Annotation

La Smart Annotation aggiunge l'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 preaddestrati e i tuoi modelli YOLO ottimizzati per aggiungere previsioni come annotazioni. La Smart Annotation è disponibile per le attività detect, segment e OBB.

SAM Smart Annotation

Con un modello SAM selezionato:

1. Entra in modalità modifica e seleziona Smart o premi S
2. Clicca sull'oggetto che desideri annotare: SAM genera una maschera iniziale in tempo reale
3. Rifinisci la maschera con clic aggiuntivi: clicca fuori dalla maschera corrente per aggiungere copertura, o clicca dentro la maschera corrente per sottrarre regioni
4. Premi Enter o Escape per salvare l'annotazione, oppure abilita auto-apply 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

La Smart Annotation di SAM può generare:

• Poligoni per attività di segmentazione
• Bounding box per attività di rilevamento
• Box orientati per attività OBB

Modalità Auto-Apply

La modalità Auto-apply velocizza la Smart Annotation salvando automaticamente la maschera SAM dopo ogni clic: non c'è bisogno di premere Enter. Attivala con il pulsante auto-apply nella barra degli strumenti o premi A.

Selezione modello SAM

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

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

YOLO Smart Annotation

Con un modello YOLO selezionato, la Smart Annotation può aggiungere previsioni da modelli Ultralytics preaddestrati o dai tuoi modelli ottimizzati.

1. Entra in modalità modifica e seleziona Smart o premi S
2. Seleziona un modello YOLO dal selettore nella barra degli strumenti (Official o My Models)
3. Clicca su Predict
4. Rivedi le annotazioni aggiunte e apporta le correzioni necessarie

Barra laterale delle classi

L'editor di annotazione include una barra laterale delle classi comprimibile sul lato destro della tela. La barra laterale fornisce:

• Cerca classi: Filtra l'elenco delle classi scrivendo nel campo di ricerca. Premi Enter su una corrispondenza esatta per selezionarla, o crea una nuova classe se non esiste alcuna corrispondenza.
• Crea nuova classe inline: Clicca su Add class in fondo all'elenco, digita un nome e facoltativamente scegli un colore personalizzato. Premi Enter per creare.
• Modifica nome classe inline: Passa il mouse sopra il nome di una classe e clicca sull'icona della matita per rinominarla.
• 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: Passare il mouse sopra un'annotazione sulla tela la evidenzia nella barra laterale, e viceversa. La barra laterale scorre ed espande 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à sul canvas.
• 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 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 o disattivare la visualizzazione dei singoli elementi:

Cursore a mirino

In modalità modifica, un overlay a mirino traccia la posizione del cursore e visualizza le coordinate dei pixel sul canvas. Questo aiuta a posizionare le annotazioni con precisione. Attivalo tramite il menu a discesa della visibilità.

Anteprima al passaggio del mouse con SAM

In modalità Smart, SAM fornisce un'anteprima in tempo reale al passaggio del mouse prima di fare clic su qualsiasi punto. Questa anteprima è disponibile per le attività di detect, segment 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 vertici poligono

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

• Sposta vertici: Trascina una maniglia del vertice per riposizionarlo
• 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 il nome di una classe
3. Fai clic su Add o premi Enter
4. Un colore viene assegnato automaticamente dalla tavolozza Ultralytics

Aggiungi nuova classe durante l'annotazione

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

1. Disegna un'annotazione sull'immagine
2. Nel menu a discesa delle classi, fai clic su Add New Class
3. Inserisci il nome della classe
4. Premi Invio per creare e assegnare

Questo 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 sul nome di una 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 nome, numero di etichette o numero di immagini

Colori delle classi

A ogni classe viene assegnato un colore dalla tavolozza Ultralytics. Puoi personalizzare i colori utilizzando il selettore colore nella scheda Classes. I colori sono coerenti in tutta la piattaforma per un facile riconoscimento.

Scorciatoie da tastiera

Annotazione efficiente con le scorciatoie da tastiera:

Annulla/Ripristina

L'editor di annotazione mantiene una cronologia completa di annulla/ripristina:

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

La cronologia tiene traccia di:

• Aggiunta di annotazioni (singole e in blocco)
• Modifica di annotazioni (sposta, ridimensiona, ruota)
• Eliminazione di annotazioni (singole e in blocco)
• Modifica delle classi (singole e in blocco)
• Riordinamento delle annotazioni (ordine Z)
• Modifica dei vertici del poligono (aggiungi, rimuovi, sposta)
• Spostamento dei punti chiave

Salvataggio delle annotazioni

Le annotazioni vengono salvate quando clicchi su Save o premi Cmd/Ctrl+S:

• Salva: clicca sul pulsante di salvataggio o premi Cmd/Ctrl+S
• Annulla: clicca su annulla per scartare le modifiche
• Escape: salva se ci sono modifiche non salvate, altrimenti esce dalla modalità di modifica

FAQ

Quanto è accurata l'annotazione SAM?

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

• Distinguibilità 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 i clic fuori maschera per aggiungere copertura e i clic dentro la maschera per sottrarre oggetti vicini o lo sfondo.

Posso importare annotazioni esistenti?

Sì, carica il tuo dataset con i file di etichette in formato YOLO. La piattaforma analizza e visualizza automaticamente le etichette 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 modelli su dataset parzialmente annotati?

Sì, ma per risultati ottimali:

• Etichetta tutti gli oggetti delle tue classi target in ogni immagine
• Usa il filtro delle etichette impostato su Unlabeled per identificare le immagini che devono ancora essere annotate
• Le immagini non etichettate sono escluse dall'addestramento; solo le immagini etichettate contribuiscono alla loss

Quale modello SAM dovrei usare?

SAM 3 è il modello predefinito e di ultima generazione: parti da lì per maschere della massima qualità. Passa a SAM 2.1 Small per un workflow interattivo più rapido su oggetti comuni, oppure a SAM 2.1 Large quando hai bisogno di maggiore precisione sulle maschere per 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 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ì. Clicca sul pulsante + accanto al selettore dei modelli di scheletro per aprire l'editor dei modelli. Posiziona i punti chiave, assegna loro un nome, disegna le connessioni e salva. I modelli personalizzati vengono archiviati nel tuo account e sono disponibili su tutti i dataset di posa.

Come passo da un modello di scheletro all'altro?

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