Link to this sectionUltralytics YOLO26'da Uçtan Uca Tespitin Anlaşılması#

YOLO26 modeline YOLOv8 veya YOLO11 gibi önceki bir modelden geçiş yapıyorsan, fark edeceğin en büyük değişikliklerden biri Non-Maximum Suppression (NMS) yönteminin kaldırılmasıdır. Geleneksel YOLO modelleri, nihai tespitlere kadar filtrelemek için ayrı bir NMS işlem sonrası adımı gerektiren binlerce örtüşen tahmin üretir. Bu durum gecikmeyi artırır, dışa aktarma grafiklerini karmaşıklaştırır ve farklı donanım platformlarında tutarsız bir şekilde çalışabilir.

YOLO26 farklı bir yaklaşım benimser. Nihai tespitleri doğrudan modelden çıktı olarak verir; harici filtreleme gerekmez. Bu durum uçtan uca nesne tespiti olarak bilinir ve tüm YOLO26 modellerinde varsayılan olarak etkinleştirilmiştir. Sonuç; daha basit bir dağıtım hattı, daha düşük gecikme süresi ve CPU'larda %43'e kadar daha hızlı çıkarımdır.

Bu kılavuz, nelerin değiştiği, kodunu güncellemen gerekip gerekmediği, hangi dışa aktarma formatlarının uçtan uca çıkarımı desteklediği ve eski YOLO modellerinden nasıl sorunsuz bir şekilde geçiş yapabileceğin konusunda sana rehberlik eder.

Bu mimari değişikliğin arkasındaki motivasyona daha derin bir bakış için, Ultralytics'in YOLO26'nın neden NMS'yi kaldırdığına ve bunun dağıtımı nasıl değiştirdiğine dair blog yazısına göz at.

Link to this sectionUçtan Uca Tespit Nasıl Çalışır#

YOLO26, eğitim sırasında çift başlı bir mimari kullanır. Her iki başlık da aynı omurgayı ve boyun yapısını paylaşır, ancak çıktıları farklı şekillerde üretir:

Yukarıdaki şekiller tespit içindir. Diğer görevler, one-to-one çıktısını her tespit için ek verilerle genişletir:

Eğitim sırasında her iki başlık da aynı anda çalışır; one-to-many başlığı daha zengin bir öğrenme sinyali sağlarken, one-to-one başlığı temiz ve örtüşmeyen tahminler üretmeyi öğrenir. Çıkarım ve dışa aktarma sırasında, varsayılan olarak yalnızca one-to-one başlığı aktiftir ve [x1, y1, x2, y2, confidence, class_id] formatında görüntü başına 300'e kadar tespit üretir.

model.fuse() komutunu çalıştırdığında, daha hızlı çıkarım için Conv + BatchNorm katmanlarını birleştirir ve uçtan uca modellerde, model boyutunu ve FLOP'ları azaltarak one-to-many başlığını da kaldırır. Çift başlı mimari hakkında daha fazla ayrıntı için YOLO26 model sayfasına bak.

Link to this sectionKodumu Değiştirmem Gerekiyor mu?#

Link to this sectionUltralytics Python API veya CLI Kullanımı#

Değişiklik yapmana gerek yok. Standart Ultralytics Python API veya CLI kullanıyorsan her şey otomatik olarak çalışır; tahmin, doğrulama ve dışa aktarma işlemlerinin tümü uçtan uca modelleri doğrudan destekler.

from ultralytics import YOLO

# Load a YOLO26 model
model = YOLO("yolo26n.pt")

# Predict — no NMS step, no code changes
results = model.predict("image.jpg")

Link to this sectionÖzel Çıkarım Kodu Kullanımı#

Evet, çıktı formatı farklıdır. YOLOv8 veya YOLO11 için özel işlem sonrası mantığı yazdıysan (örneğin, ONNX Runtime veya TensorRT ile çıkarım yaparken), bunu yeni çıktı şeklini işleyecek şekilde güncellemen gerekecektir:

segmentation, pose ve OBB görevleri için YOLO26, her bir algılamaya göreve özel veriler ekler — çıkış şekilleri tablosuna bakabilirsin.

N yığın boyutu ve nc sınıf sayısıdır (örneğin, COCO için 80).

Uçtan uca modellerle işlem sonrası çok daha basit hale gelir; örneğin, ONNX Runtime kullanırken:

import onnxruntime as ort

# Load and run the exported end-to-end model
session = ort.InferenceSession("yolo26n.onnx")
output = session.run(None, {session.get_inputs()[0].name: input_tensor})

# End-to-end output: (batch, 300, 6) → [x1, y1, x2, y2, confidence, class_id]
detections = output[0][0]  # first image in batch
detections = detections[detections[:, 4] > conf_threshold]  # confidence filter — that's it!

Link to this sectionOne-to-Many Başlığına Geçiş#

Geleneksel YOLO çıktı formatına ihtiyacın varsa (örneğin, mevcut NMS tabanlı son işleme kodunu yeniden kullanmak için), uygun olduğunda end2end=False ayarını yaparak bire-çok başlığına geçebilirsin:

from ultralytics import YOLO

model = YOLO("yolo26n.pt")

# Prediction with NMS (traditional behavior)
results = model.predict("image.jpg", end2end=False)

# Validation with NMS
metrics = model.val(data="coco.yaml", end2end=False)

# Export without end-to-end
model.export(format="onnx", end2end=False)

Link to this sectionDışa Aktarma Formatı Uyumluluğu#

Çoğu dışa aktarma formatı, ONNX, TensorRT, CoreML, OpenVINO, LiteRT ve MNN dahil olmak üzere uçtan uca çıkarımı doğrudan destekler.

Aşağıdaki formatlar uçtan uca desteklemez ve otomatik olarak one-to-many başlığına geri döner: NCNN, RKNN, PaddlePaddle, ExecuTorch, IMX, Edge TPU ve Qualcomm QNN.

Hailo HEF için derleme adımı, ONNX dışa aktarımından sonra model.export(format=...) dışında gerçekleşir. Tam tespit modelinle eşleşen Hailo DFC günlüklerini, .alls model komut dosyasını ve NMS JSON'ını kullan; uçtan uca bir YOLO26 grafiği Hailo araç zincirin tarafından desteklenmiyorsa, ONNX modelini end2end=False ile dışa aktar ve geleneksel tespit başlığını derle.

Link to this sectionDoğruluk ve Hız Ödünleşimleri#

Uçtan uca tespit, doğruluk üzerinde minimum etkiyle önemli dağıtım avantajları sağlar:

Çoğu gerçek dünya uygulaması için, özellikle hız ve basitlik kazanımları düşünüldüğünde, ~0.5 mAP farkı önemsizdir. Maksimum doğruluk en büyük önceliğin ise, end2end=False kullanarak her zaman one-to-many başlığına geri dönebilirsin.

Tüm model boyutları (n, s, m, l, x) genelindeki ayrıntılı kıyaslamalar için YOLO26 performans metriklerine bak.

Link to this sectionYOLOv8 veya YOLO11'den Geçiş#

Mevcut bir projeyi YOLO26'ya yükseltiyorsan, sorunsuz bir geçiş sağlamak için işte hızlı bir kontrol listesi:

• Ultralytics API / CLI kullanıcıları: Değişiklik gerekmez; sadece model adını yolo26n.pt (veya yolo26n-seg.pt, yolo26n-pose.pt, yolo26n-obb.pt) olarak güncelle.
• Özel işlem sonrası kodu: Yeni çıktı şekillerini işleyecek şekilde güncelle; tespit için (N, 300, 6), ayrıca segmentasyon, poz ve OBB için göreve özel veriler. Ayrıca kutu formatının xywh'den xyxy'ye değiştiğini unutma.
• Dışa aktarma işlem hatları: Hedef formatın için format uyumluluğu bölümünü kontrol et.
• TensorRT + INT8: JetPack 6 üzerinde, TensorRT 10.3.0 quantize=8 ile uçtan uca özelliği otomatik olarak devre dışı bırakır; uçtan uca desteğini korumak için farklı bir TensorRT sürümü kullan.
• FP16 dışa aktarımlar: Eğer tüm çıktıların FP16 olmasını istiyorsan, end2end=False ile dışa aktar — neden output0'ın FP32 kaldığına göz at.
• iOS / CoreML: End-to-end is fully supported. If you need Xcode Preview support, use end2end=False with nms=True
• Uç cihazlar (NCNN, RKNN): Bu formatlar otomatik olarak one-to-many'ye geri döner, bu yüzden cihaz içi hattına NMS'yi dahil et.

Link to this sectionSonuç#

Uçtan uca algılama, YOLO26'da varsayılandır ve Ultralytics Python API veya CLI kullanıyorsan kod değişikliği gerektirmez. Yalnızca özel son işlem hatlarının yeni (N, 300, 6) çıktısını okuyacak ve NMS adımını devre dışı bırakacak şekilde güncellenmesi gerekir — NCNN ve RKNN gibi bire-çok çıkışa dönen dışa aktarma formatları hariç, bunlar cihaz üzerinde hala NMS gerektirir. Tüm model boyutlarındaki ayrıntılı hız ve doğruluk karşılaştırmaları için YOLO26 model sayfasına, tüm dışa aktarma seçenekleri ve formatları için ise Dışa aktarma modu belgelerine göz at.

Link to this sectionSSS#

Link to this sectionend2end=True ve nms=True özelliklerini birlikte kullanabilir miyim?#

No. These options are mutually exclusive. If you set nms=True on an end-to-end model during export, it will be automatically forced to nms=False with a warning. The end-to-end head already handles duplicate filtering internally, so external NMS is unnecessary.

Ancak, end2end=False ile birleştirilmiş nms=True geçerli bir yapılandırmadır; geleneksel NMS'yi dışa aktarma grafiğine işler. Bu, CoreML dışa aktarımları için yararlı olabilir çünkü Xcode'daki Önizleme işlevini doğrudan tespit modeliyle kullanmana olanak tanır.

Link to this sectionUçtan uca modellerde max_det parametresi neyi kontrol eder?#

max_det parametresi (varsayılan: 300), bire-bir başlığın görüntü başına çıktı verebileceği maksimum algılama sayısını belirler. Bunu çıkarım veya dışa aktarma sırasında ayarlayabilirsin:

model.predict("image.jpg", max_det=100)  # fewer detections, slightly faster
model.export(format="onnx", max_det=500)  # more detections for dense scenes

Varsayılan YOLO26 kontrol noktalarının max_det=300 ile eğitildiğini unutma. Bu değeri artırabilmene rağmen, bire bir başlık eğitim sırasında 300'e kadar temiz tespit üretecek şekilde optimize edilmiştir, bu nedenle bu sınırın ötesindeki tespitler daha düşük kalitede olabilir. Görüntü başına 300'den fazla tespite ihtiyacın varsa, daha yüksek bir max_det değeriyle yeniden eğitmeyi düşün.

Link to this sectionDışa aktardığım ONNX modelim (1, 300, 6) çıktısı veriyor — bu doğru mu?#

Evet, bu tespit için beklenen uçtan uca çıktı formatıdır: 1 batch size, her biri 6 değer içeren [x1, y1, x2, y2, confidence, class_id] şeklinde 300'e kadar tespit. Sadece güven eşiğine göre filtrele ve işlem tamamdır — NMS gerekmez.

Diğer görevler için çıktı şekli farklıdır:

Link to this sectionDışa aktardığım modelin uçtan uca olup olmadığını nasıl kontrol edebilirim?#

Ultralytics Python API'sini kullanarak veya doğrudan dışa aktarılan ONNX model meta verilerini inceleyerek kontrol edebilirsin:

from ultralytics import YOLO

model = YOLO("yolo26n.onnx")
model.predict(verbose=False)  # run predict to setup predictor first
print(model.predictor.model.end2end)  # True if end-to-end is enabled

Alternatif olarak, çıktı şeklini kontrol et — uçtan uca tespit modelleri (1, 300, 6) çıktısı verirken, geleneksel modeller (1, nc + 4, 8400) çıktısı verir. Diğer görev şekilleri için çıktı şekilleri SSS bölümüne bak.

Link to this sectionÖrnek segmentasyonu, poz ve OBB görevleri için uçtan uca destekleniyor mu?#

Evet. YOLO26 tespit tarzı görev varyantları — tespit, örnek segmentasyonu, poz tahmini ve yönelimli nesne tespiti (OBB) — varsayılan olarak uçtan uca çıkarımı destekler. end2end=False yedeği de bu görevler genelinde mevcuttur.

Her görev, temel tespit çıktısını göreve özel verilerle genişletir: