주석 편집기
Ultralytics 바운딩 박스, 다각형, 키포인트, 방향성 박스 및 분류를 통해 이미지를 라벨링할 수 있는 강력한 주석 편집기를 포함합니다. 이 편집기는 수동 그리기 및 SAM 스마트 주석을 지원합니다.

graph TB
subgraph Manual["Manual Tools"]
A[Box] & B[Polygon] & C[Keypoint] & D[OBB] & E[Classify]
end
subgraph AI["AI-Assisted"]
F[SAM Smart]
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/)
사용 사례: 콘텐츠 검토, 품질 관리, 의료 진단, 장면 인식
시작하기
이미지에 주석을 달려면:
- 데이터셋으로 이동
- 이미지를 클릭하여 전체 화면 뷰어 열기
- 클릭
Edit주석 모드로 진입하기 - 도구 모음에서 주석 도구를 선택하세요
- 이미지에 주석 그리기
- 클릭
Save완료 시

graph LR
A[Open Dataset] --> B[Click Image]
B --> C[Click Edit]
C --> D[Draw Annotations]
D --> E[Save]
E --> F[Next Image]
F --> B
style C fill:#2196F3,color:#fff
style D fill:#FF9800,color:#fff
style E fill:#4CAF50,color:#fff
주석 모드
편집기는 도구 모음에서 선택할 수 있는 두 가지 주석 모드를 제공합니다:
| 모드 | 설명 | 단축키 |
|---|---|---|
| 그리다 | 작업별 도구로 수행하는 수동 주석 작업 | V |
| 스마트 | SAM 대화형 주석(segment) | S |
수동 주석 도구
바운딩 박스 (Detect)
객체 주위에 직사각형 상자 그리기:
- 편집 모드로 들어가서 선택하세요
Draw - 클릭하고 드래그하여 직사각형 그리기
- 놓아서 상자 완성
- 드롭다운에서 클래스 선택

크기 조정 및 이동
- 8개의 모서리/가장자리 핸들을 드래그하여 크기를 조정하세요
- 중앙을 드래그하여 이동
- 누르기
Delete또는Backspace선택한 주석 제거
폴리곤 (Segment)
정확한 다각형 마스크 그리기:
- 편집 모드로 들어가서 선택하세요
Draw - 클릭하여 정점 추가
- 마우스 오른쪽 버튼을 클릭하거나
Enter다각형 닫기 - 드롭다운에서 클래스 선택

정점 편집
- 개별 정점을 드래그하여 조정
- 전체 다각형을 드래그하여 이동
- 정점을 클릭하고 누르기
Delete제거
키포인트 (Pose)
인간 자세를 위한 17개의 COCO 위치:
- 편집 모드로 들어가서 선택하세요
Draw - 클릭하여 키포인트를 순서대로 배치
- COCO 순서를 따르세요
17개의 COCO 키포인트는 다음과 같습니다:
| # | 키포인트 | # | 키포인트 |
|---|---|---|---|
| 1 | 코 | 10 | 왼쪽 손목 |
| 2 | 왼쪽 눈 | 11 | 오른쪽 손목 |
| 3 | 오른쪽 눈 | 12 | 왼쪽 엉덩이 |
| 4 | 왼쪽 귀 | 13 | 오른쪽 엉덩이 |
| 5 | 오른쪽 귀 | 14 | 왼쪽 무릎 |
| 6 | 왼쪽 어깨 | 15 | 오른쪽 무릎 |
| 7 | 오른쪽 어깨 | 16 | 왼쪽 발목 |
| 8 | 왼쪽 팔꿈치 | 17 | 오른쪽 발목 |
| 9 | 오른쪽 팔꿈치 |

키포인트 가시성
각 키포인트에는 가시성 플래그가 있습니다: 0 = 라벨이 붙어 있지 않음, 1 라벨링되었으나 가려짐 2 표시되고 가시적인 상태여야 합니다. 가려진 키포인트(다른 객체 뒤에 위치)는 가시성 표시로 표시해야 합니다. 1 — 모델은 자신의 위치를 추론하는 법을 배운다.
OBB(오리엔티드 바운딩 박스)
각진 객체에 대해 회전된 박스 그리기:
- 편집 모드로 들어가서 선택하세요
Draw - 클릭하여 드래그하여 초기 박스를 그리세요
- 회전 핸들을 사용하여 각도를 조정하세요
- 모서리 핸들을 드래그하여 크기를 조정하세요
- 드롭다운에서 클래스 선택

분류 (Classify)
이미지 수준 클래스 레이블 할당:
- 편집 모드로 진입
- 클래스 선택 버튼이 있는 사이드 패널이 나타납니다
- 클래스 버튼을 클릭하거나 숫자 키를 누르세요
1-9

SAM 스마트 주석
세그먼트 애니띵 모델(SAM) 은 몇 번의 클릭만으로 지능형 주석 작업을 가능하게 합니다. 스마트 모드는 detect, segment, OBB 작업에 사용할 수 있습니다.
- 편집 모드로 들어가서 선택하세요
Smart또는 누르세요S - 왼쪽 클릭으로 긍정적인 포인트 추가 (이 영역 포함)
- 오른쪽 클릭으로 부정적인 포인트 추가 (이 영역 제외)
- SAM은 실시간으로 정밀한 마스크를 생성합니다.
- 누르기
Enter또는Escape주석을 저장하기 위해

graph LR
A[Press S] --> B[Left-click Object]
B --> C[SAM Generates Mask]
C --> D{Accurate?}
D -->|Yes| E[Enter to Save]
D -->|No| F[Add +/- Points]
F --> C
style A fill:#2196F3,color:#fff
style C fill:#FF9800,color:#fff
style E fill:#4CAF50,color:#fff
SAM 팁
- 객체 중앙에 긍정적인 클릭으로 시작합니다.
- 배경을 제외하려면 부정적인 클릭을 추가합니다.
- 보류
Alt/Option클릭 동작을 반전시키기 (왼쪽 클릭이 음수, 오른쪽 클릭이 양수로 변경됨) - 명확한 경계를 가진 개별 객체에 가장 잘 작동합니다.
- 길쭉한 물체에는 2~3개의 긍정적인 점을 사용하십시오
SAM 스마트 주석은 다음을 생성할 수 있습니다:
- 다각형 (segmentation 작업용)
- 바운딩 박스 (detection 작업용)
- 지향성 박스 (obb 작업용)
SAM 지원
SAM 주석 기능은 detect, segment, 그리고 OBB 작업에만 사용할 수 있습니다. 분류 및 자세 작업은 수동 어노테이션이 필요합니다.
클래스 사이드바
주석 편집기에는 캔버스 오른쪽에 접을 수 있는 클래스 사이드바가 포함되어 있습니다. 사이드바는 다음을 제공합니다:
- 수업 검색검색 필드에 입력하여 클래스 목록을 필터링하세요.
Enter정확한 일치 항목을 선택하거나, 일치하는 항목이 없을 경우 새 클래스를 생성합니다. - 새 클래스를 인라인으로 생성: 클릭
Add class목록 하단에 이름을 입력하고, 선택적으로 사용자 지정 색상을 선택하세요.Enter만들다. - 클래스 이름 인라인 편집: 클래스 이름 위에 마우스를 올린 후 연필 아이콘을 클릭하여 이름을 변경하세요.
- 색상 선택기: 클래스 옆의 색상 스와치를 클릭하여 해당 클래스의 색상을 변경하세요.
- 클래스별 주석 개수: 각 클래스 행에는 주석 개수가 위첨자로 표시됩니다.
- 확장/축소: 화살표 모양을 클릭하면 해당 클래스가 확장되고 그 아래에 개별 주석이 나열됩니다.
- 양방향 호버 하이라이트: 캔버스에서 주석에 마우스를 올리면 사이드바에서 해당 주석이 강조 표시되며, 반대의 경우도 마찬가지입니다. 사이드바는 자동으로 스크롤되며 관련 클래스로 자동 확장됩니다.
- 개별 주석 숨기기/보이기: 캔버스에서 주석 행의 눈 모양 아이콘을 클릭하면 해당 주석의 표시 여부를 전환할 수 있습니다.
- 주석 삭제: 삭제하려는 주석 행의 휴지통 아이콘을 클릭하세요.
- 키보드 단축키: 다음을 누르세요.
1-9처음 9개 클래스를 빠르게 선택하기 위해.
컨텍스트 메뉴
선택한 주석 위에 마우스 오른쪽 버튼을 클릭하면 다음과 같은 컨텍스트 메뉴가 열립니다:
| 작업 | 단축키 |
|---|---|
| 주석 삭제 | Delete / Backspace |
| 앞으로 가져오기 | Cmd/Ctrl+Shift+] |
| 뒤로 보내기 | Cmd/Ctrl+Shift+[ |
| 앞당기다 | Cmd/Ctrl+] |
| 뒤로 보내기 | Cmd/Ctrl+[ |
가시성 제어
가시성 드롭다운(눈 아이콘)을 통해 개별 요소의 표시 여부를 전환할 수 있습니다:
| 토글 | 설명 |
|---|---|
| 주석 | 모든 주석 오버레이 표시 또는 숨기기 |
| 클래스 레이블 | 주석에 클래스 이름 레이블 표시 또는 숨기기 |
| 픽셀 표시 | 확대 검사 시 픽셀화 렌더링 토글 (전체 화면) |
| 조준선 | 편집 모드에서 픽셀 좌표가 표시된 십자선 커서 표시 |
| 탐색 썸네일 | 탐색 썸네일 스트립 표시 (전체 화면) |
| 모두 표시 | 주석, 레이블, 십자선, 썸네일을 한 번에 토글합니다(픽셀화된 이미지에 영향을 주지 않음) |
조준선 커서
편집 모드에서는 십자선 오버레이가 커서 위치를 추적하고 캔버스에 픽셀 좌표를 표시합니다. 이를 통해 주석을 정밀하게 배치할 수 있습니다. 표시 여부 드롭다운을 통해 토글할 수 있습니다.
SAM 미리보기
스마트 모드에서 segment 작업에 대해 SAM 이미지를 마우스로 가리키기만 해도(어떤 포인트도 클릭하기 전에) 실시간 마스크 미리보기를 SAM . 이를 통해 예측된 세그먼트 경계를 확인하고 클릭 위치를 결정할 수 있습니다. 긍정적 또는 부정적 포인트를 추가하면 미리보기가 업데이트되어 수정 사항을 반영합니다.
다각형 정점 편집
segment 경우, 도형 그리기 후 다각형 꼭짓점을 편집할 수 있습니다:
- 정점 이동: 정점 핸들을 드래그하여 위치를 변경합니다
- 정점 삭제: 정점을 선택하고 누르세요
Delete제거
클래스 관리
클래스 생성
데이터셋에 대한 주석 클래스를 정의하십시오. Classes 탭:
- 다음으로 이동하십시오:
Classes탭 - 하단의 입력란에 클래스 이름을 입력하세요
- 클릭
Add또는 누르세요Enter - Ultralytics 팔레트에서 색상이 자동으로 할당됩니다

주석 처리 중 새 클래스 추가
편집기를 떠나지 않고 주석을 달면서 직접 새 클래스를 생성할 수 있습니다:
- 이미지에 주석을 그리기
- 수업 드롭다운에서 클릭하세요
Add New Class - 클래스 이름을 입력합니다.
- Enter 키를 눌러 생성 및 할당
이를 통해 데이터에서 새로운 객체 유형을 접할 때마다 클래스를 정의할 수 있는 원활한 워크플로우가 가능해집니다.
통합 수업표
데이터셋 전체의 모든 클래스는 통합된 테이블에서 관리됩니다. 클래스 이름이나 색상 변경은 데이터셋 전체에 자동으로 적용됩니다.
클래스 편집
- 이름 변경: 테이블에서 클래스 이름을 클릭하면 인라인으로 편집할 수 있습니다
- 색상 변경: 색상 견본을 클릭하여 색상 선택기를 엽니다
- 검색: 검색 필드를 사용하여 이름별로 강좌를 필터링하세요
- 정렬: 열 헤더를 클릭하여 이름, 라벨 수 또는 이미지 수로 정렬합니다.
클래스 색상
각 클래스에는 Ultralytics 색상이 할당됩니다. 색상 선택기를 사용하여 색상을 사용자 지정할 수 있습니다. Classes 탭. 색상은 플랫폼 전반에 걸쳐 일관되게 적용되어 쉽게 인식할 수 있습니다.
키보드 단축키
키보드 단축키를 사용한 효율적인 어노테이션:
| 단축키 | 작업 |
|---|---|
Cmd/Ctrl+S | 주석 저장 |
Cmd/Ctrl+Z | 실행 취소 |
Cmd/Ctrl+Shift+Z | 다시 실행 |
Cmd/Ctrl+Y | 다시하기 (대안) |
Escape | 저장 / 선택 해제 / 종료 |
Delete / Backspace | 선택된 어노테이션 삭제 |
1-9 | 클래스 1-9 선택 |
Cmd/Ctrl+Scroll | 확대/축소 |
Shift+Click | 다중 선택 주석 |
Cmd/Ctrl+A | 모든 주석 선택 |
| 단축키 | 작업 |
|---|---|
V | 그리기 모드 (수동) |
S | 스마트 모드 (SAM) |
| 단축키 | 작업 |
|---|---|
Click+Drag | 경계 상자 그리기 (detect) |
Click | 다각형 점(segment) 추가 / 키포인트(포즈) 배치 |
Right-click | 완전한 다각형 / SAM 추가 |
Enter | 완전한 다각형 / SAM 저장 |
Escape | SAM 저장 / 선택 해제 / 편집 모드 종료 |
| 단축키 | 작업 |
|---|---|
Cmd/Ctrl+] | 앞당기다 |
Cmd/Ctrl+[ | 뒤로 보내기 |
Cmd/Ctrl+Shift+] | 앞으로 가져오기 |
Cmd/Ctrl+Shift+[ | 뒤로 보내기 |

모든 단축키 보기
주석 도구 모음의 키보드 아이콘을 클릭하여 단축키 참조를 엽니다.
실행 취소/다시 실행
주석 편집기는 전체 실행 취소/다시 실행 기록을 유지합니다:
- 실행 취소:
Cmd/Ctrl+Z - 다시 실행:
Cmd/Ctrl+Shift+Z또는Cmd/Ctrl+Y
역사 기록:
- 주석 추가 (단일 및 일괄)
- 주석 편집(이동, 크기 조정, 회전)
- 주석 삭제 (단일 및 일괄)
- 수업 변경 (개별 및 일괄)
- 주석 재정렬 (z-순서)
- 다각형 정점 편집(추가, 제거, 이동)
- 이동하는 키포인트
무제한 실행 취소
실행 취소 스택에는 고정된 제한이 없습니다 — 현재 편집 세션 동안 이루어진 모든 변경 사항을 실행 취소할 수 있으며, 클릭한 시점의 이미지 원본 상태까지 되돌릴 수 있습니다. Edit.
주석 저장
주석은 클릭하면 저장됩니다 Save 또는 누르세요 Cmd/Ctrl+S:
- 저장: 저장 버튼을 클릭하거나 누르세요
Cmd/Ctrl+S - 취소: 변경 사항을 버리려면 취소를 클릭하세요
- 탈출: 저장되지 않은 변경 사항이 있으면 저장하고, 그렇지 않으면 편집 모드를 종료합니다.
작업 저장
다른 이미지로 이동하기 전에 항상 저장하세요. 저장되지 않은 변경 사항은 손실됩니다.
FAQ
SAM 주석은 얼마나 정확한가요?
SAM은 대부분의 객체에 대해 고품질 마스크를 제공합니다. 정확도는 다음 요소에 따라 달라집니다:
- 배경으로부터 객체의 구별 정도
- 이미지 품질 및 해상도
- 제공된 긍정/부정 포인트 수
최상의 결과를 얻으려면 객체 중앙에 긍정 포인트를 찍고, 근처 객체를 제외하기 위해 부정 포인트를 추가하세요.
기존 주석을 가져올 수 있나요?
예, YOLO 레이블 파일과 함께 데이터셋을 업로드하세요. 플랫폼이 자동으로 파싱하여 에디터에 표시합니다.
동일한 클래스의 여러 객체에 주석을 다는 방법은 무엇인가요?
주석을 그린 후:
- 동일한 클래스를 선택된 상태로 유지
- 다음 주석 그리기
- 모든 객체가 레이블링될 때까지 반복합니다.
키보드 단축키 1-9 클래스를 빠르게 선택합니다.
부분적으로 주석이 달린 데이터셋으로 훈련할 수 있나요?
네, 하지만 최상의 결과를 위해:
- 각 이미지에서 대상 클래스의 모든 객체에 레이블을 지정합니다.
- 라벨 필터 세트를 사용하여
Unannotated라벨이 없는 이미지를 식별하기 위해 - 주석이 없는 이미지를 훈련 구성에서 제외합니다
어떤 작업이 SAM 어노테이션을 지원합니까?
SAM 어노테이션은 다음에 사용할 수 있습니다. detect, segment, OBB 작업에 사용할 수 있습니다. 분류 및 포즈 작업은 수동 어노테이션만 사용합니다.