Label Studio Entegrasyonu#

Doğrudan Label Studio içe aktarma özelliği Ultralytics Platform'a geliyor; böylece ham bir görüntü algılama veya segmentasyon dışa aktarımı, seçilecek bir biçim olmadan olduğu gibi yüklenebilecek.

O zamana kadar bugün kullanabileceğin kısa bir yol var: Label Studio'nun YOLO with Images dışa aktarma seçeneği, Platform'un okuyabildiği bir düzen kullanır ve sınıf listesini de içerir.

Bugün Label Studio'dan İçe Aktar#

1. Label Studio'dan dışa aktar. Projeni aç ve Export'a tıkla.
2. Görüntüleri içeren bir biçim seç. YOLO with Images seçeneğini veya döndürülmüş kutular için YOLOv8 OBB with Images seçeneğini belirle ve Export'a tıkla.
3. Platform'a yükle. ZIP'ten yeni bir veri kümesi oluştur.
4. Eğit. Çalışma alanından çıkmadan açıklamaları düzenle, eğit ve dağıt.

API ile Dışa Aktar#

Label Studio'nun dışa aktarma API'si, biçim adını exportType içinde içeren 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.zip

COCO_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 taşıyıcı belirteçle değiştirilir; bu nedenle örneğinin hangi belirteç türünü verdiğini kontrol et. Büyük projelerde bunun yerine dışa aktarımı arka plan işi olarak oluşturan ve kimliğine göre indiren snapshot uç noktalarını kullan; SDK'nın export_yolo_with_images.py örneği tam olarak bunu yapar.

Label Studio YOLO dışa aktarımı, etiketlerin yanında sınıf listesini de taşır ve Platform bu listeyi okur:

archive.zip/
├── classes.txt        # class names Platform reads first
├── notes.json         # fallback, used only when classes.txt is missing or empty
├── images/
└── labels/

Platform, arşivdeki en üst düzeyde bulunan classes.txt (veya notes.json) dosyasını okur; bu nedenle dışa aktarımı açıp bir klasörün içinde yeniden ZIP'lesen bile etiket adları korunur.

Dışa Aktarım Biçimi Seçme#

Label Studio çeşitli dışa aktarma biçimleri sunar. Görüntü algılama ve segmentasyon için:

COCO dışa aktarımında, okunabilmesi için her anotasyonun bbox içermesi gerekir; kalabalık bölgeler ("iscrowd": 1) atlanır ve kategori adları sınıf adların olur — bu nedenle COCO arşivinin etiketleri korumak için classes.txt dosyasına ihtiyacı yoktur.

Neler Aktarılır#

Platform, dışa aktarımdaki etiketlere göre YOLO görevini belirler:

• Döndürülmüş kutular — YOLO ve COCO dışa aktarımları dönüşü kaybeder; korumak için YOLOv8 OBB with Images kullan.
• Anahtar noktalar — Label Studio'nun YOLO dışa aktarımı, yalnızca KeyPointLabels içindeki <Label> öğesinin model_index özniteliği varsa ve nokta bir dikdörtgenin içinde çizilmişse anahtar noktayı içerir; aksi durumda dışa aktarımda yalnızca kutular bulunur ve veri kümesi detect olarak içe aktarılır.
• Dört noktalı çokgenler — YOLO dosyalarında tam olarak dört noktalı bir çokgen, yönlendirilmiş bir kutuyla aynı görünür; bu nedenle tüm etiketlerin dört noktalı çokgen olduğu bir YOLO dışa aktarımı OBB olarak içe aktarılır. Bu tür projelerde COCO with Images kullan.

Entegrasyon Neler Getirecek?#

Doğru dışa aktarma biçimini seçmek, entegrasyonun ortadan kaldıracağı adımdır. Entegrasyon kullanıma sunulduğunda Label Studio'nun görüntü algılama ve segmentasyon biçimlerinden herhangi birini dışa aktarabilecek, dosyayı yükleyebilecek ve Platform anotasyonları uygun YOLO görevine otomatik olarak eşleyecek.

• Seçilecek biçim yok — Label Studio'nun görüntü algılama ve segmentasyon dışa aktarımları, 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 bölünmez
• Açıklama eklemeye devam et — içe aktarılan veri kümeleri, SAM destekli akıllı açıklama ekleme dâhil Platform'un açıklama düzenleyicisinde açılır
• Hemen eğit — işleme tamamlanır tamamlanmaz veri kümeleri bulut eğitimine hazır olur

Sık Sorulan Sorular#