Ultralytics YOLO27:
Get Started

CVAT 통합#

CVAT에서 Ultralytics Platform으로 직접 가져오는 기능이 제공될 예정입니다. 이 기능을 사용하면 CVAT 이미지 객체 감지 또는 세그멘테이션 내보내기 파일을 형식을 선택하지 않고 그대로 업로드할 수 있습니다.

그동안은 CVAT에서 Platform이 읽는 Ultralytics YOLO 레이아웃으로 이미 내보낼 수 있으므로, 지금 바로 사용할 수 있는 간단한 방법이 있습니다.

지금 CVAT에서 가져오기#

  1. CVAT에서 내보내기. 작업을 열고 Actions > Export task dataset을 선택하세요(작업에서 내보내는 경우 Menu > Export job dataset을 선택합니다).
  2. 형식 선택. 작업에 맞는 Ultralytics YOLO 항목을 선택하세요. CVAT에는 Ultralytics YOLO Detection 1.0, Ultralytics YOLO Detection Track 1.0, Ultralytics YOLO Segmentation 1.0, Ultralytics YOLO Oriented Bounding Boxes 1.0, Ultralytics YOLO Pose 1.0, Ultralytics YOLO Classification 1.0이 각각 별도로 표시됩니다.
  3. Save images를 켜고 .zip의 이름을 지정한 다음 OK를 클릭하세요. CVAT Online에서 Save images는 유료 기능입니다. 이 기능을 사용하지 않으면 아카이브에 레이블만 포함되므로, 업로드 전에 labels/를 미러링하는 images/ 폴더에 이미지를 추가하세요.
  4. 아카이브 다운로드. 내보내기는 백그라운드에서 진행됩니다. 완료되면 CVAT의 Requests 페이지에서 다운로드하세요.
  5. Platform에 업로드. ZIP에서 새 데이터셋을 생성하세요.
  6. 학습. 작업 공간을 벗어나지 않고 어노테이션을 편집하고, 학습한 다음, 배포하세요.

Ultralytics Platform CVAT 데이터셋 가져오기

CLI로 내보내기#

CVAT의 CLI를 사용하면 터미널에서 동일한 아카이브를 내보낼 수 있습니다.

pip install cvat-cli
cvat-cli project export-dataset --format "Ultralytics YOLO Detection 1.0" --with-images yes 104 dataset.zip

104을 프로젝트 ID로, 형식 문자열을 작업에 맞는 변형으로 바꾸세요. --with-images yes은 Save images 스위치와 동일한 CLI 옵션입니다. 이 옵션을 사용하지 않으면 아카이브에 레이블만 포함되므로, 업로드 전에 labels/을 미러링하는 images/ 폴더를 추가하세요.

CVAT의 Ultralytics YOLO 내보내기에서는 Platform이 기대하는 레이아웃을 생성하므로 변환할 필요가 없습니다.

archive.zip/
├── data.yaml          # class names Platform reads
├── images/train/
└── labels/train/

각 내보내기에 포함되는 항목#

각 Ultralytics YOLO 형식은 해당 작업에서 지원하는 CVAT 도형만 기록하므로, 레이블링 방식에 맞는 형식을 선택하세요.

  • 객체 감지는 사각형을 유지하지만 회전된 사각형은 건너뜁니다. 회전된 사각형은 방향 지정 바운딩 박스 형식으로 내보내세요.
  • 객체 감지 추적은 사각형과 추적 ID를 유지합니다. Platform은 사각형을 박스로 가져오고 추적 ID는 무시합니다.
  • 세그멘테이션은 다각형과 마스크를 유지하고 마스크를 다각형으로 변환하지만, 사각형은 제외합니다.
  • 포즈는 스켈레톤만 유지하며 독립형 점은 내보내지 않습니다.
  • 분류는 태그를 유지하며, 태그가 없는 이미지는 no_label 클래스에 포함됩니다.

폴리라인은 어떤 형식에서도 기록되지 않습니다.

내보내기 형식 선택#

CVAT는 다양한 내보내기 형식을 제공합니다. 여기서 중요한 형식은 다음과 같습니다.

CVAT 형식지원 여부참고
Ultralytics YOLO최적data.yaml을 포함하므로 레이블 이름이 그대로 유지됩니다.
COCO 1.0예읽을 수 있음. 다각형과 박스가 섞인 경우 세그멘테이션으로 가져오며, 박스만 있는 항목은 제외됩니다.
COCO Keypoints 1.0예포즈 데이터셋으로 가져오며, 키포인트 개수는 가장 흔한 도형을 기준으로 설정됩니다.
YOLO 1.1일부 지원박스는 가져오지만 obj.names 파일은 읽지 않습니다. 클래스는 class0, class1, …로 지정됩니다.
이미지용 CVAT아니요XML 어노테이션은 아직 읽지 않습니다. 동영상용 CVAT에도 동일하게 적용됩니다.

COCO 어노테이션은 모두 읽을 수 있도록 bbox을 포함해야 하며, 군중 영역("iscrowd": 1)은 건너뜁니다. CVAT는 마스크를 COCO의 군중 영역으로 기록하므로, 마스크는 Ultralytics YOLO Segmentation으로 내보내세요. 카테고리 이름은 클래스 이름이 되며, 아카이브 내 모든 JSON 파일에서 카테고리 ID가 통합되므로 분할별 내보내기에서도 클래스 ID가 일관되게 유지됩니다. 여러 다각형으로 저장된 객체는 하나의 다각형으로 결합됩니다.

CVAT XML 및 Pascal VOC 가져오기 시 어노테이션이 포함되지 않음

Platform은 이미지용 CVAT, 동영상용 CVAT 또는 Pascal VOC XML 레이블을 읽지 않습니다. 이러한 내보내기 파일은 오류를 크게 알리지 않고 조용히 실패합니다. 이미지는 가져오지만 어노테이션은 가져오지 않으며, 이미지가 5개 이상인 내보내기에서는 이미지 폴더 이름을 딴 클래스도 추가됩니다. 대신 Ultralytics YOLO 또는 COCO를 선택하세요.

통합으로 추가될 기능#

통합 기능이 제거하는 단계는 올바른 내보내기 형식을 선택하는 것입니다. 기능이 출시되면 CVAT의 이미지 객체 감지 및 세그멘테이션 형식 중 하나를 내보내 업로드하기만 하면 Platform이 어노테이션을 해당 YOLO 작업에 자동으로 매핑합니다.

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

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

자주 묻는 질문#

  • 작업에 맞는 Ultralytics YOLO 항목을 선택하고 이미지 저장을 켜세요. 해당 형식에는 data.yaml이 포함되어 있어 클래스 이름이 그대로 유지됩니다. COCO 1.0과 COCO Keypoints 1.0도 가져올 수 있지만, YOLO 1.1은 클래스 이름을 유지하지 않으며 CVAT XML과 Pascal VOC는 어노테이션 없이 가져옵니다.

  • 이미지 저장 스위치가 꺼져 있었거나, CLI 내보내기를 --with-images yes 없이 실행했기 때문입니다. 그러면 아카이브에 레이블만 들어갑니다. 이미지를 포함해 다시 내보내거나, 이미지 저장 기능이 없는 CVAT Online 요금제를 사용 중이라면 labels/와 동일한 구조의 images/ 폴더를 ZIP에 추가하세요.

  • 네. Ultralytics YOLO Segmentation 1.0 또는 Ultralytics YOLO Pose 1.0이나 COCO 변형 형식을 사용하세요. 마스크를 가져오려면 마스크를 폴리곤으로 변환하는 Ultralytics YOLO Segmentation 내보내기 형식이 필요하며, 포즈를 가져오려면 CVAT 스켈레톤이 필요합니다. 폴리곤과 박스가 혼합된 COCO 내보내기는 세그먼트 데이터셋으로 가져오며, 박스만 있는 어노테이션은 제외됩니다.

  • 모든 CVAT 이미지 감지 또는 세그멘테이션 내보내기 파일을 변환 없이 업로드하면 Platform이 해당 파일을 적절한 YOLO 작업에 자동으로 매핑합니다. 현재 Ultralytics YOLO 내보내기 형식으로 가져온 데이터셋은 변경 없이 계속 사용할 수 있습니다.

댓글