Komut Satırı Arayüzü#
Ultralytics komut satırı arayüzü (CLI), Python ortamına ihtiyaç duymadan Ultralytics YOLO modellerini kullanmanın kolay bir yolunu sunar. CLI, herhangi bir özelleştirme veya Python kodu gerektirmeden, yolo komutunu kullanarak çeşitli görevleri doğrudan terminalden çalıştırmayı destekler.
Watch: Mastering Ultralytics YOLO: CLI
Ultralytics yolo komutları şu sözdizimini kullanır:
yolo TASK MODE ARGSBurada:
TASK(isteğe bağlı) şunlardan biridir: [detect, segment, semantic, depth, classify, pose, obb]MODE(gerekli) şunlardan biridir: [train, val, predict, export, track, benchmark]ARGS(isteğe bağlı), varsayılanları geçersiz kılanimgsz=320gibi herhangi sayıda özelarg=valueçiftidir.
Tüm ARGS argümanlarını eksiksiz Configuration Guide sayfasında veya yolo cfg ile görebilirsin.
Burada:
TASK(isteğe bağlı)[detect, segment, semantic, depth, classify, pose, obb]içinden biridir. Açıkça geçirilmezse, YOLO model türündenTASKdeğerini çıkarmaya çalışacaktır.MODE(gerekli)[train, val, predict, export, track, benchmark]içinden biridirARGS(isteğe bağlı), varsayılanları geçersiz kılanimgsz=320gibi herhangi sayıda özelarg=valueçiftidir. KullanılabilirARGSöğelerinin tam listesi için Configuration sayfasına vedefault.yamlöğesine bak.
Argümanlar, eşittir = işaretiyle ayrılmış ve çiftler arasında boşluklarla sınırlandırılmış arg=val çiftleri olarak geçilmelidir. -- argüman önekleri veya argümanlar arasında virgül , kullanma.
yolo predict model=yolo26n.pt imgsz=640 conf=0.25✅yolo predict model yolo26n.pt imgsz 640 conf 0.25❌yolo predict --model yolo26n.pt --imgsz 640 --conf 0.25❌
Eğit (Train)#
YOLO'yu COCO8 veri setinde, 640 görüntü boyutunda 100 epoch boyunca eğit. Kullanılabilir argümanların tam listesi için Configuration sayfasına bak.
640 görüntü boyutunda 100 epok boyunca COCO8 üzerinde YOLO26n eğitimini başlat:
yolo detect train data=coco8.yaml model=yolo26n.pt epochs=100 imgsz=640Doğrula (Val)#
Eğitilmiş modelin COCO8 veri setindeki accuracy değerini doğrula. model eğitim data değerini ve argümanlarını model özellikleri olarak koruduğu için hiçbir argümana gerek yoktur.
Resmi bir YOLO26n modelini doğrula:
yolo detect val model=yolo26n.ptTahmin Et (Predict)#
Görüntüler üzerinde tahminler çalıştırmak için eğitilmiş bir model kullan.
Resmi bir YOLO26n modeli ile tahmin yap:
yolo detect predict model=yolo26n.pt source='https://ultralytics.com/images/bus.jpg'Dışa Aktar (Export)#
Bir modeli ONNX veya CoreML gibi farklı bir formata aktar.
Resmi bir YOLO26n modelini ONNX formatına aktar:
yolo export model=yolo26n.pt format=onnxMevcut Ultralytics dışa aktarma formatları aşağıdaki tabloda yer almaktadır. format argümanını kullanarak (örneğin format='onnx' veya format='engine') herhangi bir forma dışa aktarabilirsin.
| Format | format Argümanı | Model | Meta veriler | Argümanlar |
|---|---|---|---|---|
| PyTorch | - | yolo26n.pt | ✅ | - |
| TorchScript | torchscript | yolo26n.torchscript | ✅ | imgsz, quantize, dynamic, nms, batch, device |
| ONNX | onnx | yolo26n.onnx | ✅ | imgsz, quantize, dynamic, simplify, opset, nms, batch, data, fraction, device |
| OpenVINO | openvino | yolo26n_openvino_model/ | ✅ | imgsz, quantize, dynamic, nms, batch, data, fraction, device |
| TensorRT | engine | yolo26n.engine | ✅ | imgsz, quantize, dynamic, simplify, opset, workspace, nms, batch, data, fraction, device |
| CoreML | coreml | yolo26n.mlpackage | ✅ | imgsz, dynamic, quantize, nms, batch, device |
| TF SavedModel | saved_model | yolo26n_saved_model/ | ✅ | imgsz, keras, quantize, opset, nms, batch, data, fraction, device |
| TF GraphDef | pb | yolo26n.pb | ❌ | imgsz, opset, batch, device |
| TF Edge TPU | edgetpu | yolo26n_edgetpu.tflite | ✅ | imgsz, quantize, opset, data, fraction, device |
| PaddlePaddle | paddle | yolo26n_paddle_model/ | ✅ | imgsz, batch, device |
| MNN | mnn | yolo26n.mnn | ✅ | imgsz, batch, dynamic, quantize, simplify, opset, nms, device |
| NCNN | ncnn | yolo26n_ncnn_model/ | ✅ | imgsz, quantize, batch, device |
| IMX500 | imx | yolo26n_imx_model/ | ✅ | imgsz, quantize, data, fraction, nms, device |
| RKNN | rknn | yolo26n_rknn_model/ | ✅ | imgsz, batch, name, quantize, simplify, opset, data, fraction, device |
| ExecuTorch | executorch | yolo26n_executorch_model/ | ✅ | imgsz, batch, device |
| Axelera | axelera | yolo26n_axelera_model/ | ✅ | imgsz, batch, quantize, data, fraction, device |
| DEEPX | deepx | yolo26n_deepx_model/ | ✅ | imgsz, quantize, simplify, opset, data, optimize, device |
| Qualcomm QNN | qnn | yolo26n_qnn.onnx | ✅ | imgsz, batch, name, quantize, simplify, opset, data, fraction, device |
| LiteRT | litert | yolo26n.tflite | ✅ | imgsz, quantize, batch, data, fraction, device |
| Hailo | hailo | yolo26n_hailo_model/ | ✅ | imgsz, name, quantize, data, fraction, simplify, conf, iou |
| Huawei Ascend | ascend | yolo26n_ascend_model/ | ✅ | imgsz, batch, name, quantize, opset, simplify, nms |
Tüm export detayları için Export sayfasına bak.
Varsayılan Argümanları Geçersiz Kılma#
Varsayılan argümanları CLI içinde arg=value çiftleri olarak geçirerek geçersiz kıl.
0,01 öğrenme oranı ile 10 epok boyunca bir tespit modeli eğit:
yolo detect train data=coco8.yaml model=yolo26n.pt epochs=10 lr0=0.01Varsayılan Yapılandırma Dosyasını Geçersiz Kılma#
cfg argümanıyla yeni bir dosya geçirerek default.yaml yapılandırma dosyasını tamamen geçersiz kıl, örneğin cfg=custom.yaml.
Bunu yapmak için öncelikle default_copy.yaml dosyası oluşturan yolo copy-cfg komutuyla mevcut çalışma dizininde default.yaml öğesinin bir kopyasını oluştur.
Ardından bu dosyayı, bu örnekteki gibi imgsz=320 gibi ek argümanlarla birlikte cfg=default_copy.yaml olarak geçebilirsin:
yolo copy-cfg
yolo cfg=default_copy.yaml imgsz=320Çözüm Komutları#
Ultralytics, CLI aracılığıyla yaygın bilgisayarlı görü uygulamaları için kullanıma hazır çözümler sunar. yolo solutions komutu nesne sayma, kırpma, bulanıklaştırma, antrenman izleme, ısı haritaları, örnek bölütleme, VisionEye, hız tahmini, kuyruk yönetimi, analitik, Streamlit çıkarımı ve tabanlı takip gibi özellikleri sunar; kataloğun tamamı için Solutions sayfasına göz at. Desteklenen tüm çözümleri ve argümanlarını listelemek için yolo solutions help komutunu çalıştır.
Bir videoda veya canlı yayında nesneleri say:
yolo solutions count show=True
yolo solutions count source="path/to/video.mp4" # specify video file pathUltralytics çözümleri hakkında daha fazla bilgi için Solutions sayfasını ziyaret et.
SSS#
Ultralytics YOLO komut satırı arayüzünü (CLI) model eğitimi için nasıl kullanabilirim?#
CLI kullanarak bir model eğitmek için terminalde tek satırlık bir komut çalıştır. Örneğin, 0,01 learning rate ile bir tespit modelini 10 epoch boyunca eğitmek için şunu çalıştır:
yolo train data=coco8.yaml model=yolo26n.pt epochs=10 lr0=0.01Bu komut, belirli argümanlarla birlikte train modunu kullanır. Kullanılabilir argümanların tam listesi için Configuration Guide sayfasına göz at.
Ultralytics YOLO CLI ile hangi görevleri gerçekleştirebilirim?#
Ultralytics YOLO CLI; detection, segmentation, semantic segmentation, depth estimation, classification, pose estimation ve oriented bounding box detection dahil olmak üzere çeşitli görevleri destekler. Ayrıca şu işlemleri de gerçekleştirebilirsin:
- Model Eğit (Train a Model):
yolo train data=<data.yaml> model=<model.pt> epochs=<num>komutunu çalıştır. - Tahmin Çalıştır (Run Predictions):
yolo predict model=<model.pt> source=<data_source> imgsz=<image_size>kullan. - Model Dışa Aktar (Export a Model):
yolo export model=<model.pt> format=<export_format>komutunu yürüt. - Çözümleri Kullan (Use Solutions): Hazır uygulamalar için
yolo solutions <solution_name>komutunu çalıştır.
Her görevi çeşitli argümanlarla özelleştir. Ayrıntılı sözdizimi ve örnekler için Train, Predict ve Export gibi ilgili bölümlere göz at.
CLI kullanarak eğitilmiş bir YOLO modelinin doğruluğunu nasıl doğrulayabilirim?#
Bir modelin accuracy değerini doğrulamak için val modunu kullan. Örneğin, 1 batch size ve 640 görüntü boyutuna sahip önceden eğitilmiş bir tespit modelini doğrulamak için şunu çalıştır:
yolo val model=yolo26n.pt data=coco8.yaml batch=1 imgsz=640Bu komut modeli belirtilen veri setinde değerlendirir ve mAP, precision ve recall gibi performans metrikleri sağlar. Daha fazla ayrıntı için Val bölümüne bakın.
CLI kullanarak YOLO modellerimi hangi formatlara dışa aktarabilirim?#
YOLO modellerini ONNX, TensorRT, CoreML, TensorFlow ve daha fazlası dahil olmak üzere çeşitli formatlara aktarabilirsin. Örneğin, bir modeli ONNX formatına aktarmak için şunu çalıştır:
yolo export model=yolo26n.pt format=onnxDışa aktarma komutu, modelini belirli dağıtım ortamları için optimize etmek üzere çok sayıda seçeneği destekler. Mevcut tüm dışa aktarma formatları ve bunların belirli parametreleri hakkında eksiksiz bilgi için Export sayfasını ziyaret et.
Ultralytics CLI içindeki hazır çözümleri nasıl kullanabilirim?#
Ultralytics, solutions komutu aracılığıyla kullanıma hazır çözümler sunar. Örneğin, bir videodaki nesneleri saymak için:
yolo solutions count source="path/to/video.mp4"Bu çözümler minimum yapılandırma gerektirir ve yaygın bilgisayarlı görü görevleri için anında işlevsellik sağlar. Mevcut tüm çözümleri görmek için yolo solutions help komutunu çalıştır. Her çözümün, ihtiyaçlarına uyacak şekilde özelleştirilebilen belirli parametreleri vardır.