Come isolare gli oggetti segmentati con Ultralytics YOLO#

La segmentazione delle istanze produce una maschera precisa al pixel per ogni oggetto rilevato, consentendoti di estrarre ogni oggetto singolarmente dall'immagine. Questa guida mostra come trasformare i risultati della segmentazione di Ultralytics YOLO in oggetti isolati usando la Modalità di previsione e OpenCV, con uno sfondo nero uniforme oppure trasparente per il salvataggio in formato PNG.

Perché isolare gli oggetti segmentati?#

Estrarre i singoli oggetti da un'immagine abilita numerosi flussi di lavoro downstream:

• Rimozione dello sfondo per foto di prodotti, cataloghi o modifiche creative.
• Ritagli per oggetto per creare dataset di classificazione a partire dai rilevamenti.
• Elaborazione mirata affinché i passaggi successivi, come OCR, analisi del colore o misurazione, vedano solo l'oggetto e non la scena circostante.
• Esportazione in PNG trasparente per sovrapporre gli oggetti a nuovi sfondi.

La procedura funziona con qualsiasi modello di segmentazione Ultralytics YOLO e segue quattro fasi: esegui l'inferenza → estrai ogni contorno → isola l'oggetto → salva il risultato.

Esegui l'inferenza di segmentazione#

Installa le librerie necessarie, quindi carica un modello di segmentazione (il suffisso -seg, necessario per produrre le maschere) ed esegui la previsione sull'immagine di origine:

from ultralytics import YOLO

# Load a segmentation model
model = YOLO("yolo26n-seg.pt")

# Run inference on a source
results = model.predict(source="path/to/image.jpg")

Estrai i contorni degli oggetti#

Ogni elemento in results corrisponde a un'immagine e l'iterazione su un risultato restituisce un rilevamento alla volta. Per ogni rilevamento, copia l'immagine originale, leggi l'etichetta della classe e traccia il contorno della maschera dell'oggetto su una maschera binaria vuota. La regione bianca di questa maschera indica esattamente quali pixel appartengono all'oggetto.

Gli snippet di questa sezione e della successiva vengono eseguiti all'interno del ciclo di rilevamento riportato di seguito; lo script completo, pronto da copiare e incollare, si trova in Esempio completo.

from pathlib import Path

import cv2
import numpy as np

for r in results:
    img = np.copy(r.orig_img)
    img_name = Path(r.path).stem  # source image base-name

    # Iterate each detected object in the image
    for ci, c in enumerate(r):
        label = c.names[c.boxes.cls.tolist().pop()]  # class name

        # Build a binary mask and draw the object contour onto it
        b_mask = np.zeros(img.shape[:2], np.uint8)
        contour = c.masks.xy[0].astype(np.int32).reshape(-1, 1, 2)
        cv2.drawContours(b_mask, [contour], -1, (255, 255, 255), cv2.FILLED)

Isola l'oggetto#

Con la maschera binaria pronta, combinala con l'immagine originale. Esistono due stili comuni, a seconda dello sfondo che vuoi ottenere:

Scegli uno stile di isolamento

Sfondo neroSfondo trasparente

Converti la maschera in tre canali e mantieni solo i pixel che si sovrappongono all'oggetto. Tutto ciò che si trova fuori dal contorno diventa nero:

# Isolate object with a black background
mask3ch = cv2.cvtColor(b_mask, cv2.COLOR_GRAY2BGR)
isolated = cv2.bitwise_and(mask3ch, img)

Ritaglia al riquadro di delimitazione

Per mantenere solo la regione dell'oggetto invece dell'immagine a dimensione intera, suddividila in base al riquadro di delimitazione del rilevamento:

# Bounding box coordinates
x1, y1, x2, y2 = c.boxes.xyxy.cpu().numpy().squeeze().astype(np.int32)
# Crop the isolated image to the object region
iso_crop = isolated[y1:y2, x1:x2]

Salva il risultato (facoltativo)#

Sta a te decidere cosa fare con ogni oggetto isolato. Un passaggio successivo comune consiste nello scriverlo su disco per utilizzarlo in seguito:

# Save the isolated object to file
cv2.imwrite(f"{img_name}_{label}-{ci}.png", isolated)

Qui img_name è il nome base dell'immagine di origine, label è il nome della classe e ci è l'indice del rilevamento, quindi più istanze della stessa classe ricevono nomi file univoci. Sostituisci isolated con iso_crop se hai applicato il ritaglio facoltativo precedente.

Esempio completo#

Lo script seguente combina ogni passaggio in un unico blocco eseguibile. Per impostazione predefinita usa uno sfondo nero; sostituisci la singola riga contrassegnata con np.dstack([img, b_mask]) per ottenere invece un PNG trasparente:

from pathlib import Path

import cv2
import numpy as np

from ultralytics import YOLO

model = YOLO("yolo26n-seg.pt")
results = model.predict(source="path/to/image.jpg")

for r in results:
    img = np.copy(r.orig_img)
    img_name = Path(r.path).stem

    for ci, c in enumerate(r):
        label = c.names[c.boxes.cls.tolist().pop()]

        # Build a binary mask from the object contour
        b_mask = np.zeros(img.shape[:2], np.uint8)
        contour = c.masks.xy[0].astype(np.int32).reshape(-1, 1, 2)
        cv2.drawContours(b_mask, [contour], -1, (255, 255, 255), cv2.FILLED)

        # Isolate the object (black background)
        mask3ch = cv2.cvtColor(b_mask, cv2.COLOR_GRAY2BGR)
        isolated = cv2.bitwise_and(mask3ch, img)  # transparent PNG: isolated = np.dstack([img, b_mask])

        # Save or add your custom post-processing here
        cv2.imwrite(f"{img_name}_{label}-{ci}.png", isolated)

        # Optional: crop to the bounding box before saving
        # x1, y1, x2, y2 = c.boxes.xyxy.cpu().numpy().squeeze().astype(np.int32)
        # cv2.imwrite(f"{img_name}_{label}-{ci}.png", isolated[y1:y2, x1:x2])

Per utilizzarlo ripetutamente, inserisci il corpo del ciclo in una funzione, così potrai chiamarla su più immagini.

Conclusioni#

Ora disponi di una procedura completa per isolare gli oggetti segmentati con Ultralytics YOLO: esegui l'inferenza, crea una maschera binaria da ogni contorno, quindi estrai l'oggetto su uno sfondo nero o trasparente e, facoltativamente, ritaglialo in base al riquadro di delimitazione. Consulta la documentazione completa di Attività di segmentazione e Modalità di previsione per adattare il flusso di lavoro alle tue classi.

FAQ#