Link to this sectionEditor di annotazioni#

Ultralytics Platform 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 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

Link to this sectionTipi di attività supportati#

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

Link to this sectionDettagli attività#

Link to this sectionIniziare#

Per annotare le immagini:

1. Vai al 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

Link to this sectionModalità di annotazione#

L'editor fornisce due modalità di annotazione, selezionabili dalla barra degli strumenti:

Link to this sectionStrumenti di annotazione manuale#

Link to this sectionBounding Box (Detect)#

Disegna box rettangolari attorno agli oggetti:

1. Entra in modalità 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

Link to this sectionPoligono (Segment)#

Disegna maschere poligonali precise:

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

Link to this sectionKeypoint (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. Entra in modalità 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 sola
4. Trascina i singoli keypoint per regolare le loro posizioni
5. Premi Enter per confermare o Escape per annullare

Link to this sectionTemplate di scheletro integrati#

L'editor include 5 template integrati:

Link to this sectionModelli 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 set di dati di posa.

Link to this sectionOriented Bounding Box (OBB)#

Disegna riquadri ruotati per oggetti angolati:

1. Entra in modalità modifica e seleziona Draw
2. Clicca 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
5. Seleziona una classe dal menu a tendina

Link to this sectionClassificazione (Classify)#

Assegna etichette di classe a livello di immagine:

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

Link to this sectionAnnotazione intelligente#

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

Link to this sectionAnnotazione intelligente SAM#

Con un modello SAM selezionato:

1. Entra in modalità modifica e 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 abilita l'auto-applicazione 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

L'annotazione intelligente SAM può generare:

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

Link to this sectionModalità di auto-applicazione#

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

Link to this sectionSelezione 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:

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

Link to this sectionAnnotazione intelligente YOLO#

Con un modello YOLO selezionato, l'annotazione intelligente può aggiungere previsioni dai 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 di modelli nella barra degli strumenti (Official o My Models)
3. Clicca su Predict
4. Rivedi le annotazioni aggiunte ed effettua le correzioni necessarie

Link to this sectionBarra 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 nuova classe in linea: Fai clic su Add class in fondo all'elenco, digita un nome e scegli facoltativamente 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.

Link to this sectionMenu contestuale#

Fai clic con il tasto destro sulle annotazioni selezionate per aprire un menu contestuale con:

Link to this sectionControlli di visibilità#

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

Link to this sectionCursore a mirino#

In modalità modifica, una sovrapposizione a mirino traccia la posizione del cursore e visualizza le coordinate dei pixel sull'area di lavoro. Ciò aiuta a posizionare le annotazioni con precisione. Attivalo tramite il menu a discesa della visibilità.

Link to this sectionAnteprima 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.

Link to this sectionModifica 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

Link to this sectionGestione delle classi#

Link to this sectionCreazione 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

Link to this sectionAggiungi 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.

Link to this sectionModifica 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

Link to this sectionColori delle classi#

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

Link to this sectionScorciatoie da tastiera#

Annotazione efficiente con scorciatoie da tastiera:

Link to this sectionAnnulla/Ripristina#

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

• Annulla: Cmd/Ctrl+Z
• Ripristina: 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

Link to this sectionSalvataggio delle annotazioni#

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

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

Link to this sectionFAQ#

Link to this sectionQuanto è 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.

Link to this sectionPosso importare annotazioni esistenti?#

Sì, carica il tuo dataset con file di etichette in formato YOLO. La piattaforma li analizza e visualizza automaticamente nell'editor.

Link to this sectionCome 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.

Link to this sectionPosso 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
• Le immagini non etichettate sono escluse dall'addestramento; solo le immagini etichettate contribuiscono alla perdita

Link to this sectionQuale 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.

Link to this sectionQuali 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.

Link to this sectionPosso 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.

Link to this sectionCome 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.