跳轉到

Annotazione Immagini

Il modulo Image Annotation è una delle funzionalità principali di ATSVisionOps. È progettato per l'ispezione dei difetti industriali e supporta un'annotazione delle immagini efficiente e ad alta precisione, oltre alla gestione dei dati.

picann.png picann7.png

💡: se le immagini sopra sono difficili da vedere, tieni premuto Ctrl e scorri la rotella del mouse per ingrandire.


Guida rapida

La prima volta che apri Annotazione immagini, una guida in 12 passaggi spiega come aprire una cartella, scegliere un’etichetta, disegnare il primo riquadro e usare la navigazione, la modifica, l’annullamento, gli strumenti per i dati e le impostazioni. Puoi usare gli strumenti mentre segui la guida o saltarla. Per rivederla, fai clic su Guida rapida in fondo al pannello sinistro.

1. Annotazione di Base e Cambio di Modalità

Il sistema supporta diversi formati di annotazione di visione industriale diffusi, che possono essere cambiati rapidamente tramite scorciatoie da tastiera.

  • Annotazione Rectangle: un bounding box orizzontale standard (BBox). Puoi trascinare il box nel modo tradizionale, oppure abilitare la modalità disegno a due clic (lo stesso comportamento di LabelMe).
  • Annotazione Polygon:
    • Campionamento automatico: i punti vengono aggiunti automaticamente in base a una logica combinata di tempo e distanza, insieme a un post-processing adattivo a due stadi della densità dei punti.
    • Posizionamento manuale dei punti: posiziona i punti con il tasto sinistro del mouse; premi Esc per annullare il poligono non finito punto per punto.
    • Logica di snapping: lo snapping si attiva solo quando il cursore si avvicina a un punto di connessione, garantendo l'accuratezza dell'annotazione su bordi complessi.
  • OBB rotated box: progettato specificamente per l'architettura YOLO26-OBB; condivide la stessa logica dell'annotazione regolare, quindi non c'è alcuna curva di apprendimento.

Scorciatoie da Tastiera

Premi il tasto [Q] per scorrere ciclicamente tra le diverse modalità di annotazione.

Annullamento Multi-Livello con Esc

Premendo Esc si annulla intelligentemente nel seguente ordine: annulla il poligono punto per punto → annulla il disegno → annulla il trascinamento / zoom / modifica vertici → annulla il trascinamento dell'immagine → annulla la selezione dell'annotazione. Annulla un livello alla volta e non "cancella mai tutto in una volta".


2. Un'Esperienza Operativa Più Comoda

⌨️ Riferimento Rapido per le Scorciatoie da Tastiera

Categoria Scorciatoia Funzione
Modalità di annotazione Q Scorri ciclicamente tra le modalità di annotazione
Undo / Redo Ctrl + Z / Ctrl + Y Undo / redo (uno stack separato per immagine, quindi gli stack non si mescolano mai tra immagini)
Elimina F Elimina le annotazioni selezionate (è supportata la multi-selezione nell'elenco e l'eliminazione in blocco)
Elimina Delete Cancella tutte le annotazioni sull'immagine corrente
Cambia immagine A / ← Immagine precedente
Cambia immagine D / → Immagine successiva
Annotazioni sovrapposte N / P Seleziona l'annotazione sovrapposta successiva / precedente
Visibilità H / Ctrl + H Nascondi / mostra tutte le annotazioni con un clic
Durante l'annullamento Esc Annullamento intelligente (vedi il riquadro di nota sopra)

🔍 Controllo della Vista e Zoom

  • Zoom sulla posizione del mouse: quando la rotella viene fatta scorrere, lo zoom è centrato sul punto attualmente puntato dal mouse.
  • Lente d'ingrandimento:
    • Mirino sincronizzato con la vista principale: una volta abilitate le guide a mirino, esse vengono visualizzate anche all'interno della lente d'ingrandimento.
    • Visualizzazione del valore dei pixel: la barra informativa inferiore mostra le coordinate, il rapporto di zoom, lo stato della guida e i valori dei pixel RGB / grayscale / RGBA.
    • Fallback in caso di errore: quando la conversione delle coordinate fallisce, l'immagine può ancora essere visualizzata, evitando una schermata nera.
  • Reset della vista: fai doppio clic consecutivamente con il tasto sinistro del mouse per resettare istantaneamente il rapporto di zoom e la posizione dell'immagine.
  • Trascinamento dell'immagine: Ctrl + trascinamento con il tasto sinistro del mouse; mentre tieni premuto ~ o `, tutta la logica di trascinamento e selezione è disabilitata (per prevenire clic errati).
  • Pan con il tasto centrale: puoi afferrare e spostare l'intera vista di annotazione direttamente con il tasto centrale del mouse.

3. Gestione e Personalizzazione delle Label

  • Sistema di preset: le configurazioni delle label possono essere salvate in un file JSON locale e vengono caricate automaticamente alla successiva apertura.
  • Numerazione rapida: l'elenco delle label mostra gli indici numerici, e i tasti numerici 1-9 possono essere utilizzati per selezionare rapidamente una classe.
  • Colori personalizzati: gli utenti possono personalizzare il colore di visualizzazione di ciascuna label, e si aggiorna in tempo reale nell'area di annotazione.
  • Trascina per riordinare: l'elenco delle label supporta il riordinamento tramite trascinamento con il mouse, e l'ordine viene persistito automaticamente.
  • Editing efficiente:
    • Popup nelle vicinanze: la casella di editing appare nella posizione del clic del mouse, riducendo grandi movimenti oculari.
    • Funzione di memoria: le modifiche alle label supportano l'inserimento manuale e sono dotate di una funzione di memoria.
    • Modifica bulk delle label: l'elenco delle annotazioni supporta la multi-selezione → modifica bulk dei nomi delle label.

4. Assistenza ai Dati

  • Sistema di guide:
    • Mirino: le linee di coordinate verticali / orizzontali vengono mostrate automaticamente durante il disegno dei box.
    • Visualizzazione delle coordinate: visualizzazione in tempo reale delle coordinate fisiche nella posizione corrente del mouse, del rapporto di zoom e dei valori RGB / grayscale (barra informativa della lente d'ingrandimento).
  • Elenco immagini intelligente:
    • Indicazione di stato: tre stati vengono riconosciuti automaticamente — annotato / annotazione vuota / non annotato:
      • ✅ Verde chiaro — ha annotazioni
      • ⚠️ Giallo chiaro — il JSON / TXT è un'annotazione vuota
      • ⚪ Bianco — nessuna annotazione
    • Ordinamento naturale: img2.jpg viene automaticamente posizionato prima di img10.jpg.
    • Click destro per rinominare un'immagine: i corrispondenti .json e .txt vengono rinominati in modo sincronizzato, e il campo imagePath all'interno del JSON viene aggiornato automaticamente.
    • Clicca per aprire la directory: il percorso nell'elenco viene evidenziato; cliccandolo si apre direttamente la directory.
  • Sposta immagini in una cartella di destinazione: la voce "📁 Move to Folder" nel menu contestuale supporta cartelle di destinazione personalizzate (utilizzate per ordinare rapidamente campioni come OK / NG).
  • Auto Classification: con un clic, le immagini vengono ordinate in classified_results/<label>/ per label JSON; le immagini multi-label vanno in Multi_class, le immagini non annotate vanno in Null_Pictures; sono supportati multi-threading + barra di avanzamento + annullamento.
  • Crash recovery: se il software esce in modo anomalo, è supportato il recupero con un clic dello stato di lavoro precedente alla successiva apertura.

5. Impostazioni di Stile e Prestazioni

Gli utenti possono regolare con precisione lo stile di annotazione nel pannello delle impostazioni per adattarsi a diversi dispositivi di visualizzazione:

  • Punti di controllo: è possibile regolare la dimensione e lo stile dei punti di controllo ai quattro angoli di un rettangolo.
  • Spessore della linea: una larghezza della linea di annotazione globale (2px per impostazione predefinita); lo stato selezionato è evidenziato in blu-viola.
  • UI in scala di grigi: l'interfaccia utilizza un gradiente neutro in scala di grigi, che allevia notevolmente l'affaticamento visivo causato dal fissare lo schermo a lungo.

Per adattarsi alle abitudini operative di diversi utenti, ATSVisionOps fornisce un pannello delle impostazioni personalizzabile. Puoi utilizzarlo per regolare la sensazione dell'annotazione, lo stile visivo e il livello di automazione.


Panoramica del Pannello delle Impostazioni

Apri Impostazioni annotazioni nel pannello sinistro. Le cinque schede sono Zoom, Altre impostazioni, Stile annotazioni, Lente e Mirino. Il metodo di disegno e la conferma automatica si trovano in Altre impostazioni.


Impostazioni di Zoom

picann2.png

Controlla l'ancoraggio logico per lo zoom dell'immagine, in modo da poter adattare diverse abitudini di visualizzazione.

  • Centro dello zoom:
    • Centro dell'immagine: quando la rotella viene fatta scorrere, l'immagine zooma sempre attorno al suo centro geometrico.
    • Posizione del mouse: zooma attorno al pixel attualmente sotto il puntatore del mouse, rendendo facile "spingere" e ispezionare i dettagli di un difetto specifico.

Impostazioni di Stile

picann4.png

Gli utenti possono regolare liberamente lo stile di visualizzazione dei box di annotazione in base alla dimensione del difetto e alla complessità dello sfondo.

Impostazione Descrizione Opzioni / Intervallo
Spessore della linea Imposta la larghezza in pixel del contorno del box di annotazione 0.1px - 10px
Dimensione del manico Imposta la dimensione dei manici di controllo attorno al rettangolo 1px - 15px
Stile del manico Imposta la forma dei punti di controllo utilizzati per ridimensionare il box Circle, Square, Hidden

Strumenti di Assistenza

🔍 Impostazioni della Lente d'Ingrandimento

picann5.png

Osserva piccoli dettagli attraverso una finestra fluttuante senza modificare lo zoom globale.

  • Ingrandimento: regola l'ingrandimento dell'immagine all'interno della lente d'ingrandimento.
  • Dimensione della finestra: regola il diametro / la dimensione della finestra fluttuante della lente d'ingrandimento.

🎯 Impostazioni del Mirino

picann6.png

  • Visualizzazione delle coordinate: quando abilitata, le coordinate pixel correnti vengono visualizzate in tempo reale all'intersezione del mirino, il che aiuta con l'allineamento preciso.

Automazione e Abitudini (Workflow)

picann3.png

Funzione di Memoria

  • Ricorda la posizione dello zoom:
    • On: quando si passa all'immagine successiva, il sistema applica automaticamente il rapporto di zoom e l'offset di pan dell'immagine precedente.
    • Caso d'uso: adatto per l'ispezione di difetti in batch in cui il materiale rimane in una posizione fissa, quindi non c'è bisogno di regolare la vista immagine per immagine.

Ottimizzazione dell'Interazione

  • Auto-conferma delle annotazioni:
    • On: le annotazioni vengono salvate direttamente al completamento, e la finestra di conferma della label non appare più.
    • Off: una finestra di dialogo appare dopo ciascuna annotazione, rendendo facile per l'utente ricontrollare la classe della label.

Logica di Annotazione

  • Modalità disegno a due clic:
    • On: la logica di annotazione del rettangolo è la stessa di LabelMe.
    • Off: ripristina la logica di annotazione del rettangolo di ATSVisionOps.

Annotazioni Sovrapposte e Multi-Selezione

  • Sottomenu annotazione sovrapposta: facendo click destro su un'area sovrapposta appare il sottomenu "✏️ Edit Annotation / 🗑️ Delete Annotation"; ciascuna annotazione è distinta da Label (Type) più un'icona colorata.
  • Tasti N / P: scorrono rapidamente attraverso l'elemento selezionato tra annotazioni sovrapposte.
  • Multi-selezione nell'elenco: l'elenco delle annotazioni sulla destra supporta la multi-selezione Ctrl / Shift; il tasto F elimina la selezione in blocco con un clic.

Cartelle di Destinazione Personalizzate (Click Destro su un'Immagine → Move to Folder)

Adatto per ordinare rapidamente dataset su larga scala (come OK / NG / rilavorazione / in attesa di revisione):

  1. Click destro su qualsiasi immagine → 📁 Move to Folder → ⚙️ Manage Target Folders.
  2. Aggiungi / modifica / elimina i nomi delle cartelle di destinazione nella finestra di dialogo.
  3. Successivamente, fai click destro su un'immagine e scegli direttamente una cartella di destinazione; immagine + JSON + TXT vengono spostati insieme, e un conflitto di nomi chiede di confermare la sovrascrittura.

Utilizzato al meglio insieme all'auto classification

L'auto classification emette in classified_results/; la funzionalità Move to Folder con click destro è adatta per la fase di revisione finale manuale, permettendoti di estrarre i campioni che il modello trova difficili da giudicare e di metterli da parte.


📂 Auto Classification (basata su annotazioni JSON)

Il pulsante "📂 Auto Classification" sotto le operazioni avanzate:

  • Crea una directory di output classified_results/ nella directory delle immagini corrente.
  • Esegue in background con thread multipli; sono supportati una barra di avanzamento e l'annullamento.
  • Regole di classificazione:
    • Singola label → <label>/
    • Label multiple → Multi_class/
    • Nessun JSON / annotazione vuota → Null_Pictures/
  • Al completamento, una finestra di dialogo mostra le statistiche: classificati, multi-classe, non annotati, errori, totale.
  • Supporta la verifica del conteggio dei file, per garantire che il totale rimanga coerente prima e dopo la classificazione (prevenendo la perdita di immagini).

Questa operazione è irreversibile

L'auto classification sposta invece di copiare. Il JSON/TXT originale va nella cartella di classificazione insieme all'immagine, quindi conferma di non aver bisogno di mantenere la struttura originale prima di classificare.


Persistenza delle Impostazioni

Tutte le modifiche alle impostazioni hanno effetto in tempo reale e vengono salvate automaticamente in un file di configurazione locale. Quando il software si avvia la volta successiva, continua con la tua configurazione personalizzata, e non c'è bisogno di configurare nuovamente.

Avvio Rapido

  1. Importa una singola immagine o una cartella.
  2. Usa Q per selezionare una modalità, e disegna le annotazioni con il mouse.
  3. Le annotazioni vengono salvate appena le completi (conferma se richiesto) o le modifichi. Puoi anche premere Ctrl+S per salvare manualmente le annotazioni dell’immagine corrente.
  4. Clicca su COCO Conversion o Defect Analysis nella barra degli strumenti sulla destra.

Annotazione automatica (componenti opzionali)

  1. Passa alla modalità JSON e apri Annotazione automatica nella barra sinistra.
  2. Seleziona Installa componente e scegli lo ZIP completo. I componenti GPU sono più grandi e opzionali. Non servono Trainer o la configurazione del percorso Python.
  3. Seleziona architettura, attività, CPU/GPU e modello locale, quindi caricalo. I modelli moderni usano PT o ONNX. Quelli classici richiedono la cartella di esportazione completa con modello, parametri, configurazione e nomi delle classi; il solo .pdparams non basta.
  4. Riconosci l’immagine corrente e, al termine, scegli Aggiungi e salva. I riquadri esistenti rimangono. Puoi correggere o annullare i risultati nell’area di annotazione. Chiudendo la finestra inattiva, il modello rimane caricato per questa sessione; Interrompi lo scarica.
  5. L’elaborazione in serie crea JSON omonimi solo per immagini senza file JSON/TXT. Le annotazioni esistenti vengono saltate. Interruzioni ed errori conservano i file completati. Verifica ogni immagine; non è possibile annullare l’intero lotto in un solo passaggio.

I componenti sono disponibili nella pagina di download. Dopo aver caricato il modello, chiudi la finestra e premi F8 nella pagina di annotazione per riconoscere, aggiungere e salvare; puoi annullare il risultato. Disinstalla componente libera spazio conservando modelli e annotazioni.

Rilevamento, segmentazione e riquadri orientati usano le forme esistenti. La classificazione viene salvata come categoria dell’immagine, senza riquadri fittizi; il pulsante della categoria permette di modificarla o cancellarla. ONNX usa attualmente CPU. La soglia di sovrapposizione classica dipende dal modello esportato. Un rilevamento senza oggetti crea JSON vuoto; una classificazione sotto soglia viene saltata.