# Label Studio YOLO 내보내기에서는 어떤 판단이 남을까요?

2026년 11월 18일 확인. 같은 이미지에 대한 활성 박스 주석 2개가 Label Studio SDK 2.1.2 YOLO 변환기에 전달되었을 때, 기본 내보내기는 더 오래된 주석의 클래스를 유지했습니다. 입력 주석 배열의 순서를 뒤집어도 결과는 바뀌지 않았습니다. 두 생성 시간을 서로 바꾸자 남는 클래스가 달라졌습니다. 실험에는 가상의 작업 1개, 로컬 이미지 경로 1개와 유효한 사각형 2개를 사용했습니다.

변환기는 활성 주석을 생성 시간 기준 최신순으로 정렬하고 둘 다 반환합니다. 같은 이미지에 대해 기본 YOLO 작성기는 두 주석에 동일한 라벨 경로를 만듭니다. 이 실험 조건에서는 오래된 판단의 사각형이 두 번째로 기록되어 첫 파일을 덮어씁니다. 두 클래스가 모두 프로젝트 스키마에 선언되어 있으므로 최신 클래스도 `classes.txt`에 표시됩니다. Label Studio 1.23.2 릴리스 태그는 SDK 2.1.2를 지정하며, 일반 YOLO 변환 호출은 `split_labelers`를 기본값으로 둡니다. [앱 의존성](https://github.com/HumanSignal/label-studio/blob/df96d79183156e556d91825d15fa7721f1145e1a/pyproject.toml#L75) · [앱 변환 호출](https://github.com/HumanSignal/label-studio/blob/df96d79183156e556d91825d15fa7721f1145e1a/label_studio/data_export/models.py#L145-L170) · [SDK 분기 처리](https://github.com/HumanSignal/label-studio-sdk/blob/c20c899aaaa302740dacd46a47e5774bb677561f/src/label_studio_sdk/converter/converter.py#L294-L305) · [생성 시간 정렬](https://github.com/HumanSignal/label-studio-sdk/blob/c20c899aaaa302740dacd46a47e5774bb677561f/src/label_studio_sdk/converter/converter.py#L593-L626) · [경로와 빈 결과 처리](https://github.com/HumanSignal/label-studio-sdk/blob/c20c899aaaa302740dacd46a47e5774bb677561f/src/label_studio_sdk/converter/converter.py#L1074-L1109) · [파일 덮어쓰기](https://github.com/HumanSignal/label-studio-sdk/blob/c20c899aaaa302740dacd46a47e5774bb677561f/src/label_studio_sdk/converter/exports/yolo.py#L153-L171)

| 사례 | 결과 |
| --- | --- |
| A가 B보다 오래된 경우, 입력 배열 순서와 무관 | `sample.txt`에 A가 들어 있음 |
| B가 A보다 오래된 경우 | `sample.txt`에 B가 들어 있음 |
| 라벨러별 폴더를 분리하고 서로 다른 작업자 ID 2개를 사용한 경우 | 작업자 11의 파일에 A가, 작업자 12의 파일에 B가 들어 있음 |
| 라벨러별 폴더를 분리하고 같은 작업자 ID를 사용한 경우 | 작업자 11의 파일에 A가 들어 있음 |
| 오래된 결과는 비어 있고 최신 결과가 B인 경우 | `sample.txt`에 B가 들어 있음 |

오래된 결과가 비어 있으면 해당 파일이 아직 없을 때만 빈 파일이 생성됩니다. 이 분기 때문에 생성 시간에 관한 결론은 기본 설정으로 실행한 처음 3회의 유효하고 비어 있지 않은 판단 2개에 한정됩니다. 라벨러별 폴더 분리는 SDK 옵션이며, 같은 작업자가 같은 경로에 기록한 여러 판단을 보존하지는 않습니다. 이 실험 조건은 프로젝트가 입력 판단을 어떻게 선택했는지 또는 모델의 성능이 어떨지는 보여주지 않습니다. [옵션과 기본값](https://github.com/HumanSignal/label-studio-sdk/blob/c20c899aaaa302740dacd46a47e5774bb677561f/src/label_studio_sdk/converter/converter.py#L966-L994)

검토 이력을 보존해야 하는 전달물이라면, 의견이 엇갈렸던 항목을 하나 골라 원본 내보내기와 전달 형식에서 비교하세요. 최종 텍스트 파일만으로는 어떤 판단이 선택되었는지 그 이유를 알 수 없습니다. 팀이 의도적으로 이미지당 판단 1개를 원한다면, 전달용 라벨로 단일화하기 전에 선택 또는 판정 규칙을 기록하세요.

파이프라인 실패 확인을 활성화한 상태로 `python3 check.py | cmp - observations.json`을 실행하세요. 표준 라이브러리를 사용하는 [검사기](https://sapien1.com/research/annotation-export-yolo-coco/check.py)는 고정된 SDK 파일 4개에 걸쳐 총 92,423바이트의 해시를 계산합니다. 고정된 스키마와 실제로 존재하는 가상의 로컬 경로를 사용해 실제 단일 작업 파일 판독기, 주석 투영, 사각형 변환과 라벨 작성기를 실행합니다. 정확한 [관찰 기록](https://sapien1.com/research/annotation-export-yolo-coco/observations.json)에는 입력 및 처리 순서, 클래스 파일, 모든 라벨 경로와 행이 기록되어 있습니다. 두 번의 실행에서 바이트 단위로 동일한 결과 기록이 생성되었습니다. 소스 파일 4개는 설치 없이 메모리에서 검사한 PyPI 2.1.2 wheel과도 바이트 단위로 일치했습니다. wheel의 크기는 1,066,859바이트이고 SHA-256은 `8b95a4021f0bb4bd5a4cdce38d998cfbc0028d68681f0fd3e9907525967013c3`입니다. 이 실험은 전체 서비스, 해당 직렬화기 또는 SDK의 작업 배열 파서를 실행하지 않습니다. [PyPI 배포판](https://pypi.org/project/label-studio-sdk/2.1.2/#files)

Label Studio 1.11.0에 관한 이전 보고서는 같은 작업에 새 주석을 추가한 후에도 오래된 판단이 남는 현상을 설명합니다. 이 SDK 2.1.2 실험 조건은 고정된 라벨 어휘와 이미지 경로 1개에서 그 유지 효과를 재현합니다. 대조 실험은 생성 시간 순서와 입력 순서, 작업자별 그룹화, 빈 결과의 영향을 구분합니다. 별도 보고서에서는 서로 다른 이미지의 중복된 기본 파일명과 비어 있는 COCO 주석과 검토하지 않은 COCO 주석 사이의 모호성을 다룹니다. 이 패키지에는 독자적으로 작성한 Python 코드와 가상의 관찰 자료가 들어 있습니다. 검사기는 실행 시 고정된 공개 Apache-2.0 SDK 소스를 가져옵니다. [이전 YOLO 보고서](https://github.com/HumanSignal/label-studio/issues/5421) · [중복 기본 파일명 보고서](https://github.com/HumanSignal/label-studio/issues/7096) · [빈 COCO 보고서](https://github.com/HumanSignal/label-studio/issues/9774) · [SDK 라이선스](https://github.com/HumanSignal/label-studio-sdk/blob/c20c899aaaa302740dacd46a47e5774bb677561f/LICENSE)
