Label Studio Entegrasyonu#
Doğrudan Label Studio içe aktarma özelliği Ultralytics Platform'a geliyor; böylece ham görüntü algılama veya segmentasyon dışa aktarması, herhangi bir format seçmeye gerek kalmadan olduğu gibi yüklenebilecek.
O zamana kadar bugün çalışabilen kısa bir yol var; çünkü Label Studio'nun YOLO with Images dışa aktarması, sınıf listesini de içeren ve Platform'un okuyabildiği bir düzendir.
Bugün Label Studio'dan İçe Aktarma#
- Label Studio'dan dışa aktar. Projeni aç ve Export'a tıkla.
- Görüntüleri içeren bir format seç. YOLO with Images seçeneğini belirle ve Export'a tıkla.
- Platform'a yükle. ZIP dosyasından yeni bir veri kümesi oluştur.
- Eğit. Çalışma alanından çıkmadan ek açıklamaları düzenle, eğit ve dağıt.
Label Studio'nun YOLO ve COCO seçenekleri, görüntüler olmadan etiket dosyaları oluşturur; çünkü görüntülerin normalde Label Studio'nun yönlendirildiği URL'lerin arkasında bulunur. Bu arşivlerden birini Platform'a yüklemek, görüntü içermeyen bir veri kümesi oluşturur. Bunun yerine with Images varyantını seç.
API ile Dışa Aktarma#
Label Studio'nun dışa aktarma API'si, format adı exportType içinde olacak şekilde aynı arşivi döndürür:
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 ve YOLO_OBB_WITH_IMAGES aynı şekilde çalışır. Daha yeni kişisel erişim belirteçleri, kullanılmadan önce kısa ömürlü bir bearer token ile değiştirilir; bu nedenle örneğinin hangi token türünü verdiğini kontrol et. Büyük projelerde bunun yerine snapshot uç noktalarını kullanmalısın; bunlar dışa aktarmayı arka plan işi olarak oluşturur ve kimliğine göre indirir. SDK'deki export_yolo_with_images.py örneği de tam olarak bunu yapar.
Bir Label Studio YOLO dışa aktarması, sınıf listesini etiketlerin yanında taşır ve Platform bunu okur:
archive.zip/
├── classes.txt # class names Platform reads first
├── notes.json # fallback, used only when classes.txt is missing or empty
├── images/
└── labels/Arşivi tam olarak Label Studio'nun oluşturduğu şekilde yükle. Platform, arşivin kökünde classes.txt ve notes.json dosyalarını arar; bu nedenle dışa aktarmayı başka bir klasörün içine yeniden sıkıştırmak etiket adlarını kaybettirir ve sınıflar class0, class1 ve benzeri şekilde içe aktarılır.
Dışa Aktarma Formatı Seçme#
Label Studio birkaç dışa aktarma formatı sunar. Görüntü algılama ve segmentasyon için:
| Label Studio Formatı | Çalışır | Notlar |
|---|---|---|
| YOLO with Images | En iyi | classes.txt dosyasını ve görüntüleri içerir; bu nedenle tek bir yükleme yeterlidir |
| COCO with Images | Evet | Bu da okunur; poligon ve kutuların karışımı segment olarak içe aktarılır, yalnızca kutu içerenler atılır |
| YOLO / COCO | Hayır | Yalnızca ek açıklama dosyaları — veri kümesi görüntü olmadan içe aktarılır |
| Pascal VOC XML | Hayır | XML etiket dosyaları okunamaz |
Bir COCO dışa aktarmasında her ek açıklamanın okunabilmesi için bbox içermesi gerekir; kalabalık bölgeleri ("iscrowd": 1) atlanır ve
kategori adları sınıf adların olur — bu nedenle bir COCO arşivinin etiketlerini korumak için classes.txt gerekmez.
Platform, Pascal VOC XML etiketlerini okumaz ve bir VOC dışa aktarması açıkça hata vermek yerine sessizce başarısız olur: görüntüler içe aktarılır, ancak ek açıklamalar aktarılmaz. Bunun yerine YOLO with Images veya COCO with Images seç.
Entegrasyon Neler Ekleyebilir?#
Doğru dışa aktarma formatını seçme adımı, entegrasyonun ortadan kaldırdığı şeydir. Özellik kullanıma sunulduğunda, Label Studio'nun görüntü algılama ve segmentasyon formatlarından herhangi birini dışa aktaracak, yükleyecek ve Platform da ek açıklamaları uygun YOLO görevi ile kendisi eşleştirecek.
- Seçilecek format yok — Label Studio'nun görüntü algılama ve segmentasyon dışa aktarmaları, etiket adları korunarak bir YOLO veri kümesine eşlenir
- Tek çalışma alanı — etiketleme, eğitim ve dağıtım artık ayrı araçlara ve bir dönüştürme betiğine yayılmaz
- Ek açıklama eklemeye devam et — içe aktarılan veri kümeleri, SAM destekli akıllı ek açıklama da dahil olmak üzere Platform'un ek açıklama düzenleyicisinde açılır
- Hemen eğit — veri kümeleri işlenmeyi tamamlar tamamlamaz bulut eğitimine hazır olur