# Label StudioのYOLOエクスポートでは、どの判定が残るか

2026年11月18日確認。同じ画像に対する2つの有効な矩形アノテーションをLabel Studio SDK 2.1.2のYOLOコンバーターに渡したところ、デフォルトのエクスポートでは古いアノテーションのクラスが残りました。入力アノテーション配列の順序を逆にしても結果は変わりませんでした。2つの作成時刻を入れ替えると、残るクラスが変わりました。この実験では、架空のタスク1件、ローカル画像パス1つ、有効な矩形2つを使用しました。

コンバーターは有効なアノテーションを作成時刻の新しい順に並べ、両方を出力します。同じ画像に対しては、デフォルトのYOLO書き込み処理が両方のアノテーションに同じラベルパスを作成します。このテストデータでは、古い判定の矩形が2番目に書き込まれ、最初のファイルを置き換えます。両方のクラスがプロジェクトのスキーマで宣言されているため、新しい方のクラスも`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が含まれる |
| ラベラー別のフォルダー、異なる2つのアクターID | アクター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)は、固定された4つのSDKファイル、合計92,423バイトのハッシュを計算します。固定スキーマと実在する架空のローカルパスを使い、実際の単一タスクのファイル読み取り、アノテーションの射影、矩形変換、ラベル書き込み処理を実行します。正確な[観察結果](https://sapien1.com/research/annotation-export-yolo-coco/observations.json)には、入力順序と処理順序、クラスファイル、すべてのラベルパスと行が記録されています。2回の実行で、バイト単位で同一の実行結果記録が生成されました。また、4つのソースファイルは、インストールせずにメモリ上で確認したPyPI 2.1.2 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)
