バグレポート用の最小再現可能例を作成する#

Ultralytics の YOLO リポジトリにバグレポートを提出する際は、最小再現可能例（MRE） を提供することが重要です。MREとは、発生している問題を示す、小規模で自己完結型のコードです。MREを提供すると、メンテナーやコントリビューターが問題を理解し、より効率的に修正に取り組めるようになります。このガイドでは、Ultralytics YOLOリポジトリにバグレポートを提出する際のMREの作成方法を説明します。

1. 問題を切り分ける#

MREを作成する最初のステップは、問題を切り分けることです。問題に直接関係しない不要なコードや依存関係を削除します。問題の原因となっているコードの具体的な部分に焦点を当て、関係のないセクションを取り除きます。

2. 公開モデルとデータセットを使用する#

MREを作成するときは、問題を再現するために公開されているモデルとデータセットを使用します。たとえば、yolo26n.pt モデルと coco8.yaml データセットを使用します。これにより、メンテナーやコントリビューターは、専有データやカスタムモデルへのアクセスを必要とせずに、例を簡単に実行して問題を調査できます。

3. 必要な依存関係をすべて含める#

必要な依存関係がすべてMREに含まれていることを確認します。コードが外部ライブラリに依存している場合は、必要なパッケージとそのバージョンを指定します。理想的には、ultralytics がインストールされている場合は yolo checks を使用し、それ以外のツールには pip list を使用して、バグレポートに依存関係を一覧表示します。

4. 問題を明確に説明する#

発生している問題を明確かつ簡潔に説明します。期待される動作と、実際に発生している動作を説明します。該当する場合は、関連するエラーメッセージやログも含めます。

5. コードを適切にフォーマットする#

問題の説明では、コードブロックを使用してコードを適切にフォーマットします。これにより、他の人がコードを読み、理解しやすくなります。GitHubでは、コードをトリプルバッククォート（```）で囲み、言語を指定することでコードブロックを作成できます：

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

6. MREをテストする#

MREを提出する前にテストし、問題を正確に再現できることを確認します。他の人が問題なく、また変更を加えずに例を実行できることを確認してください。

MREの例#

以下は、架空のバグレポートにおけるMREの例です：

バグの説明：

0チャンネル画像で推論を実行すると、入力テンソルの次元に関連するエラーが発生します。

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)

エラーメッセージ：

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

依存関係：

• torch==2.8.0
• ultralytics==8.4.142

この例のMREは、最小限のコードで問題を示し、公開モデル（"yolo26n.pt"）を使用し、必要な依存関係をすべて含め、エラーメッセージとともに問題を明確に説明しています。

これらのガイドラインに従うことで、Ultralytics YOLOリポジトリのメンテナーやコントリビューターが問題をより効率的に理解し、解決できるようになります。

FAQ#