Link to this sectionHata Raporları için Minimum Yeniden Üretilebilir Örnek Oluşturma#

Ultralytics YOLO depoları için bir hata raporu gönderirken, bir Minimum Yeniden Üretilebilir Örnek (MRE) sağlaman çok önemlidir. MRE, yaşadığın sorunu gösteren küçük, kendi kendine yeten bir kod parçasıdır. Bir MRE sağlamak, bakım yapanların ve katkıda bulunanların sorunu anlamalarına ve bir düzeltme üzerinde daha verimli çalışmalarına yardımcı olur. Bu kılavuz, Ultralytics YOLO depolarına hata raporları gönderirken nasıl MRE oluşturulacağını açıklar.

Link to this sectionSorunu İ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.

Link to this sectionHalka 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, bakım yapanların ve katkıda bulunanların, tescilli verilere veya özel modellere ihtiyaç duymadan örneğini kolayca çalıştırmalarını ve sorunu araştırmalarını sağlar.

Link to this sectionGerekli Tüm Bağımlılıkları Dahil Et#

Ensure all necessary dependencies are included in your MRE. If your code relies on external libraries, specify the required packages and their versions. Ideally, list the dependencies in your bug report using yolo checks if you have ultralytics installed or pip list for other tools.

Link to this sectionSorunun 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.

Link to this sectionKodunu 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
```

Link to this sectionMRE'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.

Link to this sectionMRE Ö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ı:

Bağımlılıklar:

• torch==2.3.0
• ultralytics==8.2.0

Bu örnekte, MRE sorunu minimum miktarda kodla gösteriyor, halka açık bir model ("yolo26n.pt") kullanıyor, gerekli tüm bağımlılıkları içeriyor ve hata mesajıyla birlikte sorunun net bir açıklamasını sunuyor.

Bu yönergeleri izleyerek, Ultralytics YOLO depolarının bakımcılarının ve katkıda bulunanlarının sorunu daha verimli bir şekilde anlamalarına ve çözmelerine yardımcı olacaksın.

Link to this sectionSSS#

Link to this sectionUltralytics 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. Halka Açık Modelleri ve Veri Kümelerini Kullan: Daha kolay yeniden üretilebilirlik için yolo26n.pt ve coco8.yaml gibi herkese açık kaynakları kullan.
3. Include All Necessary Dependencies: Specify required packages and their versions. You can list dependencies using yolo checks if you have ultralytics installed or pip list.
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 Minimum Yeniden Üretilebilir Örnek Oluşturma kısmına bak.

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

MRE'nde halka açık model ve veri kümelerini kullanmak, bakımcıların tescilli verilere ihtiyaç duymadan örneğini kolayca çalıştırmalarını 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 Halka Açık Modelleri ve Veri Kümelerini Kullan bölümünden daha fazla bilgi edinebilirsin.

Link to this sectionUltralytics 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.

Tam bir kontrol listesi için Sorunun Net Bir Açıklamasını Yaz bölümüne bak.

Link to this sectionGitHub'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 Kodunu Düzgün Biçimlendir kısmına bak.

Link to this sectionHata 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 MRE'ni Test Et bölümünü ziyaret et.