Editor delle annotazioni#

Ultralytics Platform include un editor delle annotazioni per etichettare immagini con riquadri di delimitazione, poligoni, punti chiave e classificazioni. L'editor supporta il disegno manuale, le annotazioni intelligenti basate su SAM e le predizioni dei modelli YOLO compatibili.

graph TB
    subgraph Draw["Shape set by the dataset task"]
        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 task supportati#

L'editor delle annotazioni fornisce strumenti di annotazione per 6 tipi di attività YOLO:

La verità a terra della profondità è una mappa associata che carichi, non qualcosa che disegni, quindi l'editor si apre in sola lettura su un dataset di profondità.

Dettagli dell'attività#

Per iniziare#

Per annotare le immagini:

1. Vai al tuo dataset
2. Fai clic una volta su un'immagine per aprire l'editor delle annotazioni a schermo intero
3. Usa la modalità predefinita Draw oppure passa a Smart dove supportata
4. Seleziona una classe e aggiungi o modifica direttamente le annotazioni 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 per le annotazioni sono attivi non appena il visualizzatore a schermo intero si apre sul desktop. Non esiste una modalità di modifica separata né un pulsante Edit. Su dispositivi mobili e quando non disponi dell'accesso alla modifica, il visualizzatore a schermo intero è in 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 detect, segment, semantic, pose e OBB, la barra degli strumenti fornisce anche la modalità Smart quando l'annotazione intelligente è disponibile:

L'annotazione di pose utilizza Draw con un modello di scheletro; la sua modalità Smart offre solo modelli di pose YOLO, senza selettore SAM o attivazione automatica. La classificazione utilizza direttamente la barra laterale delle classi e non mostra alcuna barra degli strumenti di disegno o pulsante Smart.

L'annotazione intelligente non è attualmente disponibile per i dataset connessi supportati da archiviazione cloud o On Premise.

Strumenti della modalità Disegna#

Riquadro di delimitazione (rilevamento)#

Disegna riquadri 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 riquadro

Poligono (segmentazione)#

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 sposta il mouse per disegnare a mano libera punti ravvicinati
3. Fai doppio clic, fai clic sul primo vertice oppure premi Enter o Escape per chiudere il poligono

Punto chiave (posa)#

Annota le pose usando modelli di scheletro. Seleziona un modello dalla barra degli strumenti, fai clic una volta per posizionare tutti i punti chiave, quindi trascina i singoli punti chiave per modificarne la posizione.

1. Seleziona una classe nella barra laterale delle classi
2. Nella modalità predefinita Draw, scegli un modello di scheletro dal selettore dei modelli nella barra degli strumenti
3. Fai clic sull'immagine per posizionare tutti i punti chiave contemporaneamente
4. Trascina i singoli punti chiave per modificarne la posizione

Modelli di scheletro integrati#

L'editor include 5 modelli integrati:

Modelli di scheletro personalizzati#

Crea modelli personalizzati per qualsiasi struttura della posa:

1. Fai clic sul pulsante + accanto al selettore dei modelli
2. Facoltativamente, fai clic su Inizia da... per caricare keypoint e connessioni da un modello esistente come punto di partenza
3. Posiziona i keypoint sulla tela facendo clic
4. Assegna un nome a ogni keypoint e personalizza i colori
5. Collega i keypoint selezionando due punti (le connessioni vengono tracciate automaticamente quando posizioni keypoint in sequenza)
6. Salva il modello per riutilizzarlo nel tuo dataset

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

Riquadro di delimitazione orientato (OBB)#

Disegna riquadri ruotati per gli 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 agli angoli 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 oppure premi un tasto numerico da 1-9

Annotazione intelligente#

L'annotazione intelligente aggiunge l'annotazione assistita da modello all'editor. In modalità Smart, puoi usare Segment Anything Model (SAM) per l'annotazione basata su clic oppure utilizzare modelli YOLO preaddestrati di Ultralytics e i tuoi modelli YOLO ottimizzati per aggiungere previsioni come annotazioni. L'annotazione intelligente SAM è disponibile per le attività detect, segment, semantic e OBB; l'annotazione intelligente YOLO copre anche pose.

Annotazione intelligente con SAM#

Con un modello SAM selezionato:

1. Seleziona Smart oppure premi S
2. Fai clic sull'oggetto che vuoi annotare: SAM genera una maschera iniziale in tempo reale
3. Raffina la maschera con altri clic: fai clic fuori dalla maschera corrente per aggiungere copertura oppure fai clic dentro la maschera corrente per sottrarre aree
4. Premi Enter oppure 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 i task di segmentazione
• Riquadri di delimitazione per i task di rilevamento
• Riquadri orientati per i task OBB

Modalità Auto-Apply#

La modalità auto-apply velocizza l'annotazione intelligente salvando automaticamente la maschera SAM dopo ogni clic: non è necessario premere Enter. Attivala o disattivala con il pulsante auto-apply nella barra degli strumenti oppure premi A.

Selezione del modello SAM#

Quando la modalità Smart è attiva, nella barra degli strumenti compare un selettore di modelli. Sei modelli SAM sono disponibili: scegli in base al compromesso tra velocità e precisione più 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 predizioni da modelli Ultralytics pretrained o dai tuoi modelli fine-tuned.

1. Seleziona Smart oppure premi S
2. Seleziona un modello YOLO dal selettore dei modelli nella barra degli strumenti (Official o My Models)
3. Fai clic su Predict
4. Controlla le annotazioni aggiunte e apporta le correzioni necessarie

Annotazione in batch#

L'annotazione in batch esegue un modello YOLO su un intero dataset anziché sull'immagine aperta. Aprila dalla pagina del dataset con Altre azioni > Annotazione in batch, oppure dall'azione Inference All sul popup dopo una previsione YOLO nell'editor. È disponibile per gli editor di dataset sui dataset ospitati su Platform con un massimo di tre canali di immagine, per ogni attività tranne la profondità.

1. Seleziona un modello dal selettore (Official o My Models)
2. Regola i cursori di confidenza (predefinito 0.25) e IoU (predefinito 0.7): la striscia Test run mostra ciò che il modello trova su alcune immagini di esempio mentre li sposti
3. Attiva Include annotated images per eseguire l'operazione anche sulle immagini che hanno già etichette; l'esecuzione aggiunge ciò che il modello trova e mantiene le etichette esistenti
4. Rivedi il Estimated Cost e fai clic su Start

Per impostazione predefinita vengono annotate solo le immagini non etichettate e le etichette esistenti non vengono mai modificate. Un'esecuzione richiede le classi del dataset. Se le classi del modello differiscono da quelle del dataset, un passaggio Map classes mappa ciascuna classe del modello a una classe del dataset o la salta, e su un dataset privo di classi le crea; l'esecuzione si avvia solo dopo l'esistenza delle classi. L'avvio di un'esecuzione salva prima una dataset version, in modo da poter ripristinare il dataset se il risultato non ti soddisfa.

La pagina del dataset mostra l'avanzamento dell'esecuzione e Stop conserva e addebita le immagini elaborate finora. Al termine dell'esecuzione, un riepilogo mostra le immagini elaborate e le annotazioni e classi aggiunte.

Barra laterale delle classi#

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

• 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 nuova classe in linea: fai clic su Add class in fondo all'elenco, inserisci un nome e, facoltativamente, scegli un colore personalizzato. Premi Enter per creare la classe.
• Modifica il nome della classe in linea: passa il mouse sul nome di una classe e fai clic sull'icona a forma di matita per rinominarla.
• Selettore dei colori: fai clic sul campione di colore accanto a qualsiasi classe per modificarne il colore.
• Numero di annotazioni per classe: ogni riga della classe mostra il numero in apice delle annotazioni.
• Espandi/comprimi: fai clic sul chevron per espandere una classe e visualizzare sotto di essa le singole annotazioni.
• Evidenziazione bidirezionale al passaggio del mouse: passando il mouse su un'annotazione sulla tela, questa viene evidenziata nella barra laterale e viceversa. La barra laterale scorre automaticamente fino alla classe pertinente.
• Nascondi/mostra un'intera classe: fai clic sull'icona a forma di occhio nella riga di una classe per nascondere o mostrare contemporaneamente tutte le annotazioni di quella classe.
• Nascondi/mostra singole annotazioni: fai clic sull'icona a forma di occhio in una riga qualsiasi delle annotazioni per alternarne la visibilità sulla tela.
• Elimina annotazioni: fai clic sull'icona del cestino in una riga qualsiasi delle annotazioni per eliminarla.
• Scorciatoie da tastiera: premi 1-9 per selezionare rapidamente le prime 9 classi oppure H per attivare o disattivare la visibilità di tutte le annotazioni sull'immagine.

Menu contestuale#

Fai clic con il pulsante destro del mouse sulle annotazioni selezionate per aprire un menu contestuale con:

Controlli della visibilità#

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

Cursore a forma di mirino#

Durante l'annotazione, una sovrapposizione a forma di mirino segue la posizione del cursore e mostra le coordinate dei pixel sulla tela. Questo ti aiuta a posizionare con precisione le annotazioni. Puoi attivarla o disattivarla 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 che tu faccia clic su un punto qualsiasi. Questa anteprima è disponibile per le attività detect, segment, semantic e OBB. Dopo aver aggiunto clic di perfezionamento, l'anteprima si aggiorna per riflettere la maschera corrente e il tipo di annotazione dell'attività attiva.

Modifica dei vertici del poligono#

Per le annotazioni di segmentazione, puoi modificare i vertici del poligono dopo averlo disegnato:

• Sposta i vertici: trascina qualsiasi maniglia del vertice per riposizionarla
• Elimina i vertici: seleziona un vertice e premi Delete per rimuoverlo

Gestione delle classi#

Creazione delle 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 oppure premi Enter
4. Un colore viene assegnato automaticamente dalla tavolozza di Ultralytics

Aggiunta di una 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 (oppure digita un nuovo nome nella casella di ricerca della barra laterale)
3. Inserisci il nome della classe
4. Premi Invio per crearla e assegnarla

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 direttamente
• Cambia colore: fai clic sul campione di colore per aprire il selettore dei colori
• Cerca: usa il campo di ricerca per filtrare le classi in base al nome
• Ordina: fai clic sulle intestazioni delle colonne per ordinare per indice, nome, numero di annotazioni o numero di immagini

Colori delle classi#

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

Scorciatoie da tastiera#

Annotazione efficiente con le scorciatoie da tastiera:

Annulla/Ripristina#

L'editor delle annotazioni mantiene una cronologia completa delle operazioni di annullamento/ripristino:

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

La cronologia tiene traccia di:

• Aggiunta di annotazioni (singole e in batch)
• Modifica delle annotazioni (spostamento, ridimensionamento, rotazione)
• Eliminazione di annotazioni (singole e in batch)
• Modifica delle classi (singole e in batch)
• Riordinamento delle annotazioni (ordine z)
• Modifica dei vertici dei poligoni (aggiunta, rimozione, spostamento)
• Spostamento dei keypoint

Salvataggio delle annotazioni#

Le modifiche vengono salvate automaticamente un secondo dopo l'ultima modifica all'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 delle modifiche in sospeso

FAQ#