버그 보고를 위한 최소 재현 예제 작성#

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

# 모델을 로드합니다
model = YOLO("yolo26n.pt")

# 채널이 0개인 이미지 로드
image = torch.rand(1, 0, 640, 640)

# 모델 실행
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 리포지토리의 유지관리자와 기여자가 문제를 더 효율적으로 이해하고 해결하는 데 도움이 됩니다.

자주 묻는 질문#