YOLO Vision 2026:

Riquadri di delimitazione orientati (OBB) Object Detection#

Ultralytics YOLO oriented bounding box detection of boats in aerial imagery

Il rilevamento di oggetti orientati fa un passo avanti rispetto al normale rilevamento di oggetti, introducendo un angolo aggiuntivo per localizzare gli oggetti con maggiore precisione in un'immagine.

L'output di un rilevatore di oggetti orientati è un set di bounding box ruotati che racchiudono con precisione gli oggetti nell'immagine, insieme alle etichette di classe e ai punteggi di confidenza per ogni box. Gli oriented bounding box sono particolarmente utili quando gli oggetti appaiono con varie angolazioni, come nelle immagini aeree, dove i tradizionali bounding box allineati agli assi potrebbero includere uno sfondo superfluo.

Suggerimento

I modelli YOLO26 OBB utilizzano il suffisso -obb, ad esempio yolo26n-obb.pt, e sono preaddestrati su DOTAv1.



Watch: How to Detect & Track Objects with Ultralytics YOLO26 Oriented Bounding Boxes (OBB) | Ship Tracking 🚢

Esempi visivi#

Rilevamento navi tramite OBBRilevamento veicoli tramite OBB
Rilevamento di navi tramite OBBRilevamento di veicoli tramite OBB

Modelli#

Qui vengono mostrati i modelli OBB preaddestrati YOLO26, i quali sono preaddestrati sul dataset DOTAv1.

I Modelli vengono scaricati automaticamente dall'ultimo rilascio di Ultralytics al primo utilizzo.

Modellodimensione
(pixel)
mAPtest
50-95(e2e)
mAPtest
50(e2e)
Velocità
CPU ONNX
(ms)
Velocità
T4 TensorRT10
(ms)
params
(M)
FLOPs
(B)
YOLO26n-obb102452.478.997.7 ± 0.92.8 ± 0.02.514.0
YOLO26s-obb102454.880.9218.0 ± 1.44.9 ± 0.19.855.1
YOLO26m-obb102455.381.0579.2 ± 3.810.2 ± 0.321.2183.3
YOLO26l-obb102456.281.6735.6 ± 3.113.0 ± 0.225.6230.0
YOLO26x-obb102456.781.71485.7 ± 11.530.5 ± 0.957.6516.5
  • mAPtest i valori si riferiscono a modello singolo multiscala sul dataset DOTAv1.
    Riproduci con yolo val obb data=DOTAv1.yaml device=0 split=test e invia i risultati uniti alla valutazione DOTA.
  • Velocità mediata sulle immagini di validazione di DOTAv1 utilizzando un'istanza Amazon EC2 P4d.
    Riproduci tramite yolo val obb data=DOTAv1.yaml batch=1 device=0|cpu
  • I valori di Params e FLOPs si riferiscono al modello fuso dopo model.fuse(), che unisce i layer Conv e BatchNorm e, per i modelli end2end, rimuove la testa di rilevamento ausiliaria one-to-many. I checkpoint preaddestrati mantengono l'architettura di addestramento completa e potrebbero mostrare conteggi più elevati.

Addestramento#

Allena YOLO26n-obb sul dataset DOTA8 per 100 epoche a una dimensione di immagine di 640. Per un elenco completo degli argomenti disponibili, consulta la pagina Configurazione.

Nota

Un OBB e la sua rotazione di 180° sono identici, quindi la rotazione è definita modulo 180° e il riquadro non ha una direzione. Le etichette di addestramento sono canonicalizzate in una forma a lato lungo: la larghezza del riquadro w è il lato più lungo, l'angolo viene misurato in senso orario dall'asse x positivo all'orientamento del bordo w, ed è memorizzato in radianti in [-π/4, 3π/4) ([-45°, 135°)). Le predizioni non sono canonicalizzate, quindi un riquadro predetto potrebbe riportare il bordo corto come w; vedi Risultati dell'output. La forma [0°, 90°) è la convenzione regolarizzata in stile DOTA e non viene applicata durante l'addestramento o l'inferenza.

Esempio
from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n-obb.yaml")  # build a new model from YAML
model = YOLO("yolo26n-obb.pt")  # load a pretrained model (recommended for training)
model = YOLO("yolo26n-obb.yaml").load("yolo26n-obb.pt")  # build from YAML and transfer weights

# Train the model
results = model.train(data="dota8.yaml", epochs=100, imgsz=640)


Watch: How to Train Ultralytics YOLO-OBB (Oriented Bounding Boxes) Models on DOTA Dataset using Ultralytics Platform

Formato del dataset#

Il formato del dataset OBB può essere trovato in dettaglio nella Guida ai dataset. Il formato YOLO OBB designa i riquadri di delimitazione tramite i loro quattro punti d'angolo con coordinate normalizzate tra 0 e 1, seguendo questa struttura. L'annotazione della piattaforma Ultralytics supporta le etichette OBB con uno strumento di disegno di riquadri di delimitazione orientati dedicato:

class_index x1 y1 x2 y2 x3 y3 x4 y4

Internamente, YOLO elabora le perdite e gli output nel formato xywhr, che rappresenta il punto centrale (xy), la larghezza, l'altezza e la rotazione del riquadro di delimitazione.

Valutazione#

Valida l'accuratezza del modello YOLO26n-obb addestrato sul dataset DOTA8. Non sono necessari argomenti poiché il model mantiene il suo data di addestramento e gli argomenti come attributi del modello.

Esempio
from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n-obb.pt")  # load an official model
model = YOLO("path/to/best.pt")  # load a custom model

# Validate the model
metrics = model.val(data="dota8.yaml")  # no arguments needed, dataset and settings remembered
metrics.box.map  # map50-95(B)
metrics.box.map50  # map50(B)
metrics.box.map75  # map75(B)
metrics.box.maps  # a list containing mAP50-95(B) for each category
metrics.box.image_metrics  # per-image metrics dictionary with precision, recall, F1, TP, FP, and FN

Previsione#

Usa un modello YOLO26n-obb addestrato per eseguire previsioni sulle immagini.

Esempio
from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n-obb.pt")  # load an official model
model = YOLO("path/to/best.pt")  # load a custom model

# Predict with the model
results = model("https://ultralytics.com/images/boats.jpg")  # predict on an image

# Access the results
for result in results:
    xywhr = result.obb.xywhr  # center-x, center-y, width, height, angle (radians)
    xyxyxyxy = result.obb.xyxyxyxy  # polygon format with 4-points
    names = [result.names[cls.item()] for cls in result.obb.cls.int()]  # class name of each box
    confs = result.obb.conf  # confidence score of each box


Watch: How to Detect and Track Storage Tanks using Ultralytics YOLO-OBB | Oriented Bounding Boxes | DOTA

Visualizza i dettagli completi della modalità predict nella pagina Predict.

Output dei risultati#

Il rilevamento di riquadri di delimitazione orientati restituisce un oggetto Results per immagine. Il campo di predizione principale è result.obb, che contiene riquadri ruotati, ID di classe e punteggi di confidenza per ciascun oggetto rilevato.

AttributoTipoFormaDescrizione
result.obbOBB(N)Box orientate.
result.obb.datatorch.float32(N,7/8)Box ruotate grezze con confidenza/classe.
result.obb.xywhrtorch.float32(N,5)Riquadri ruotati xywhr.
result.obb.xyxyxyxytorch.float32(N,4,2)Quattro punti d'angolo.
result.obb.conftorch.float32(N,)Punteggi di confidenza.

Le etichette sono canonicalizzate secondo la convenzione del lato lungo ma le predizioni non lo sono, quindi result.obb.xywhr potrebbe riportare w più piccolo di h con la rotazione misurata dal bordo corto. Entrambe le forme descrivono lo stesso rettangolo, quindi result.obb.xyxyxyxy è corretto in entrambi i casi. Converti nuovamente gli angoli quando il codice a valle richiede la forma a lato lungo, tenendo presente che la riscrittura dei parametri del riquadro potrebbe spostare ciclicamente l'ordine degli angoli:

from ultralytics.utils.ops import xyxyxyxy2xywhr

xywhr = xyxyxyxy2xywhr(result.obb.xyxyxyxy)  # w >= h, rotation in [-pi/4, 3pi/4)

Per i campi specifici dell'attività Results relativi a ogni attività, consulta la sezione Risultati di predizione per attività.

Esportazione#

Esporta un modello YOLO26n-obb in un formato diverso come ONNX, CoreML, ecc.

Esempio
from ultralytics import YOLO

# Load a model
model = YOLO("yolo26n-obb.pt")  # load an official model
model = YOLO("path/to/best.pt")  # load a custom-trained model

# Export the model
model.export(format="onnx")

I formati di esportazione YOLO26-obb disponibili sono nella tabella sottostante. Puoi esportare in qualsiasi formato utilizzando l'argomento format, ad esempio format='onnx' o format='engine'. Puoi effettuare predizioni o validazioni direttamente su modelli esportati, ad esempio yolo predict model=yolo26n-obb.onnx. Gli esempi d'uso vengono mostrati per il tuo modello al termine dell'esportazione.

FormatoArgomento formatModelloMetadatiArgomenti
PyTorch-yolo26n-obb.pt-
TorchScripttorchscriptyolo26n-obb.torchscriptimgsz, quantize, dynamic, nms, batch, device
ONNXonnxyolo26n-obb.onnximgsz, quantize, dynamic, simplify, opset, nms, batch, data, fraction, device
OpenVINOopenvinoyolo26n-obb_openvino_model/imgsz, quantize, dynamic, nms, batch, data, fraction, device
TensorRTengineyolo26n-obb.engineimgsz, quantize, dynamic, simplify, opset, workspace, nms, batch, data, fraction, device
CoreMLcoremlyolo26n-obb.mlpackageimgsz, dynamic, quantize, nms, batch, device
TF SavedModelsaved_modelyolo26n-obb_saved_model/imgsz, keras, quantize, opset, nms, batch, data, fraction, device
TF GraphDefpbyolo26n-obb.pbimgsz, opset, batch, device
TF Edge TPUedgetpuyolo26n-obb_edgetpu.tfliteimgsz, quantize, opset, data, fraction, device
PaddlePaddlepaddleyolo26n-obb_paddle_model/imgsz, batch, device
MNNmnnyolo26n-obb.mnnimgsz, batch, dynamic, quantize, simplify, opset, nms, device
NCNNncnnyolo26n-obb_ncnn_model/imgsz, quantize, batch, device
IMX500imxyolo26n-obb_imx_model/imgsz, quantize, data, fraction, nms, device
RKNNrknnyolo26n-obb_rknn_model/imgsz, batch, name, quantize, simplify, opset, data, fraction, device
ExecuTorchexecutorchyolo26n-obb_executorch_model/imgsz, batch, device
Axeleraaxelerayolo26n-obb_axelera_model/imgsz, batch, quantize, data, fraction, device
DEEPXdeepxyolo26n-obb_deepx_model/imgsz, quantize, simplify, opset, data, optimize, device
Qualcomm QNNqnnyolo26n-obb_qnn.onnximgsz, batch, name, quantize, simplify, opset, data, fraction, device
LiteRTlitertyolo26n-obb.tfliteimgsz, quantize, batch, data, fraction, device
Hailohailoyolo26n-obb_hailo_model/imgsz, name, quantize, data, fraction, simplify, conf, iou
Huawei Ascendascendyolo26n-obb_ascend_model/imgsz, batch, name, quantize, opset, simplify, nms
Apple Core AIcoreaiyolo26n-obb.aimodelimgsz, batch, quantize

Visualizza i dettagli completi di export nella pagina Export.

Applicazioni nel mondo reale#

Il rilevamento OBB con YOLO26 ha numerose applicazioni pratiche in diversi settori:

  • Gestione marittima e portuale: Rilevamento di navi e imbarcazioni a varie angolazioni per la gestione della flotta e il monitoraggio.
  • Pianificazione urbana: Analisi di edifici e infrastrutture da immagini aeree.
  • Agricoltura: Monitoraggio delle colture e delle attrezzature agricole da riprese effettuate con droni.
  • Settore energetico: Ispezione di pannelli solari e turbine eoliche con diverse orientazioni.
  • Trasporti: Tracciamento di veicoli su strade e parcheggi da varie prospettive.

Queste applicazioni beneficiano della capacità dell'OBB di adattarsi con precisione agli oggetti con qualsiasi angolazione, fornendo un rilevamento più accurato rispetto ai tradizionali bounding box.

FAQ#

  • I riquadri di delimitazione orientati (OBB) includono un angolo aggiuntivo per migliorare l'accuratezza della localizzazione degli oggetti nelle immagini. A differenza dei normali riquadri di delimitazione, che sono rettangoli allineati agli assi, gli OBB possono ruotare per adattarsi meglio all'orientamento dell'oggetto. Ciò è particolarmente utile per le applicazioni che richiedono un posizionamento preciso degli oggetti, come immagini aeree o satellitari (Guida ai dataset).

  • Per addestrare un modello YOLO26n-obb con un dataset personalizzato, segui l'esempio qui sotto utilizzando Python o la CLI:

    Esempio
    from ultralytics import YOLO
    
    # Load a pretrained model
    model = YOLO("yolo26n-obb.pt")
    
    # Train the model
    results = model.train(data="path/to/custom_dataset.yaml", epochs=100, imgsz=640)

    Per ulteriori argomenti di addestramento, controlla la sezione Configurazione.

  • I modelli YOLO26-OBB sono preaddestrati su dataset come DOTAv1, ma puoi utilizzare qualsiasi dataset formattato per OBB. Informazioni dettagliate sui formati dei dataset OBB possono essere trovate nella Guida ai dataset.

  • L'esportazione di un modello YOLO26-OBB in formato ONNX è semplice utilizzando Python o la CLI:

    Esempio
    from ultralytics import YOLO
    
    # Load a model
    model = YOLO("yolo26n-obb.pt")
    
    # Export the model
    model.export(format="onnx")

    Per ulteriori formati di esportazione e dettagli, fai riferimento alla pagina Esportazione.

  • Per validare un modello YOLO26n-obb, puoi utilizzare i comandi Python o CLI come mostrato di seguito:

    Esempio
    from ultralytics import YOLO
    
    # Load a model
    model = YOLO("yolo26n-obb.pt")
    
    # Validate the model
    metrics = model.val(data="dota8.yaml")

    Visualizza i dettagli completi della validazione nella sezione Val.

Commenti