Roboflow#
Roboflow는 데이터 라벨링과 YOLO를 포함한 다양한 형식으로의 데이터셋 내보내기 도구를 제공합니다. 이 가이드에서는 Ultralytics YOLO 모델을 위한 데이터 라벨링, 내보내기, 배포를 다룹니다.
Ultralytics는 다양한 사용 사례에 맞춰 두 가지 라이선스 옵션을 제공합니다.
- AGPL-3.0 라이선스: 이 OSI 승인 오픈 소스 라이선스는 학생과 애호가에게 적합하며, 개방적인 협업과 지식 공유를 장려합니다. 자세한 내용은 LICENSE 파일을 참조하세요.
- 엔터프라이즈 라이선스: 개발 및 프로덕션 용도를 위한 이 라이선스를 사용하면 내부 도구, 자동화 워크플로, 프로덕션 배포를 비롯한 비즈니스 제품과 서비스에 Ultralytics 소프트웨어 및 AI 모델을 원활하게 통합하면서 AGPL-3.0의 오픈 소스 요구 사항을 따르지 않을 수 있습니다. 시작하려면 Ultralytics Licensing을 통해 문의해 주세요.
자세한 내용은 Ultralytics 라이선스 페이지를 참조하세요.
이 가이드에서는 Roboflow를 사용해 사용자 지정 Ultralytics YOLO26 모델을 학습하기 위한 데이터를 찾고, 라벨링하고, 구성하는 방법을 설명합니다.
사용자 지정 YOLO26 모델 학습을 위한 데이터 수집#
Roboflow는 Ultralytics YOLO 모델의 데이터 수집을 지원하기 위해 Universe와 Collect라는 두 가지 주요 서비스를 제공합니다. 일반적인 데이터 수집 전략은 데이터 수집 및 어노테이션 가이드를 참조하세요.
Roboflow Universe#
Roboflow Universe는 비전 데이터셋을 제공하는 온라인 저장소입니다. Ultralytics 모델에서 사용할 수 있도록 데이터셋을 YOLO 형식으로 내보낼 수 있습니다.
Roboflow Collect#
직접 이미지를 수집하려는 경우 Roboflow Collect를 사용하면 엣지 디바이스의 웹캠을 통해 이미지를 자동으로 수집할 수 있습니다. 이 오픈 소스 프로젝트에서는 텍스트 또는 이미지 프롬프트로 수집할 데이터를 지정하여 비전 모델에 필요한 이미지만 캡처할 수 있습니다.
YOLO26 형식으로 데이터 업로드, 변환 및 라벨링#
Roboflow Annotate는 객체 탐지, 분류, 세그멘테이션을 비롯한 다양한 컴퓨터 비전 작업을 위해 이미지를 라벨링하는 온라인 도구입니다.
Ultralytics YOLO 모델의 데이터를 라벨링하려면 Roboflow에서 프로젝트를 생성하고 이미지를 업로드한 다음 어노테이션을 시작하세요.
어노테이션 도구#
- 바운딩 박스 어노테이션:
B을 누르거나 상자 아이콘을 클릭하세요. 클릭한 뒤 드래그하여 바운딩 박스를 생성하세요. 팝업에서 어노테이션에 사용할 클래스를 선택하라는 메시지가 표시됩니다. - 폴리곤 어노테이션: 인스턴스 세그멘테이션에 사용됩니다.
P을 누르거나 폴리곤 아이콘을 클릭하세요. 객체 주변의 점을 클릭하여 폴리곤을 그립니다.
라벨 어시스턴트(SAM 통합)#
Roboflow는 어노테이션 속도를 높일 수 있도록 Segment Anything Model (SAM) 기반 라벨 어시스턴트를 통합합니다.
라벨 어시스턴트를 사용하려면 사이드바에서 커서 아이콘을 클릭하세요. 프로젝트에서 SAM이 활성화됩니다.
객체 위에 마우스를 올리면 SAM이 어노테이션을 제안할 수 있습니다. 제안을 적용하려면 클릭하세요. 제안된 영역 안쪽이나 바깥쪽을 클릭하여 어노테이션의 세부 수준을 조정할 수 있습니다.
태그 지정#
사이드바의 Tags 패널을 사용해 이미지에 태그를 추가할 수 있습니다. 태그는 위치나 카메라 소스 등의 속성을 나타낼 수 있습니다. 태그를 사용하면 특정 이미지를 검색하고, 특정 태그가 있는 이미지가 포함된 데이터셋 버전을 생성할 수 있습니다.
라벨 지원(모델 기반)#
Roboflow에서 호스팅하는 모델을 Label Assist와 함께 사용하여 어노테이션을 제안할 수 있습니다. YOLO 모델 가중치를 Roboflow에 업로드한 다음(아래 안내 참조), 사이드바의 마술봉 아이콘을 통해 Label Assist를 활성화하세요.
YOLO26 데이터셋 관리#
Roboflow는 컴퓨터 비전 데이터셋을 이해하고 관리하는 데 필요한 여러 도구를 제공합니다.
데이터셋 검색#
데이터셋 검색을 사용하면 텍스트 설명이나 특정 라벨 및 태그를 기준으로 이미지를 찾을 수 있습니다. 사이드바에서 "Dataset"을 클릭하여 이 기능에 액세스하세요.
상태 검사#
학습 전에 Roboflow Health Check를 사용해 데이터셋을 파악하고 개선 가능성을 확인하세요. 사이드바의 "Health Check" 링크에서 액세스할 수 있습니다. 이 기능은 이미지 크기, 클래스 균형, 어노테이션 히트맵 등에 관한 통계를 제공합니다.
Health Check는 클래스 균형 기능에서 확인된 클래스 불균형을 해결하는 등 성능 향상을 위한 변경 사항을 제안할 수 있습니다. 데이터셋 상태를 이해하는 것은 효과적인 모델 학습에 매우 중요합니다.
모델 견고성을 위한 데이터 전처리 및 증강#
데이터를 내보내려면 특정 시점의 데이터셋 스냅샷인 데이터셋 버전을 생성해야 합니다. 사이드바에서 "Versions"를 클릭한 다음 "Create New Version"을 클릭하세요. 여기서 전처리 단계를 적용하고 데이터 증강을 수행하여 모델의 견고성을 높일 수 있습니다.
선택한 각 증강 기법의 팝업에서 밝기와 같은 파라미터를 세밀하게 조정할 수 있습니다. 적절한 증강은 모델 일반화 성능을 크게 향상시킬 수 있으며, 이는 모델 학습 팁 가이드에서 다루는 핵심 개념입니다.
모델 학습을 위한 40개 이상의 형식으로 데이터 내보내기#
데이터셋 버전이 생성되면 모델 학습에 적합한 다양한 형식으로 내보낼 수 있습니다. 버전 페이지에서 "Export Dataset" 버튼을 클릭하세요.
Ultralytics 학습 파이프라인과 호환되도록 "YOLO26" 형식을 선택하세요. 이제 사용자 지정 YOLO26 모델을 학습할 준비가 되었습니다. 내보낸 데이터셋으로 학습을 시작하는 자세한 방법은 Ultralytics Train 모드 문서를 참조하세요.
테스트 및 배포를 위한 사용자 지정 YOLO26 모델 가중치 업로드#
Roboflow는 NVIDIA Jetson, Luxonis OAK, Raspberry Pi와 같은 디바이스 및 GPU 기반 시스템과 호환되는 SDK와 배포 모델용 확장 가능한 API를 제공합니다. 가이드에서 다양한 모델 배포 옵션을 확인하세요.
간단한 Python 스크립트를 사용해 YOLO26 모델의 가중치를 Roboflow에 업로드하여 배포할 수 있습니다.
새 Python 파일을 만들고 다음 코드를 추가하세요.
import roboflow # install with 'pip install roboflow'
# Log in to Roboflow (requires API key)
roboflow.login()
# Initialize Roboflow client
rf = roboflow.Roboflow()
# Define your workspace and project details
WORKSPACE_ID = "your-workspace-id" # Replace with your actual Workspace ID
PROJECT_ID = "your-project-id" # Replace with your actual Project ID
VERSION = 1 # Replace with your desired dataset version number
MODEL_PATH = "path/to/your/runs/detect/train/" # Replace with the path to your YOLO26 training results directory
# Get project and version
project = rf.workspace(WORKSPACE_ID).project(PROJECT_ID)
dataset = project.version(VERSION)
# Upload model weights for deployment
# Ensure MODEL_PATH points to the directory containing 'best.pt'
dataset.deploy(
model_type="yolov8",
model_path=MODEL_PATH,
) # Note: Use "yolov8" as model_type for YOLO26 compatibility in Roboflow deployment
print(f"Model from {MODEL_PATH} uploaded to Roboflow project {PROJECT_ID}, version {VERSION}.")
print("Deployment may take up to 30 minutes.")이 코드에서 your-workspace-id, your-project-id, VERSION 번호, MODEL_PATH을 Roboflow 계정, 프로젝트, 로컬 학습 결과 디렉터리에 해당하는 값으로 바꾸세요. MODEL_PATH가 학습된 best.pt 가중치 파일이 포함된 디렉터리를 올바르게 가리키는지 확인하세요.
위 코드를 실행하면 인증을 요청하는 메시지가 표시됩니다(일반적으로 API 키 사용). 그러면 모델이 업로드되고 프로젝트의 API 엔드포인트가 생성됩니다. 이 프로세스가 완료되는 데 최대 30분이 걸릴 수 있습니다.
모델을 테스트하고 지원되는 SDK의 배포 안내를 확인하려면 Roboflow 사이드바에서 "Deploy" 탭으로 이동하세요. 이 페이지 상단에 위젯이 표시되며, 이를 사용해 웹캠으로 모델을 테스트하거나 이미지 또는 동영상을 업로드할 수 있습니다.
업로드한 모델은 학습 내용을 바탕으로 새 이미지의 어노테이션을 제안하는 라벨 어시스턴트로도 사용할 수 있습니다.
YOLO26 모델 평가 방법#
Roboflow는 모델 성능을 평가하는 기능을 제공합니다. 성능 지표를 이해하는 것은 모델을 반복적으로 개선하는 데 매우 중요합니다.
모델을 업로드한 후 Roboflow 대시보드의 모델 페이지에서 모델 평가 도구에 액세스하세요. "View Detailed Evaluation"을 클릭하세요.
이 도구는 모델 성능을 보여주는 혼동 행렬과 CLIP 임베딩을 사용한 대화형 벡터 분석 플롯을 표시합니다. 이 기능을 활용하면 모델을 개선할 영역을 파악할 수 있습니다.
혼동 행렬 팝업:
셀 위에 마우스를 올리면 값을 확인할 수 있으며, 셀을 클릭하면 모델 예측 및 정답 데이터가 포함된 해당 이미지를 볼 수 있습니다.
이미지 유사도를 CLIP 임베딩 기반으로 시각화한 산점도를 보려면 "Vector Analysis"를 클릭하세요. 서로 가까운 이미지는 의미적으로 유사합니다. 점은 이미지를 나타내며 흰색(성능 양호)에서 빨간색(성능 저조)까지 색상으로 표시됩니다.
벡터 분석을 사용하면 다음을 수행할 수 있습니다.
- 이미지 클러스터를 식별합니다.
- 모델 성능이 낮은 클러스터를 찾아냅니다.
- 성능 저하를 일으키는 이미지의 공통점을 파악합니다.
학습 자료#
- 사용자 지정 데이터셋으로 YOLO 학습하기(Colab): 자체 데이터로 학습할 수 있는 대화형 Google Colab 노트북입니다.
- Ultralytics YOLO 문서: YOLO 모델 학습, 내보내기 및 배포에 관한 문서입니다.
- Ultralytics 블로그: 컴퓨터 비전 및 모델 학습 관련 글입니다.
- Ultralytics YouTube: 모델 학습 및 배포에 관한 동영상 가이드입니다.
자주 묻는 질문#
Roboflow Annotate를 사용하세요. 프로젝트를 생성하고 이미지를 업로드한 다음 어노테이션 도구(
B은 바운딩 박스,P는 폴리곤)를 사용하거나 SAM 기반 라벨 어시스턴트를 사용해 라벨링 속도를 높이세요. 자세한 단계는 데이터 업로드, 변환 및 라벨링 섹션에서 확인할 수 있습니다.Roboflow는 Universe(다양한 데이터셋 이용)와 Collect(웹캠을 통한 자동 이미지 수집)를 제공합니다. 이 서비스는 데이터 수집 가이드에 설명된 전략을 보완하여 YOLO26 모델에 필요한 학습 데이터를 확보하는 데 도움이 됩니다.
Roboflow의 데이터셋 검색, 태그 지정, Health Check 기능을 활용하세요. 검색 기능은 텍스트 또는 태그로 이미지를 찾고, Health Check는 클래스 균형과 이미지 크기 등을 분석하여 학습 전 개선 방향을 제시합니다. 자세한 내용은 데이터셋 관리 섹션을 참조하세요.
Roboflow에서 데이터셋 버전을 생성하고 원하는 전처리 및 증강을 적용한 다음 "Export Dataset"을 클릭하고 YOLO26 형식을 선택하세요. 이 과정은 데이터 내보내기 섹션에 설명되어 있습니다. 이렇게 하면 Ultralytics 학습 파이프라인에서 사용할 데이터를 준비할 수 있습니다.
제공된 Python 스크립트를 사용해 학습한 YOLO26 가중치를 Roboflow에 업로드하세요. 그러면 배포 가능한 API 엔드포인트가 생성됩니다. 스크립트와 안내는 사용자 지정 가중치 업로드 섹션을 참조하세요. 문서에서 추가 배포 옵션도 확인할 수 있습니다.