Hata Raporları için Minimum Tekrarlanabilir Örnek Oluşturma#

Ultralytics YOLO depoları için hata raporu gönderirken bir Minimum Tekrarlanabilir Örnek (MRE) sağlamak çok önemlidir. MRE, yaşadığın sorunu gösteren küçük ve kendi içinde yeterli bir kod parçasıdır. Bir MRE sağlamak, bakımcıların ve katkıda bulunanların sorunu anlamasına ve çözüm üzerinde daha verimli çalışmasına yardımcı olur. Bu kılavuz, Ultralytics YOLO depolarına hata raporu gönderirken nasıl MRE oluşturacağını açıklar.

1. Sorunu Yalıt#

MRE oluşturmanın ilk adımı sorunu yalıtmaktır. Sorunla doğrudan ilgili olmayan gereksiz kodları veya bağımlılıkları kaldır. Soruna neden olan belirli kod bölümüne odaklan ve ilgisiz kısımları çıkar.

2. Herkese Açık Modelleri ve Veri Kümelerini Kullan#

MRE oluştururken sorunu yeniden üretmek için herkese açık modelleri ve veri kümelerini kullan. Örneğin, yolo26n.pt modelini ve coco8.yaml veri kümesini kullan. Bu, bakımcıların ve katkıda bulunanların özel verilere veya özel modellere erişmeleri gerekmeden örneğini kolayca çalıştırıp sorunu inceleyebilmesini sağlar.

3. Gerekli Tüm Bağımlılıkları Ekle#

Gerekli tüm bağımlılıkların MRE'ne dahil edildiğinden emin ol. Kodun harici kütüphanelere dayanıyorsa gerekli paketleri ve sürümlerini belirt. İdeal olarak, ultralytics yüklüyse bağımlılıkları hata raporunda yolo checks kullanarak, diğer araçlar içinse pip list kullanarak listele.

4. Sorunun Açık Bir Açıklamasını Yaz#

Yaşadığın sorunun açık ve özlü bir açıklamasını sağla. Beklenen davranışı ve karşılaştığın gerçek davranışı açıkla. Uygunsa ilgili hata mesajlarını veya günlükleri ekle.

5. Kodunu Uygun Biçimde Biçimlendir#

Sorun açıklamasında kod bloklarını kullanarak kodunu uygun biçimde biçimlendir. Bu, başkalarının kodunu okumasını ve anlamasını kolaylaştırır. GitHub'da kodunu üçlü ters tırnaklarla (```) sarıp dili belirterek bir kod bloğu oluşturabilirsin:

```python
# Your Python code goes here
```

6. MRE'ni Test Et#

MRE'ni göndermeden önce sorunu doğru şekilde yeniden ürettiğinden emin olmak için test et. Başkalarının örneğini herhangi bir sorun veya değişiklik olmadan çalıştırabildiğinden emin ol.

MRE Örneği#

Aşağıda varsayımsal bir hata raporu için MRE örneği verilmiştir:

Hata açıklaması:

0 kanallı bir görüntü üzerinde çıkarım çalıştırırken giriş tensörünün boyutlarıyla ilgili bir hata alıyorum.

MRE:

import torch

from ultralytics import YOLO

# Load the model
model = YOLO("yolo26n.pt")

# Load a 0-channel image
image = torch.rand(1, 0, 640, 640)

# Run the model
results = model(image)

Hata mesajı:

RuntimeError: Expected input[1, 0, 640, 640] to have 3 channels, but got 0 channels instead

Bağımlılıklar:

• torch==2.8.0
• ultralytics==8.4.142

Bu örnekte MRE, sorunu minimum miktarda kodla gösterir, herkese açık bir model ("yolo26n.pt") kullanır, gerekli tüm bağımlılıkları içerir ve hata mesajıyla birlikte sorunun açık bir açıklamasını sunar.

Bu yönergeleri izleyerek, Ultralytics YOLO depolarının bakımcılarının ve katkıda bulunanlarının sorununu daha verimli anlamasına ve çözmesine yardımcı olursun.

SSS#