주석 편집기
Ultralytics Platform에는 바운딩 박스, 다각형, 키포인트, 지향성 박스 및 분류를 사용하여 이미지에 레이블을 지정하는 강력한 주석 편집기가 포함되어 있습니다. 이 편집기는 수동 주석, SAM 기반 스마트 주석 및 YOLO 자동 레이블링을 지원합니다.
graph TB
subgraph Manual["✏️ Manual Tools"]
A[Box] & B[Polygon] & C[Keypoint] & D[OBB] & E[Classify]
end
subgraph AI["🤖 AI-Assisted"]
F[SAM Smart] & G[Auto-Annotate]
end
Manual --> H[📁 Save Labels]
AI --> H지원되는 작업 유형
주석 편집기는 5가지 YOLO 작업 유형을 모두 지원합니다:
| 작업 | 도구 | 주석 형식 |
|---|---|---|
| Detect | 사각형 | 바운딩 박스 (x, y, 너비, 높이) |
| Segment | 다각형 | 픽셀 단위 마스크 (다각형 꼭짓점) |
| 포즈 | 키포인트 | 17개 지점 COCO 스켈레톤 |
| OBB | 지향성 박스 | 회전된 바운딩 박스 (4개 모서리) |
| Classify | 클래스 선택기 | 이미지 수준 레이블 |
작업 세부사항
객체 감지
기능: 물체와 그 위치를 축 정렬 바운딩 박스로 식별합니다.
라벨 형식: class_id center_x center_y width height (모두 0-1로 정규화됨)
예시: 0 0.5 0.5 0.2 0.3 — (50%, 50%)에 중심을 둔 Class 0, 너비 20%, 높이 30%
사용 사례: 재고 계수, 교통 모니터링, 야생동물 감지, 보안 시스템
인스턴스 분할
기능: 각 객체 인스턴스에 대해 픽셀 단위의 정밀한 마스크를 생성합니다.
라벨 형식: class_id x1 y1 x2 y2 x3 y3 ... (다각형 꼭짓점, 정규화 0-1)
예시: 0 0.1 0.1 0.9 0.1 0.9 0.9 0.1 0.9 — 사각형 마스크
사용 사례: 의료 영상, 자율주행 차량, 사진 편집, 농업 분석
포즈 추정
기능: 스켈레톤 추적을 위한 신체 주요 지점(keypoint)을 감지합니다.
라벨 형식: class_id cx cy w h kx1 ky1 v1 kx2 ky2 v2 ...
- 가시성 플래그:
0=라벨이 붙어 있지 않음,1표시되었으나 가려진,2표시되고 가시적인
예시: 0 0.5 0.5 0.2 0.3 0.6 0.7 2 0.4 0.8 1 — 2개의 키포인트를 가진 사람
사용 사례: 스포츠 분석, 물리 치료, 애니메이션, 제스처 인식
OBB(오리엔티드 바운딩 박스)
기능: 각도를 인식하는 바운딩 박스로 회전된 물체를 감지합니다.
라벨 형식: class_id x1 y1 x2 y2 x3 y3 x4 y4 (네 모서리 점, 정규화됨)
예시: 0 0.1 0.1 0.9 0.1 0.9 0.9 0.1 0.9 — 회전된 직사각형
사용 사례: 항공 촬영 이미지, 문서 분석, 제조 검사, 선박 탐지
이미지 분류
기능: 이미지 전체에 단일 레이블을 할당합니다.
라벨 형식: 폴더 기반 — 클래스 이름별로 정리된 이미지 (train/cats/, train/dogs/)
사용 사례: 콘텐츠 검토, 품질 관리, 의료 진단, 장면 인식
시작하기
이미지에 주석을 달려면:
- 데이터셋으로 이동
- 이미지를 클릭하여 전체 화면 뷰어 열기
- 주석 모드로 들어가려면 편집을 클릭하세요
- 주석 도구 선택
- 이미지에 주석 그리기
- 완료되면 저장을 클릭하십시오.
수동 주석 도구
바운딩 박스 (Detect)
객체 주위에 직사각형 상자 그리기:
- 선택 박스 도구 또는 누르기
B - 클릭하고 드래그하여 직사각형 그리기
- 놓아서 상자 완성
- 드롭다운에서 클래스 선택
크기 조정 및 이동
- 모서리나 가장자리를 드래그하여 크기 조정
- 중앙을 드래그하여 이동
- 누르기
Delete선택한 주석 제거
폴리곤 (Segment)
정확한 다각형 마스크 그리기:
- 선택 다각형 도구 또는 누르기
P - 클릭하여 정점 추가
- 두 번 클릭하거나 누르기
Enter다각형 닫기 - 드롭다운에서 클래스 선택
정점 편집
- 개별 정점을 드래그하여 조정
- 전체 다각형을 드래그하여 이동
- 정점을 클릭하고 누르기
Delete제거
키포인트 (Pose)
인체 자세를 위한 17개의 COCO 키포인트 배치:
- 선택 키포인트 도구 또는 누르기
K - 클릭하여 키포인트를 순서대로 배치
- COCO 스켈레톤 순서를 따르세요
17개의 COCO 키포인트는 다음과 같습니다:
| # | 키포인트 | # | 키포인트 |
|---|---|---|---|
| 1 | 코 | 10 | 오른쪽 손목 |
| 2 | 왼쪽 눈 | 11 | 왼쪽 엉덩이 |
| 3 | 오른쪽 눈 | 12 | 오른쪽 엉덩이 |
| 4 | 왼쪽 귀 | 13 | 왼쪽 무릎 |
| 5 | 오른쪽 귀 | 14 | 오른쪽 무릎 |
| 6 | 왼쪽 어깨 | 15 | 왼쪽 발목 |
| 7 | 오른쪽 어깨 | 16 | 오른쪽 발목 |
| 8 | 왼쪽 팔꿈치 | 17 | (예약됨) |
| 9 | 오른쪽 팔꿈치 |
OBB(오리엔티드 바운딩 박스)
각진 객체에 대해 회전된 박스 그리기:
- 선택 OBB 도구 또는 누르기
O - 클릭하여 드래그하여 초기 박스를 그리세요
- 회전 핸들을 사용하여 각도를 조정하세요
- 드롭다운에서 클래스 선택
분류 (Classify)
이미지 수준 클래스 레이블 할당:
- Classify 모드를 선택하세요
- 클래스 버튼을 클릭하거나 숫자 키를 누르세요
1-9 - 이미지당 여러 클래스를 할당할 수 있습니다
SAM 스마트 주석
Segment Anything Model (SAM)은 몇 번의 클릭만으로 지능형 주석을 가능하게 합니다:
- 선택 SAM 모드 또는 누르기
S - 왼쪽 클릭으로 긍정적인 포인트 추가 (이 영역 포함)
- 오른쪽 클릭으로 부정적인 포인트 추가 (이 영역 제외)
- SAM은 실시간으로 정밀한 마스크를 생성합니다.
- 수락을 클릭하여 주석으로 변환합니다.
SAM 팁
- 객체 중앙에 긍정적인 클릭으로 시작합니다.
- 배경을 제외하려면 부정적인 클릭을 추가합니다.
- 명확한 경계를 가진 개별 객체에 가장 잘 작동합니다.
SAM 스마트 주석은 다음을 생성할 수 있습니다:
- 다각형 (segmentation 작업용)
- 바운딩 박스 (detection 작업용)
- 지향성 박스 (obb 작업용)
YOLO 자동 주석
학습된 YOLO 모델을 사용하여 이미지를 자동으로 레이블링합니다:
- 선택 자동 주석 모드 또는 누르기
A - 모델 선택 (공식 모델 또는 학습된 모델)
- 신뢰도 임계값 설정
- 실행을 클릭하여 예측을 생성합니다.
- 필요에 따라 결과를 검토하고 편집합니다.
자동 주석 모델
다음 모델을 사용할 수 있습니다:
- 공식 Ultralytics (YOLO26n, YOLO26s 등)
- 플랫폼에서 학습된 사용자 고유 모델
클래스 관리
클래스 생성
데이터셋의 어노테이션 클래스 정의:
- 클래스 패널에서 클래스 추가를 클릭합니다.
- 클래스 이름을 입력합니다.
- 색상이 자동으로 할당됩니다.
주석 처리 중 새 클래스 추가
편집기를 떠나지 않고 주석을 달면서 직접 새 클래스를 생성할 수 있습니다:
- 이미지에 주석을 그리기
- 클래스 드롭다운에서 새 클래스 추가를 클릭하세요
- 클래스 이름을 입력합니다.
- Enter 키를 눌러 생성 및 할당
이를 통해 데이터에서 새로운 객체 유형을 접할 때마다 클래스를 정의할 수 있는 원활한 워크플로우가 가능해집니다.
통합 수업표
데이터셋 전체의 모든 클래스는 통합된 테이블에서 관리됩니다. 클래스 이름이나 색상 변경은 데이터셋 전체에 자동으로 적용됩니다.
클래스 편집
- 새 어노테이션을 위해 클래스를 선택하려면 해당 클래스를 클릭합니다.
- 이름을 변경하려면 두 번 클릭합니다.
- 순서를 변경하려면 드래그합니다.
- 더 많은 옵션을 보려면 마우스 오른쪽 버튼을 클릭합니다.
클래스 색상
각 클래스에는 Ultralytics 팔레트에서 색상이 할당됩니다. 색상은 플랫폼 전체에서 일관되게 유지되어 쉽게 인식할 수 있습니다.
키보드 단축키
키보드 단축키를 사용한 효율적인 어노테이션:
| 단축키 | 작업 |
|---|---|
B | 박스 도구 (detect) |
P | 폴리곤 도구 (segment) |
K | 키포인트 도구 (pose) |
O | obb 도구 |
S | SAM 스마트 어노테이션 |
A | 자동 어노테이션 |
V | 선택/이동 모드 |
1-9 | 클래스 1-9 선택 |
Delete | 선택된 어노테이션 삭제 |
Ctrl+Z | 실행 취소 |
Ctrl+Y | 다시 실행 |
Escape | 현재 작업 취소 |
Enter | 폴리곤 완료 |
←/→ | 이전/다음 이미지 |
모든 단축키 보기
누르기 ? 키보드 단축키 대화 상자를 열려면.
실행 취소/다시 실행
주석 편집기는 전체 기록을 유지합니다:
- 실행 취소:
Ctrl+Z(Mac에서 Cmd+Z) - 다시 실행:
Ctrl+Y(Mac에서 Cmd+Y)
기록에는 다음이 포함됩니다:
- 주석 추가
- 주석 편집
- 주석 삭제
- 클래스 변경
주석 저장
주석은 저장을 클릭하거나 다른 페이지로 이동할 때 저장됩니다:
- 저장: 저장 버튼을 클릭하거나 누르세요
Ctrl+S - 취소: 변경 사항을 버리려면 취소를 클릭하세요
- 자동 저장 경고: 저장되지 않은 변경 사항이 있을 경우 나가기 전에 메시지가 표시됩니다
작업 저장
다른 이미지로 이동하기 전에 항상 저장하세요. 저장되지 않은 변경 사항은 손실됩니다.
FAQ
SAM 주석은 얼마나 정확한가요?
SAM은 대부분의 객체에 대해 고품질 마스크를 제공합니다. 정확도는 다음 요소에 따라 달라집니다:
- 배경으로부터 객체의 구별 정도
- 이미지 품질 및 해상도
- 제공된 긍정/부정 포인트 수
최상의 결과를 얻으려면 객체 중앙에 긍정 포인트를 찍고, 근처 객체를 제외하기 위해 부정 포인트를 추가하세요.
기존 주석을 가져올 수 있나요?
네, YOLO 형식 레이블 파일과 함께 데이터셋을 업로드하세요. 플랫폼이 자동으로 이를 구문 분석하여 편집기에 표시합니다.
동일한 클래스의 여러 객체에 주석을 다는 방법은 무엇인가요?
주석을 그린 후:
- 동일한 클래스를 선택된 상태로 유지
- 다음 주석 그리기
- 모든 객체가 레이블링될 때까지 반복합니다.
키보드 단축키 1-9 클래스를 빠르게 선택합니다.
SAM과 자동 주석의 차이점은 무엇인가요?
| 기능 | SAM | 자동 주석 |
|---|---|---|
| 메서드 | 대화형 포인트 프롬프트 | 모델 추론 |
| 속도 | 한 번에 하나의 객체 | 한 번에 모든 객체 |
| 정밀도 | 안내에 따라 매우 높음 | 모델에 따라 다름 |
| 가장 적합한 용도 | 복잡한 객체, 미세한 세부 사항 | 대량 레이블링, 간단한 객체 |
부분적으로 주석이 달린 데이터셋으로 훈련할 수 있나요?
네, 하지만 최상의 결과를 위해:
- 각 이미지에서 대상 클래스의 모든 객체에 레이블을 지정합니다.
- 레이블이 지정되지 않은 이미지에는 unknown 분할을 사용합니다.
- 훈련 구성에서 레이블이 지정되지 않은 이미지를 제외합니다.
