어노테이션 에디터

Ultralytics Platform은 이미지에 바운딩 박스, 폴리곤, 키포인트, 방향성 박스 및 분류를 라벨링할 수 있는 강력한 어노테이션 에디터를 포함하고 있습니다. 이 에디터는 수동 그리기 및 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 작업 유형을 모두 지원합니다:

작업 세부 정보

시작하기

이미지 어노테이션 방법:

1. 데이터셋으로 이동
2. 이미지를 클릭하여 전체 화면 뷰어 열기
3. Edit(편집)을 클릭하여 어노테이션 모드로 진입
4. 툴바에서 어노테이션 도구 선택
5. 이미지에 어노테이션 그리기
6. 완료 후 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

어노테이션 모드

에디터는 툴바에서 선택 가능한 두 가지 어노테이션 모드를 제공합니다:

수동 어노테이션 도구

바운딩 박스 (탐지)

객체 주위에 직사각형 상자 그리기:

1. 편집 모드로 들어가서 Draw 선택
2. 클릭하고 드래그하여 직사각형 그리기
3. 놓아서 박스 완성
4. 드롭다운에서 클래스 선택

폴리곤 (세그먼트)

정밀한 폴리곤 마스크 그리기:

1. 편집 모드로 들어가서 Draw 선택
2. 클릭하여 정점을 추가하거나, Shift를 누른 상태에서 마우스를 움직여 자유형으로 상세 지점 그리기
3. 첫 번째 정점을 클릭하거나 Enter 또는 Escape를 눌러 폴리곤 닫기
4. 드롭다운에서 클래스 선택

키포인트 (포즈)

스켈레톤 템플릿을 사용하여 포즈 어노테이션을 수행합니다. 툴바에서 템플릿을 선택하고, 한 번 클릭하여 모든 키포인트를 배치한 다음, 개별 키포인트를 드래그하여 위치를 조정합니다.

1. 편집 모드로 들어가서 Draw 선택
2. 툴바의 템플릿 선택기에서 스켈레톤 템플릿 선택

3. 이미지를 클릭하여 모든 키포인트를 한 번에 배치
4. 개별 키포인트를 드래그하여 위치 조정
5. Enter를 눌러 확정하거나 Escape를 눌러 취소

내장 스켈레톤 템플릿

에디터는 5가지 내장 템플릿을 포함합니다:

사용자 지정 스켈레톤 템플릿

모든 포즈 구조에 대해 사용자 지정 템플릿을 생성합니다:

1. 템플릿 선택기 옆의 + 버튼을 클릭합니다
2. 옵션으로 **Start from...**을 클릭하여 기존 템플릿의 키포인트와 연결을 시작점으로 불러올 수 있습니다
3. 클릭하여 캔버스에 키포인트를 배치합니다
4. 각 키포인트의 이름을 지정하고 색상을 사용자 지정합니다
5. 두 점을 선택하여 키포인트를 연결합니다 (순차적으로 키포인트를 배치하면 연결이 자동으로 그려집니다)
6. 데이터셋 전반에서 재사용할 수 있도록 템플릿을 저장합니다

사용자 지정 템플릿은 계정에 저장되며 모든 포즈 데이터셋에서 사용할 수 있습니다.

방향성 바운딩 박스 (OBB)

기울어진 물체를 위해 회전된 박스를 그립니다:

1. 편집 모드로 들어가서 Draw 선택
2. 클릭하고 드래그하여 초기 박스를 그립니다
3. 회전 핸들을 사용하여 각도를 조정합니다
4. 코너 핸들을 드래그하여 크기를 조정합니다
5. 드롭다운에서 클래스 선택

분류 (Classify)

이미지 수준의 클래스 레이블을 할당합니다:

1. 편집 모드로 들어갑니다
2. 클래스 선택 버튼이 있는 사이드 패널이 나타납니다
3. 클래스 버튼을 클릭하거나 숫자 키 1-9를 누릅니다

스마트 어노테이션

스마트 어노테이션은 편집기에 모델 기반 어노테이션 기능을 추가합니다. 스마트 모드에서는 Segment Anything Model (SAM)을 사용하여 클릭 기반으로 어노테이션을 생성하거나, 사전 훈련된 Ultralytics YOLO 모델 및 직접 파인튜닝한 YOLO 모델의 예측 결과를 어노테이션으로 추가할 수 있습니다. 스마트 어노테이션은 detect, segment 및 OBB 작업에서 사용할 수 있습니다.

SAM 스마트 어노테이션

SAM 모델이 선택된 상태에서:

1. 편집 모드로 들어가 Smart를 선택하거나 S를 누릅니다
2. 어노테이션을 추가할 물체를 클릭하면 SAM이 실시간으로 초기 마스크를 생성합니다
3. 추가 클릭으로 마스크를 정교화합니다: 현재 마스크 외부를 클릭하여 범위를 추가하거나, 현재 마스크 내부를 클릭하여 영역을 뺍니다
4. Enter 또는 Escape를 눌러 어노테이션을 저장하거나, 원클릭 워크플로를 위해 auto-apply를 활성화합니다

graph LR
    A[Press S] --> B[Left-click Object]
    B --> C[SAM Generates Mask]
    C --> D{Auto-apply?}
    D -->|Yes| E[Mask Applied Automatically]
    D -->|No| F{Accurate?}
    F -->|Yes| G[Enter to Save]
    F -->|No| H[Add +/- Points]
    H --> C

    style A fill:#2196F3,color:#fff
    style C fill:#FF9800,color:#fff
    style E fill:#4CAF50,color:#fff
    style G fill:#4CAF50,color:#fff

SAM 스마트 어노테이션은 다음을 생성할 수 있습니다:

• 세그멘테이션 작업을 위한 Polygons
• 탐지 작업을 위한 Bounding boxes
• OBB 작업을 위한 Oriented boxes

Auto-apply 모드

Auto-apply 모드는 각 클릭 후 SAM 마스크를 자동으로 저장하여 스마트 어노테이션 속도를 높여줍니다 (Enter를 누를 필요가 없습니다). 툴바의 auto-apply 버튼으로 전환하거나 A를 누르십시오.

SAM 모델 선택

스마트 모드가 활성화되면 툴바에 모델 선택기가 나타납니다. 5개의 SAM 모델을 사용할 수 있으며, 데이터셋에 적합한 속도 대 정확도 절충안을 기준으로 선택하십시오:

스마트 모드가 활성화된 상태에서 모델을 전환하면 현재 이미지에 대한 예측기가 자동으로 재초기화됩니다.

YOLO 스마트 어노테이션

YOLO 모델이 선택된 상태에서 스마트 어노테이션은 사전 훈련된 Ultralytics 모델 또는 직접 파인튜닝한 모델의 예측 결과를 추가할 수 있습니다.

1. 편집 모드로 들어가 Smart를 선택하거나 S를 누릅니다
2. 툴바의 모델 선택기(Official 또는 My Models)에서 YOLO 모델을 선택합니다
3. Predict를 클릭합니다
4. 추가된 어노테이션을 검토하고 필요한 수정 사항을 적용합니다

클래스 사이드바

어노테이션 편집기에는 캔버스 오른쪽에 접을 수 있는 클래스 사이드바가 포함되어 있습니다. 사이드바는 다음 기능을 제공합니다:

• 클래스 검색: 검색 필드에 입력하여 클래스 목록을 필터링합니다. 정확히 일치하는 항목에서 Enter를 눌러 선택하거나, 일치하는 항목이 없으면 새 클래스를 생성합니다.
• 인라인으로 새 클래스 생성: 목록 하단의 Add class를 클릭하고 이름을 입력한 뒤 옵션으로 색상을 선택합니다. Enter를 눌러 생성합니다.
• 인라인으로 클래스 이름 편집: 클래스 이름 위에 마우스를 올리고 연필 아이콘을 클릭하여 이름을 변경합니다.
• 색상 선택기: 클래스 옆의 색상 견본을 클릭하여 색상을 변경합니다.
• 클래스별 어노테이션 수: 각 클래스 행은 상단에 어노테이션 개수를 표시합니다.
• 확장/축소: 꺾쇠(chevron)를 클릭하여 클래스를 확장하고 아래에 나열된 개별 어노테이션을 확인합니다.
• 양방향 호버 하이라이트: 캔버스에서 어노테이션 위에 마우스를 올리면 사이드바에서 해당 항목이 강조되며, 그 반대도 마찬가지입니다. 사이드바는 관련 클래스로 자동 스크롤 및 자동 확장됩니다.
• 개별 어노테이션 숨기기/표시: 어노테이션 행의 눈 아이콘을 클릭하여 캔버스에서의 표시 여부를 전환합니다.
• 어노테이션 삭제: 어노테이션 행의 휴지통 아이콘을 클릭하여 삭제합니다.
• 키보드 단축키: 1-9를 눌러 상위 9개 클래스를 빠르게 선택합니다.

컨텍스트 메뉴

선택한 어노테이션을 마우스 오른쪽 버튼으로 클릭하여 다음 컨텍스트 메뉴를 엽니다:

표시 제어

표시 드롭다운(눈 아이콘)을 통해 개별 요소의 표시 여부를 전환할 수 있습니다:

십자선 커서

편집 모드에서 십자선 오버레이가 커서 위치를 추적하고 캔버스에 픽셀 좌표를 표시합니다. 이는 어노테이션을 정밀하게 배치하는 데 도움이 됩니다. 표시 드롭다운을 통해 전환하십시오.

SAM 마우스 오버 미리보기

Smart 모드에서 SAM은 포인트를 클릭하기 전에 실시간 마우스 오버 미리보기를 제공합니다. 이 미리보기는 detect, segment, OBB 작업에서 사용할 수 있습니다. 세부 조정 클릭을 추가하면 미리보기가 업데이트되어 현재 마스크와 활성 작업의 어노테이션 유형이 반영됩니다.

다각형 정점 편집

세그먼트 어노테이션의 경우, 그린 후에 다각형 정점을 편집할 수 있습니다:

• 정점 이동: 정점 핸들을 드래그하여 위치를 변경합니다
• 정점 삭제: 정점을 선택하고 Delete를 눌러 제거합니다

클래스 관리

클래스 생성

Classes 탭에서 데이터셋에 대한 어노테이션 클래스를 정의합니다:

1. Classes 탭으로 이동합니다
2. 하단의 입력 필드를 사용하여 클래스 이름을 입력합니다
3. Add를 클릭하거나 Enter를 누릅니다
4. Ultralytics 팔레트에서 색상이 자동으로 할당됩니다

어노테이션 중 새 클래스 추가

에디터를 벗어나지 않고 어노테이션을 수행하는 동안 새 클래스를 직접 생성할 수 있습니다:

1. 이미지에 어노테이션을 그립니다
2. 클래스 드롭다운에서 Add New Class를 클릭합니다
3. 클래스 이름을 입력합니다
4. Enter를 눌러 생성 및 할당합니다

이를 통해 데이터에서 새로운 객체 유형을 발견할 때마다 클래스를 정의할 수 있는 원활한 워크플로우가 가능합니다.

클래스 편집

• 이름 변경: 테이블에서 클래스 이름을 클릭하여 인라인으로 편집합니다
• 색상 변경: 색상 견본을 클릭하여 색상 선택기를 엽니다
• 검색: 검색 필드를 사용하여 이름별로 클래스를 필터링합니다
• 정렬: 열 헤더를 클릭하여 이름, 레이블 수 또는 이미지 수별로 정렬합니다

클래스 색상

각 클래스에는 Ultralytics 팔레트에서 색상이 할당됩니다. Classes 탭의 색상 선택기를 사용하여 색상을 사용자 정의할 수 있습니다. 색상은 쉽게 인식할 수 있도록 플랫폼 전체에서 일관되게 유지됩니다.

키보드 단축키

키보드 단축키를 사용한 효율적인 어노테이션:

실행 취소/다시 실행

어노테이션 에디터는 전체 실행 취소/다시 실행 기록을 유지합니다:

• 실행 취소: Cmd/Ctrl+Z
• 다시 실행: Cmd/Ctrl+Y

기록 추적 항목:

• 어노테이션 추가 (단일 및 배치)
• 어노테이션 편집 (이동, 크기 조절, 회전)
• 어노테이션 삭제 (단일 및 배치)
• 클래스 변경 (단일 및 배치)
• 어노테이션 순서 변경 (z-순서)
• 폴리곤 정점 편집 (추가, 제거, 이동)
• 키포인트 이동

어노테이션 저장

Save를 클릭하거나 Cmd/Ctrl+S를 누르면 어노테이션이 저장됩니다:

• 저장: 저장 버튼을 클릭하거나 Cmd/Ctrl+S를 누릅니다.
• 취소: 취소를 클릭하여 변경 사항을 삭제합니다.
• Escape: 저장되지 않은 변경 사항이 있으면 저장하고, 그렇지 않으면 편집 모드를 종료합니다.

FAQ

SAM 어노테이션의 정확도는 어느 정도입니까?

SAM은 대부분의 객체에 대해 고품질 마스크를 제공합니다. 정확도는 다음 항목에 따라 달라집니다:

• 배경과 객체의 구분 정도
• 이미지 품질 및 해상도
• 제공된 긍정/부정 포인트의 수

최상의 결과를 얻으려면 객체 중심을 먼저 클릭한 다음, 마스크 외부 클릭으로 범위를 추가하고 마스크 내부 클릭으로 주변 객체나 배경을 제외하십시오.

기존 어노테이션을 가져올 수 있습니까?

네, YOLO-format label files과 함께 데이터셋을 업로드하십시오. 플랫폼이 자동으로 이를 파싱하여 에디터에 표시합니다.

동일한 클래스의 여러 객체를 어떻게 어노테이션합니까?

어노테이션을 그린 후:

1. 동일한 클래스를 계속 선택한 상태로 둡니다.
2. 다음 어노테이션을 그립니다.
3. 모든 객체가 라벨링될 때까지 반복합니다.

1-9 단축키를 사용하여 빠르게 클래스를 선택할 수 있습니다.

부분적으로 어노테이션된 데이터셋으로 학습할 수 있습니까?

네, 하지만 최상의 결과를 위해서는 다음을 권장합니다:

• 각 이미지 내의 타겟 클래스에 해당하는 모든 객체를 라벨링하십시오.
• 라벨 필터를 Unlabeled로 설정하여 어노테이션이 필요한 이미지를 식별하십시오.
• 라벨링되지 않은 이미지는 학습에서 제외되며, 라벨링된 이미지만 손실(loss) 계산에 기여합니다.

어떤 SAM 모델을 사용해야 합니까?

SAM 3는 기본값이자 최신 세대 모델이므로, 가장 높은 품질의 마스크를 위해 이 모델부터 시작하십시오. 일반적인 객체에 대해 더 빠른 대화형 워크플로우를 원하면 SAM 2.1 Small로 전환하고, 복잡한 형태에서 더 높은 마스크 정밀도가 필요할 때는 SAM 2.1 Large를 사용하십시오. 단순하고 대비가 높은 객체에서 최대 속도를 내려면 SAM 2.1 Tiny를 사용하십시오.

어떤 작업이 SAM 스마트 어노테이션을 지원합니까?

SAM 스마트 어노테이션은 detect, segment, OBB 작업에서 사용할 수 있습니다. 분류(Classification) 및 포즈(Pose) 작업은 수동 어노테이션만 사용합니다.

포즈 어노테이션을 위한 커스텀 스켈레톤 템플릿을 만들 수 있습니까?

네. 스켈레톤 템플릿 선택기 옆의 + 버튼을 클릭하여 템플릿 에디터를 엽니다. 키포인트를 배치하고 이름을 지정하며 연결선을 그리고 저장하십시오. 커스텀 템플릿은 계정에 저장되어 모든 포즈 데이터셋에서 사용할 수 있습니다.

스켈레톤 템플릿을 어떻게 전환합니까?

어노테이션 툴바의 템플릿 선택기 드롭다운을 클릭하십시오. 내장된 템플릿(Person, Hand, Face, Dog, Box)이나 저장된 커스텀 템플릿을 선택하십시오. 선택한 템플릿에 따라 이미지 클릭 시 배치되는 키포인트가 결정됩니다.