Ultralytics YOLO27: Iscriviti alla lista d'attesa.
Get Started
Coming Soon

Integrazione con Label Studio#

Le importazioni dirette da Label Studio saranno presto disponibili in Ultralytics Platform, così potrai caricare direttamente un'esportazione grezza per il rilevamento o la segmentazione di immagini, senza dover scegliere un formato.

Nel frattempo, puoi seguire una procedura breve già disponibile: l'esportazione YOLO with Images di Label Studio usa una struttura che Platform è in grado di leggere, compreso l'elenco delle classi.

Importa subito da Label Studio#

  1. Esporta da Label Studio. Apri il progetto e fai clic su Export.
  2. Scegli un formato che includa le immagini. Seleziona YOLO with Images oppure YOLOv8 OBB with Images per i riquadri ruotati, quindi fai clic su Export.
  3. Carica su Platform. Crea un nuovo dataset a partire dallo ZIP.
  4. Addestra. Modifica le annotazioni, addestra e distribuisci senza uscire dallo spazio di lavoro.

Importazione di dataset Label Studio in Ultralytics Platform

Le esportazioni YOLO e COCO standard contengono solo le annotazioni

Le opzioni YOLO e COCO di Label Studio generano file di etichette senza le immagini, perché di norma le immagini si trovano agli URL a cui è stato collegato Label Studio. Se carichi uno di questi archivi su Platform, l'operazione non riesce perché non vengono trovate immagini. Scegli invece la variante with Images.

Esporta tramite API#

L'API di esportazione di Label Studio restituisce lo stesso archivio, con il nome del formato in 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.zip

COCO_WITH_IMAGES e YOLO_OBB_WITH_IMAGES funzionano allo stesso modo. I più recenti token di accesso personali vengono scambiati con un token bearer a breve durata prima dell'uso: verifica quindi quale tipo di token genera la tua istanza. Per i progetti di grandi dimensioni, usa invece gli endpoint snapshot, che creano l'esportazione come processo in background e la rendono scaricabile tramite ID; l'esempio export_yolo_with_images.py dell'SDK fa proprio questo.

Un'esportazione YOLO di Label Studio include l'elenco delle classi insieme alle etichette, e Platform lo legge:

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

Platform legge il classes.txt (o notes.json) più superficiale nell'archivio, quindi i nomi delle etichette restano disponibili anche se hai estratto un'esportazione e l'hai compressa di nuovo all'interno di una cartella.

Scelta del formato di esportazione#

Label Studio offre diversi formati di esportazione. Per il rilevamento e la segmentazione di immagini:

Formato di Label StudioCompatibilitàNote
YOLO with ImagesOttimaleInclude classes.txt e le immagini, quindi basta un solo caricamento
YOLOv8 OBB with ImagesSìMantiene la rotazione dei riquadri e viene importato come dataset OBB
COCO with ImagesSìViene letto anche questo; è la scelta migliore se ogni annotazione è un poligono a quattro punti
YOLO / COCONoSolo file di annotazione: il caricamento non riesce perché non vengono trovate immagini
Pascal VOC XMLNoI file di etichette XML non possono essere letti

In un'esportazione COCO, ogni annotazione deve includere un bbox per essere letta; le regioni crowd ("iscrowd": 1) vengono ignorate e i nomi delle categorie diventano i nomi delle classi. Perciò, un archivio COCO non ha bisogno di classes.txt per mantenere le etichette.

Pascal VOC viene importato senza annotazioni

Platform non legge le etichette Pascal VOC XML e un'esportazione VOC non genera un errore esplicito: le immagini vengono importate, ma non i riquadri; inoltre, se l'esportazione contiene almeno cinque immagini, viene aggiunta una sola classe denominata images. Scegli invece YOLO with Images o COCO with Images.

Cosa viene mantenuto#

Platform seleziona l'attività YOLO in base alle etichette presenti nell'esportazione:

Etichette di Label StudioDataset Platform
RectangleLabelsRilevamento oppure OBB da un'esportazione YOLOv8 OBB
PolygonLabelsSegmentazione oppure OBB da un'esportazione YOLO, se ogni poligono ha quattro punti
RectangleLabels + PolygonLabelsSegmentazione: i riquadri restano modificabili, ma per l'addestramento vengono usati solo i poligoni
KeyPointLabels all'interno di un rettangoloPosa
ChoicesNon viene esportato nei formati YOLO o COCO di Label Studio, quindi le immagini vengono importate senza etichette
  • Riquadri ruotati — le esportazioni YOLO e COCO eliminano la rotazione; usa YOLOv8 OBB with Images per conservarla.
  • Punti chiave — l'esportazione YOLO di Label Studio include un punto chiave solo se il suo <Label> in KeyPointLabels ha un attributo model_index e il punto è stato disegnato all'interno di un rettangolo; altrimenti, l'esportazione contiene solo i riquadri e il dataset viene importato come attività di rilevamento.
  • Poligoni a quattro punti — nei file YOLO, un poligono con esattamente quattro punti è indistinguibile da un riquadro orientato; pertanto, un'esportazione YOLO in cui ogni etichetta è un poligono a quattro punti viene importata come OBB. Per questi progetti, usa COCO with Images.

Cosa aggiungerà l'integrazione#

La scelta del formato di esportazione corretto è proprio il passaggio che l'integrazione eliminerà. Quando sarà disponibile, potrai esportare qualsiasi formato di Label Studio per il rilevamento e la segmentazione di immagini, caricarlo e lasciare che Platform associ autonomamente le annotazioni all'attività YOLO corrispondente.

  • Nessun formato da scegliere — le esportazioni di Label Studio per il rilevamento e la segmentazione di immagini vengono associate a un dataset YOLO mantenendo i nomi delle etichette
  • Un solo spazio di lavoro — annotazione, addestramento e distribuzione non richiedono più strumenti separati né uno script di conversione
  • Continua ad annotare — i dataset importati si aprono nell'editor di annotazioni di Platform, con annotazione intelligente basata su SAM
  • Addestra subito — i dataset sono pronti per l'addestramento nel cloud non appena l'elaborazione è terminata
Disponibile ora

Le integrazioni con Labelbox e Roboflow sono già operative e Platform importa direttamente dataset YOLO, COCO, JSON di LabelMe e NDJSON di Ultralytics o Labelbox.

Domande frequenti#

  • Scegli YOLO with Images per includere nell'archivio classes.txt e le immagini. È possibile importare anche COCO with Images. Le opzioni YOLO e COCO standard generano solo file di etichette e Pascal VOC XML non viene letto.

  • È stata usata l'esportazione standard YOLO o COCO. Questi archivi non includono le immagini perché normalmente Label Studio le serve tramite URL. Esporta di nuovo usando la variante with Images.

  • L'archivio non contiene classes.txt o notes.json, probabilmente perché è stato ricreato usando solo le cartelle images/ e labels/. Carica lo ZIP esportato da Label Studio, che include entrambi i file.

  • Sì. Chiama l'endpoint di esportazione con exportType=YOLO_WITH_IMAGES oppure con COCO_WITH_IMAGES e YOLO_OBB_WITH_IMAGES. Per i progetti di grandi dimensioni, usa gli endpoint snapshot, che creano l'esportazione come processo in background.

Collaboratori
GLglenn-jocher4RAraimbekovm3SEsergiuwaxmann1

Commenti