Label Studio連携#
Label Studioからの直接インポートがUltralytics Platformに対応する予定です。これにより、画像検出またはセグメンテーションの未加工のエクスポートを、形式を選択せずそのままアップロードできます。
それまでは、Label StudioのYOLO with ImagesエクスポートがPlatformで読み取れるレイアウトでクラスリストも含まれているため、現在利用できる簡単な手順があります。
現在Label Studioからインポートする#
- Label Studioからエクスポートします。 プロジェクトを開き、Exportをクリックします。
- 画像を含む形式を選択します。 **YOLO with Images**を選択し、Exportをクリックします。
- Platformにアップロードします。 ZIPから新しいデータセットを作成します。
- トレーニングします。 ワークスペースを離れずに、アノテーションを編集し、トレーニングして、デプロイできます。
Label StudioのYOLOおよびCOCOオプションでは、画像なしでラベルファイルが書き出されます。これは通常、画像がLabel Studioに指定したURLの先に保存されているためです。これらのアーカイブのいずれかをPlatformにアップロードすると、画像のないデータセットになります。代わりにwith Imagesのバリアントを選択してください。
APIでエクスポートする#
Label Studioのexport APIは、exportTypeに形式名が含まれた同じアーカイブを返します。
curl -X GET "https://<your-label-studio>/api/projects/<project-id>/export?exportType=YOLO_WITH_IMAGES&download_all_tasks=true" \
-H "Authorization: Token <your-legacy-token>" \
-o dataset.zipCOCO_WITH_IMAGESとYOLO_OBB_WITH_IMAGESは同じ方法で機能します。新しいpersonal access tokensは使用前に短期間有効なベアラートークンに交換されるため、インスタンスが発行するトークンの種類を確認してください。大規模なプロジェクトでは、代わりにスナップショットエンドポイントを使用してください。これらはバックグラウンドジョブとしてエクスポートを作成し、IDでダウンロードします。SDKのexport_yolo_with_images.pyの例では、まさにこの処理を行います。
Label StudioのYOLOエクスポートには、ラベルとともにクラスリストが含まれており、Platformはこれを読み取ります。
archive.zip/
├── classes.txt # class names Platform reads first
├── notes.json # fallback, used only when classes.txt is missing or empty
├── images/
└── labels/アーカイブはLabel Studioが生成したとおりにアップロードしてください。Platformはアーカイブのルートにあるclasses.txtとnotes.jsonを探すため、別のフォルダー内にエクスポートを再圧縮するとラベル名が失われ、クラスはclass0、class1などとしてインポートされます。
エクスポートフォーマットの選択#
Label Studioでは複数のエクスポート形式を利用できます。画像検出およびセグメンテーションの場合は、次のとおりです。
| Label Studio形式 | 対応状況 | 注記 |
|---|---|---|
| YOLO with Images | 最適 | classes.txtと画像が含まれるため、1回のアップロードで十分です |
| COCO with Images | はい | こちらも読み取り可能です。ポリゴンとボックスが混在している場合はセグメントとしてインポートされ、ボックスのみのものは除外されます |
| YOLO / COCO | いいえ | アノテーションファイルのみ — データセットは画像なしでインポートされます |
| Pascal VOC XML | いいえ | XMLラベルファイルは読み取れません |
COCOエクスポートでは、読み取るためにすべてのアノテーションにbboxが必要です。crowd領域（"iscrowd": 1）はスキップされ、カテゴリ名がクラス名になります。そのため、COCOアーカイブではラベルを保持するためにclasses.txtは必要ありません。
PlatformはPascal VOC XMLラベルを読み取らず、VOCエクスポートは明示的なエラーではなく静かに失敗します。画像はインポートされますが、アノテーションはインポートされません。代わりにYOLO with ImagesまたはCOCO with Imagesを選択してください。
連携で追加される機能#
適切なエクスポート形式を選択することが、今回の連携で解消される手順です。対応後は、Label Studioの画像検出およびセグメンテーション形式のいずれかをエクスポートしてアップロードするだけで、Platformがアノテーションを対応するYOLOタスクに自動的にマッピングします。
- 選択する形式はありません — Label Studioの画像検出およびセグメンテーションのエクスポートは、ラベル名を保持したYOLOデータセットにマッピングされます
- 1つのワークスペース — ラベリング、トレーニング、デプロイが複数のツールや変換スクリプトにまたがることがなくなります
- アノテーションを継続 — インポートしたデータセットは、SAMを利用したスマートアノテーションを含め、Platformのアノテーションエディターで開けます
- すぐにトレーニング — データセットは処理が完了するとすぐにクラウドトレーニングに使用できます