Hata Raporları için Minimum Yeniden Üretilebilir Örnek Oluşturma#

Ultralytics YOLO depolarına bir hata raporu gönderirken, Minimum Reproducible Example (MRE) sağlamak esastır. Bir MRE, yaşadığın sorunu gösteren küçük, bağımsız bir kod parçasıdır. Bir MRE sağlamak, sürdürücülerin ve katkıda bulunanların sorunu anlamasına ve bir düzeltme üzerinde daha verimli çalışmasına yardımcı olur. Bu kılavuz, Ultralytics YOLO depolarına hata raporları gönderirken nasıl MRE oluşturulacağını açıklar.

Sorunu İzole Et#

Bir MRE oluşturmanın ilk adımı sorunu izole etmektir. Sorunla doğrudan ilgili olmayan gereksiz kodları veya bağımlılıkları kaldır. Soruna neden olan kodun belirli kısmına odaklan ve alakasız bölümleri ele.

Halka Açık Modelleri ve Veri Kümelerini Kullan#

Bir MRE oluştururken, sorunu yeniden üretmek için halka açık modelleri ve veri kümelerini kullan. Örneğin, yolo26n.pt modelini ve coco8.yaml veri kümesini kullan. Bu, sürdürücülerin ve katkıda bulunanların özel verilere veya özel modellere erişmeye gerek kalmadan örneğini kolayca çalıştırmasını ve sorunu araştırmasını sağlar.

Gerekli Tüm Bağımlılıkları Dahil Et#

MRE'ne gerekli tüm bağımlılıkların eklendiğinden emin ol. Kodun harici kütüphanelere bağımlıysa, gerekli paketleri ve sürümlerini belirt. İdeal olarak, ultralytics kuruluysa yolo checks kullanarak ya da diğer araçlar için pip list kullanarak bağımlılıkları hata raporunda listele.

Sorunun Net Bir Açıklamasını Yaz#

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

Kodunu Düzgün Biçimlendir#

Kodunu, sorun açıklamasında kod bloklarını kullanarak düzgün bir şekilde biçimlendir. Bu, başkalarının kodunu okumasını ve anlamasını kolaylaştırır. GitHub'da, kodunu üçlü ters tırnak (```) ile sararak ve dili belirterek bir kod bloğu oluşturabilirsin:

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

MRE'ni Test Et#

MRE'ni göndermeden önce, sorunu doğru bir ş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#

İşte varsayımsal bir hata raporu için bir MRE örneği:

Hata açıklaması:

0 kanallı bir görüntüde çı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.3.0
• ultralytics==8.2.0

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

Bu yönergeleri izleyerek, Ultralytics YOLO depolarının sürdürücülerinin ve katkıda bulunanlarının sorununu daha verimli bir şekilde anlamasına ve çözmesine yardımcı olursun.

SSS#

Ultralytics YOLO depolarındaki hata raporları için nasıl etkili bir Minimum Yeniden Üretilebilir Örnek (MRE) oluşturabilirim?#

Ultralytics YOLO depolarındaki hata raporları için etkili bir Minimum Yeniden Üretilebilir Örnek (MRE) oluşturmak adına şu adımları izle:

1. Sorunu İzole Et: Sorunla doğrudan ilgili olmayan kodları veya bağımlılıkları kaldır.
2. Genel Modelleri ve Veri Kümelerini Kullan: Daha kolay yeniden üretilebilirlik için yolo26n.pt ve coco8.yaml gibi halka açık kaynakları kullan.
3. Tüm Gerekli Bağımlılıkları Ekle: Gerekli paketleri ve sürümlerini belirt. ultralytics kuruluysa yolo checks kullanarak ya da pip list kullanarak bağımlılıkları listeleyebilirsin.
4. Sorunun Net Bir Açıklamasını Yaz: Hata mesajları veya günlükler dahil olmak üzere beklenen ve gerçek davranışı açıkla.
5. Kodunu Düzgün Biçimlendir: Kodunu biçimlendirmek için kod bloklarını kullan, bu okunmasını kolaylaştırır.
6. MRE'ni Test Et: MRE'nin sorunu değişiklik yapılmadan yeniden ürettiğinden emin ol.

Ayrıntılı bir kılavuz için bkz. Creating a Minimum Reproducible Example.

Ultralytics YOLO hata raporları için MRE'mde neden halka açık modelleri ve veri kümelerini kullanmalıyım?#

MRE'nde halka açık modelleri ve veri kümelerini kullanmak, sürdürücülerin özel verilere erişmeye gerek kalmadan örneğini kolayca çalıştırabilmesini sağlar. Bu, daha hızlı ve daha verimli bir sorun çözümüne olanak tanır. Örneğin, yolo26n.pt modelini ve coco8.yaml veri kümesini kullanmak, hata ayıklama sürecini standartlaştırmaya ve basitleştirmeye yardımcı olur. Halka açık modeller ve veri kümeleri hakkında daha fazla bilgi edinmek için Use Public Models and Datasets bölümüne göz at.

Ultralytics YOLO için hata raporuma hangi bilgileri dahil etmeliyim?#

Ultralytics YOLO için kapsamlı bir hata raporu şunları içermelidir:

• Net Açıklama: Sorunu, beklenen davranışı ve gerçek davranışı açıkla.
• Hata Mesajları: İlgili hata mesajlarını veya günlükleri dahil et.
• Bağımlılıklar: Gerekli bağımlılıkları ve bunların sürümlerini listele.
• MRE: Bir Minimum Yeniden Üretilebilir Örnek sağla.
• Yeniden Üretme Adımları: Sorunu yeniden üretmek için gereken adımları ana hatlarıyla belirt.

Eksiksiz bir kontrol listesi için Write a Clear Description of the Issue bölümüne bak.

GitHub'da bir hata raporu gönderirken kodumu nasıl düzgün bir şekilde biçimlendirebilirim?#

GitHub'da hata raporu gönderirken kodunu düzgün biçimlendirmek için:

• Kod blokları oluşturmak için üçlü ters tırnak (```) kullan.
• Sözdizimi vurgulama için programlama dilini belirt, örneğin ```python.
• Okunabilirlik için kodunun doğru girintilendiğinden emin ol.

Örnek:

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

Kod biçimlendirmesi hakkında daha fazla ipucu için Format Your Code Properly bölümüne bakın.

Hata raporu için MRE'mi göndermeden önce kontrol etmem gereken bazı yaygın hatalar nelerdir?#

MRE'ni göndermeden önce şunlardan emin ol:

• Sorunun yeniden üretilebilir olduğunu doğrula.
• Tüm bağımlılıkların listelendiğinden ve doğru olduğundan emin ol.
• Gereksiz kodları kaldır.
• MRE'yi, değişiklik yapılmadan sorunu yeniden ürettiğinden emin olmak için test et.

Ayrıntılı bir kontrol listesi için Test Your MRE bölümünü ziyaret et.