Ultralytics YOLO27: 대기자 명단에 등록해 주십시오.
Get Started
Coming Soon

Label Studio 통합#

Label Studio에서 Ultralytics Platform으로 직접 가져오는 기능이 곧 제공됩니다. 그러면 이미지 감지 또는 세그멘테이션 원본 내보내기를 형식을 선택하지 않고 그대로 업로드할 수 있습니다.

그때까지는 지금 바로 사용할 수 있는 간단한 방법이 있습니다. Label Studio의 YOLO with Images 내보내기는 클래스 목록을 포함해 Platform이 읽을 수 있는 구조로 제공되기 때문입니다.

지금 Label Studio에서 가져오기#

  1. Label Studio에서 내보냅니다. 프로젝트를 열고 내보내기를 클릭합니다.
  2. 이미지가 포함된 형식을 선택합니다. YOLO with Images를 선택하거나, 회전된 박스의 경우 YOLOv8 OBB with Images를 선택한 다음 내보내기를 클릭합니다.
  3. Platform에 업로드. ZIP에서 새 데이터셋을 생성하세요.
  4. 학습. 작업 공간을 벗어나지 않고 어노테이션을 편집하고, 학습한 다음, 배포하세요.

Ultralytics Platform Label Studio 데이터셋 가져오기

일반 YOLO 및 COCO 내보내기에는 어노테이션만 포함됩니다

Label Studio의 YOLO 및 COCO 옵션은 이미지 없이 레이블 파일만 기록합니다. 일반적으로 이미지는 Label Studio가 참조하는 URL에 있기 때문입니다. 이러한 아카이브를 Platform에 업로드하면 이미지를 찾을 수 없어 업로드에 실패합니다. 대신 with Images 변형 형식을 선택하세요.

API로 내보내기#

Label Studio의 내보내기 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.zip

COCO_WITH_IMAGES과 YOLO_OBB_WITH_IMAGES은 같은 방식으로 작동합니다. 최신 개인 액세스 토큰은 사용 전에 수명이 짧은 베어러 토큰으로 교환되므로, 인스턴스에서 어떤 토큰 유형을 발급하는지 확인하세요. 대규모 프로젝트에는 스냅샷 엔드포인트를 사용하는 것이 좋습니다. 이 엔드포인트는 백그라운드 작업으로 내보내기를 생성한 뒤 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/

Platform은 아카이브에서 가장 바깥쪽에 있는 classes.txt(또는 notes.json)을 읽으므로, 폴더 안에서 압축을 풀고 다시 압축한 내보내기도 레이블 이름을 유지합니다.

내보내기 형식 선택#

Label Studio는 여러 내보내기 형식을 제공합니다. 이미지 감지 및 세그멘테이션에는 다음 형식을 사용하세요.

Label Studio 형식지원 여부참고
YOLO with Images최적classes.txt과 이미지가 함께 포함되므로 한 번만 업로드하면 됩니다
YOLOv8 OBB with Images예박스 회전을 유지하며 OBB 데이터셋으로 가져옵니다
COCO with Images예이 형식도 읽을 수 있으며, 각 어노테이션이 4개 점으로 이루어진 폴리곤일 때 더 적합합니다
YOLO / COCO아니요어노테이션 파일만 포함되므로 이미지를 찾을 수 없어 업로드에 실패합니다
Pascal VOC XML아니요XML 레이블 파일은 읽을 수 없습니다

COCO 내보내기를 읽으려면 각 어노테이션에 bbox이 있어야 합니다. 군중 영역("iscrowd": 1)은 건너뛰며, 카테고리 이름이 클래스 이름이 됩니다. 따라서 레이블을 유지하기 위해 COCO 아카이브에 classes.txt가 필요하지 않습니다.

Pascal VOC는 어노테이션 없이 가져옵니다

Platform은 Pascal VOC XML 레이블을 읽지 않습니다. 또한 VOC 내보내기는 오류를 명확히 표시하지 않고 조용히 실패합니다. 이미지는 가져오지만 박스는 가져오지 않으며, 이미지가 5개 이상인 내보내기에는 images이라는 단일 클래스도 추가됩니다. 대신 YOLO with Images 또는 COCO with Images를 선택하세요.

유지되는 항목#

Platform은 내보내기의 레이블을 바탕으로 YOLO 작업을 선택합니다.

Label Studio 레이블Platform 데이터셋
RectangleLabels감지 또는 YOLOv8 OBB 내보내기를 사용한 경우 OBB
PolygonLabels세그먼트 또는 모든 폴리곤이 4개 점으로 이루어진 YOLO 내보내기의 경우 OBB
RectangleLabels + PolygonLabels세그먼트 — 박스는 편집 가능한 상태로 유지되지만, 학습에는 폴리곤만 사용됩니다
사각형 안의 KeyPointLabels포즈
ChoicesLabel Studio의 YOLO 또는 COCO 형식으로 내보내지 않으므로 이미지가 레이블 없이 가져와집니다
  • 회전된 박스 — YOLO 및 COCO 내보내기는 회전 정보를 제외합니다. 회전 정보를 유지하려면 YOLOv8 OBB with Images를 사용하세요.
  • 키포인트 — Label Studio의 YOLO 내보내기에는 KeyPointLabels의 <Label>에 model_index 속성이 있고 점이 사각형 안에 그려진 경우에만 키포인트가 포함됩니다. 그렇지 않으면 내보내기에는 박스만 들어가고 데이터셋은 감지 작업으로 가져옵니다.
  • 4개 점 폴리곤 — YOLO 파일에서는 점이 정확히 4개인 폴리곤이 방향성 박스와 동일하게 보이므로, 모든 레이블이 4개 점 폴리곤인 YOLO 내보내기는 OBB로 가져옵니다. 이러한 프로젝트에는 COCO with Images를 사용하세요.

통합으로 추가될 기능#

적절한 내보내기 형식을 선택하는 과정은 통합 기능을 통해 생략할 수 있습니다. 통합 기능이 제공되면 Label Studio의 이미지 감지 및 세그멘테이션 형식 중 어떤 것이든 내보내 업로드할 수 있고, Platform이 어노테이션을 적절한 YOLO 작업에 자동으로 매핑합니다.

  • 형식 선택 불필요 — Label Studio의 이미지 감지 및 세그멘테이션 내보내기는 레이블 이름을 유지한 YOLO 데이터셋으로 매핑됩니다
  • 하나의 작업 공간 — 레이블링, 학습, 배포를 별도 도구와 변환 스크립트에서 나누어 진행할 필요가 없습니다.
  • 어노테이션 계속하기 — 가져온 데이터셋은 SAM 기반 스마트 어노테이션을 포함하여 Platform의 어노테이션 편집기에서 열립니다.
  • 즉시 학습하기 — 처리가 완료되는 즉시 데이터셋을 클라우드 학습에 사용할 수 있습니다.
현재 사용 가능

Labelbox 및 Roboflow 통합은 현재 사용할 수 있으며, Platform은 YOLO, COCO, LabelMe JSON, Ultralytics 또는 Labelbox NDJSON 데이터셋을 직접 가져옵니다.

자주 묻는 질문#

  • 아카이브에 classes.txt과 이미지가 포함되도록 YOLO with Images를 선택하세요. COCO with Images도 가져올 수 있습니다. 일반 YOLO 및 COCO 옵션은 레이블 파일만 기록하며, Pascal VOC XML은 읽을 수 없습니다.

  • 일반 YOLO 또는 COCO 내보내기를 사용했습니다. Label Studio는 일반적으로 URL에서 이미지를 제공하므로 이러한 아카이브에는 이미지가 포함되지 않습니다. with Images 변형 형식으로 다시 내보내세요.

  • 아카이브에 classes.txt 또는 notes.json이 없습니다. 일반적으로 images/ 및 labels/ 폴더만으로 아카이브를 다시 만들었기 때문입니다. 두 파일이 모두 포함되는 Label Studio 내보내기 ZIP을 업로드하세요.

  • 네. exportType=YOLO_WITH_IMAGES을 사용하거나 COCO_WITH_IMAGES과 YOLO_OBB_WITH_IMAGES를 사용해 내보내기 엔드포인트를 호출하세요. 대규모 프로젝트에는 내보내기를 백그라운드 작업으로 생성하는 스냅샷 엔드포인트를 사용하는 것이 좋습니다.

기여자
GLglenn-jocher4RAraimbekovm3SEsergiuwaxmann1

댓글