Ultralytics YOLOv5 ile Comet Nasıl Kullanılır

Ultralytics olarak, YOLOv5 gibi harika açık kaynaklı araçlarımızın herkes için ücretsiz kalmasını sağlamak amacıyla, bunların araştırma ve geliştirme süreçlerini finanse etmemize yardımcı olmaları için diğer girişimlerle ticari ortaklıklar yapıyoruz. Bu makale, söz konusu ortaklara ilişkin bağlı kuruluş bağlantıları içerebilir.

En yeni iş ortağımız Comet, veri bilimcilerin, mühendislerin ve ekip liderlerinin makine öğrenimi ve derin öğrenme modellerini hızlandırmasına ve optimize etmesine yardımcı olan araçlar geliştiriyor.

Comet, modellerinizi, veri kümelerinizi ve metriklerinizi takip etmek için güçlü bir araçtır. Hatta her çalışma için tekrarlanabilirliği ve sorunsuz hata ayıklamayı sağlamak adına sistem ve ortam değişkenlerinizi kaydeder. Sanki hangi notları saklaması gerektiğini sihirli bir şekilde bilen bir sanal asistanınız varmış gibi. Model metriklerini gerçek zamanlı olarak takip edip görselleştirin, hiperparametrelerinizi, veri kümelerinizi ve model kontrol noktalarınızı kaydedin ve Comet Özel Panelleri ile model tahminlerinizi görselleştirin!

Ayrıca Comet, çalışmalarınızı asla gözden kaçırmamanızı sağlar ve sonuçları paylaşmayı ve her büyüklükteki ekip arasında iş birliği yapmayı kolaylaştırır!

YOLOv5, bilgisayarlı görü yolculuğun için harika bir başlangıç noktasıdır. Modelinin performansını artırmak ve onu üretime hazır hale getirmek için sonuçları Comet gibi bir deney takip aracına kaydetmen gerekir.

Comet ve YOLOv5 entegrasyonu 3 ana özellik sunar:

• Otomatik kayıt ve özel kayıt özellikleri
• Hata ayıklama ve tekrarlanabilirlik için veri kümelerini ve modelleri yapay nesneler (artifacts) olarak kaydetme
• Görünümünü Comet'in özel panelleriyle düzenleme

Bu rehber, YOLOv5'i Comet ile nasıl kullanacağını ele alacak.

Deneylerini gerçek zamanlı olarak takip etmeye hazır mısın? Hadi başlayalım!

Link to this sectionBaşlarken#

Link to this sectionComet'i yükle#

pip install comet_ml

Link to this sectionComet kimlik bilgilerini yapılandır#

Comet'i YOLOv5 ile yapılandırmanın iki yolu vardır.

Kimlik bilgilerini ya ortam değişkenleri aracılığıyla ayarlayabilirsin ya da çalışma dizininde bir .comet.config dosyası oluşturup kimlik bilgilerini orada belirleyebilirsin.

Link to this sectionOrtam Değişkenleri#

export COMET_API_KEY=<Your API Key>
export COMET_PROJECT_NAME=<Your Comet Project Name> # This will default to 'yolov5'

Link to this sectionComet Yapılandırma Dosyası#

[comet]
api_key=<Your API Key>
project_name=<Your Comet Project Name> # This will default to 'yolov5'

Link to this sectionEğitim betiğini çalıştır#

# Train YOLOv5s on COCO128 for 5 epochs
python train.py --img 640 --batch 16 --epochs 5 --data coco128.yaml --weights yolov5s.pt

İşte bu kadar!

Comet; hiperparametrelerini, komut satırı argümanlarını, eğitim ve doğrulama metriklerini otomatik olarak kaydeder. Çalışmalarını Comet arayüzünde görselleştirebilir ve analiz edebilirsin.

Link to this sectionKendin dene!#

Tamamlanmış bir çalışmanın örneğine buradan göz at.

Veya daha da iyisi, bu Colab Not Defteri üzerinde kendin dene.

Link to this sectionOtomatik Olarak Kaydet#

Varsayılan olarak Comet, aşağıdaki öğeleri kaydeder:

Link to this sectionMetrikler#

• Eğitim ve doğrulama verileri için Box Loss, Object Loss ve Classification Loss
• Doğrulama verileri için mAP_0.5, mAP_0.5:0.95 metrikleri
• Doğrulama verileri için Precision ve Recall

Link to this sectionParametreler#

• Model Hiperparametreleri
• Komut satırı seçenekleriyle iletilen tüm parametreler

Link to this sectionGörselleştirmeler#

• Doğrulama verileri üzerindeki model tahminlerinin Confusion Matrix'i
• Tüm sınıflar için PR ve F1 eğrileri grafikleri
• Sınıf Etiketlerinin Korelogramı

Link to this sectionComet Kaydını Yapılandır#

Comet, eğitim betiğine iletilen komut satırı bayrakları veya ortam değişkenleri aracılığıyla ek verileri kaydedecek şekilde yapılandırılabilir.

export COMET_MODE=online # Set whether to run Comet in 'online' or 'offline' mode. Defaults to online
export COMET_MODEL_NAME=<your model name> # Set the name for the saved model. Defaults to yolov5
export COMET_LOG_CONFUSION_MATRIX=false # Set to disable logging a Comet Confusion Matrix. Defaults to true
export COMET_MAX_IMAGE_UPLOADS=<number of allowed images to upload to Comet> # Controls how many total image predictions to log to Comet. Defaults to 100.
export COMET_LOG_PER_CLASS_METRICS=true # Set to log evaluation metrics for each detected class at the end of training. Defaults to false
export COMET_DEFAULT_CHECKPOINT_FILENAME=<your checkpoint filename> # Set this if you would like to resume training from a different checkpoint. Defaults to 'last.pt'
export COMET_LOG_BATCH_LEVEL_METRICS=true # Set this if you would like to log training metrics at the batch level. Defaults to false.
export COMET_LOG_PREDICTIONS=true # Set this to false to disable logging model predictions

Link to this sectionKontrol Noktalarını Comet ile Kaydetme#

Modellerin Comet'e kaydedilmesi varsayılan olarak devre dışıdır. Etkinleştirmek için eğitim betiğine save-period argümanını ilet. Bu, kaydedilen kontrol noktalarını save-period tarafından sağlanan aralık değerine göre Comet'e kaydedecektir.

python train.py \
  --img 640 \
  --batch 16 \
  --epochs 5 \
  --data coco128.yaml \
  --weights yolov5s.pt \
  --save-period 1

Link to this sectionModel Tahminlerini Kaydetme#

Varsayılan olarak, model tahminleri (görseller, gerçek etiketler ve sınırlayıcı kutular) Comet'e kaydedilir. Kaydedilen tahminlerin ve ilişkili görsellerin sıklığını bbox_interval komut satırı argümanını ileterek kontrol edebilirsin. Tahminler, Comet'in Nesne Algılama Özel Paneli kullanılarak görselleştirilebilir. Bu sıklık, dönem başına her N'inci veri grubuna karşılık gelir. Aşağıdaki örnekte, her dönem için her 2'nci veri grubunu kaydediyoruz.

Not: YOLOv5 doğrulama veri yükleyicisi varsayılan olarak 32'lik bir yığın boyutuna (batch size) sahip olacaktır, bu nedenle kayıt sıklığını buna göre ayarlaman gerekecektir.

İşte Paneli kullanan örnek bir proje.

python train.py \
  --img 640 \
  --batch 16 \
  --epochs 5 \
  --data coco128.yaml \
  --weights yolov5s.pt \
  --bbox_interval 2

Link to this sectionComet'e Kaydedilen Tahmin Görseli Sayısını Kontrol Etme#

YOLOv5'ten tahminleri kaydederken, Comet her tahmin setiyle ilişkili görselleri kaydeder. Varsayılan olarak, en fazla 100 doğrulama görseli kaydedilir. Bu sayıyı COMET_MAX_IMAGE_UPLOADS ortam değişkenini kullanarak artırabilir veya azaltabilirsin.

env COMET_MAX_IMAGE_UPLOADS=200 python train.py \
  --img 640 \
  --batch 16 \
  --epochs 5 \
  --data coco128.yaml \
  --weights yolov5s.pt \
  --bbox_interval 1

Link to this sectionSınıf Düzeyinde Metrikleri Kaydetme#

Her sınıf için mAP, precision, recall ve f1 değerlerini kaydetmek için COMET_LOG_PER_CLASS_METRICS ortam değişkenini kullan.

env COMET_LOG_PER_CLASS_METRICS=true python train.py \
  --img 640 \
  --batch 16 \
  --epochs 5 \
  --data coco128.yaml \
  --weights yolov5s.pt

Link to this sectionComet Artifacts'e Veri Kümesi Yükleme#

Verilerini Comet Artifacts kullanarak saklamak istersen, upload_dataset bayrağını kullanarak bunu yapabilirsin.

Veri kümesi, YOLOv5 dokümantasyonunda açıklandığı şekilde düzenlenmiştir. Veri kümesi yapılandırma yaml dosyası, coco128.yaml dosyasıyla aynı formatı takip etmelidir.

python train.py \
  --img 640 \
  --batch 16 \
  --epochs 5 \
  --data coco128.yaml \
  --weights yolov5s.pt \
  --upload_dataset

Yüklenen veri kümesini Comet Çalışma Alanındaki Artifacts sekmesinde bulabilirsin.

Verileri doğrudan Comet arayüzünde önizleyebilirsin.

Artifacts sürümlüdür ve veri kümesi hakkında meta veri eklemeyi de destekler. Comet, veri kümesi yaml dosyanızdaki meta verileri otomatik olarak kaydeder.

Link to this sectionKaydedilmiş bir Artifact Kullanma#

Comet Artifacts'ten bir veri kümesi kullanmak istersen, veri kümesi yaml dosyanızdaki yol değişkenini aşağıdaki Artifact kaynak URL'sini işaret edecek şekilde ayarla.

# contents of artifact.yaml file
path: "comet://<workspace name>/<artifact name>:<artifact version or alias>"

Ardından bu dosyayı eğitim betiğine şu şekilde ilet:

python train.py \
  --img 640 \
  --batch 16 \
  --epochs 5 \
  --data artifact.yaml \
  --weights yolov5s.pt

Artifacts ayrıca verilerin Deney iş akışınız boyunca akarken izlenebilirliğini takip etmenize olanak tanır. Burada, yüklediğiniz veri kümesini kullanan tüm deneyleri gösteren bir grafik görebilirsin.

Link to this sectionBir Eğitim Çalışmasını Sürdürme#

Eğitim çalışman herhangi bir nedenle kesintiye uğrarsa (örneğin internet bağlantısının kesilmesi), resume bayrağını ve Comet Çalışma Yolunu (Run Path) kullanarak çalışmayı sürdürebilirsin.

The Run Path has the following format comet://<your workspace name>/<your project name>/<experiment id>.

Bu, çalışmayı kesintiden önceki durumuna geri yükleyecektir; buna modeli bir kontrol noktasından geri yükleme, tüm hiperparametreleri ve eğitim argümanlarını geri yükleme ve orijinal çalışmada kullanılmışlarsa Comet veri kümesi Artifacts'lerini indirme dahildir. Sürdürülen çalışma, Comet arayüzünde mevcut Deneye kayıt yapmaya devam edecektir.

python train.py \
  --resume "comet://<your run path>"

Link to this sectionComet Optimizer ile Hiperparametre Araması#

YOLOv5, Comet'in Optimizer aracıyla da entegredir ve bu da Comet arayüzünde hiperparametre taramalarını görselleştirmeyi basit hale getirir.

Link to this sectionBir Optimizer Taramasını Yapılandırma#

Comet Optimizer'ı yapılandırmak için tarama hakkında bilgilerin yer aldığı bir JSON dosyası oluşturman gerekecektir.

Örnek bir dosya utils/loggers/comet/optimizer_config.json içinde sağlanmıştır.

python utils/loggers/comet/hpo.py \
  --comet_optimizer_config "utils/loggers/comet/optimizer_config.json"

hpo.py betiği, train.py ile aynı argümanları kabul eder. Taramanıza ek argümanlar iletmek istersen, bunları betikten sonra eklemen yeterlidir.

python utils/loggers/comet/hpo.py \
  --comet_optimizer_config "utils/loggers/comet/optimizer_config.json" \
  --save-period 1 \
  --bbox_interval 1

Link to this sectionParalel Olarak Tarama Çalıştırma#

comet optimizer -j <num_workers> utils/loggers/comet/hpo.py \
  utils/loggers/comet/optimizer_config.json

Comet, taramanızın sonuçlarını görselleştirmek için birçok yol sunar. Tamamlanmış bir taramaya sahip projeye buradan göz at:

Link to this sectionİletişimde Kal#

Eğitim çalışmalarından üretim izlemeye kadar YOLOv5 modellerini yönetmek, görselleştirmek ve optimize etmek için Comet ile entegrasyonumuzu kullanmaya başla.

Ve tabii ki, YOLOv5 eğitimi, doğrulaması ve dağıtımı hakkında sorular sormak ve ipuçları paylaşmak için Ultralytics Topluluğuna katıl.