어노테이션 에디터#

Ultralytics Platform은 경계 박스, 폴리곤, 키포인트, 회전 박스 및 분류로 이미지를 라벨링하기 위한 어노테이션 에디터를 포함합니다. 에디터는 수동 그리기, SAM 기반 스마트 어노테이션, 그리고 호환되는 YOLO 모델의 예측을 지원합니다.

graph TB
    subgraph Draw["Shape set by the dataset task"]
        A[Box]:::start & B[Polygon]:::start & C[Classify]:::start & D[Keypoint]:::start & E[OBB]:::start
    end
    subgraph AI["AI-Assisted"]
        F[SAM Smart]:::start
        G[YOLO Predict]:::start
    end
    Draw --> H[Save Labels]:::out
    AI --> H

    classDef start fill:#4CAF50,color:#fff
    classDef out fill:#9C27B0,color:#fff

지원되는 작업 유형#

어노테이션 편집기는 6가지 YOLO 태스크 유형을 위한 어노테이션 도구를 제공합니다:

Depth ground truth는 직접 그리는 것이 아니라 업로드하는 페어드 맵이므로, 편집기는 깊이 데이터셋에서 읽기 전용으로 열립니다.

작업 세부 정보#

시작하기#

이미지 어노테이션 방법:

1. 데이터셋으로 이동합니다.
2. 이미지를 한 번 클릭하여 전체 화면 어노테이션 에디터를 엽니다.
3. 기본 Draw 모드를 사용하거나, 지원되는 경우 Smart로 전환하십시오.
4. 클래스를 선택하고 이미지에 직접 어노테이션을 추가하거나 조정합니다.
5. 다른 이미지로 이동하거나 에디터를 닫습니다. 변경 사항은 각 편집 후에 자동으로 저장됩니다.

편집할 수 있는 데이터셋의 경우, 데스크톱에서 전체 화면 뷰어가 열리는 즉시 어노테이션 제어 기능이 활성화됩니다. 별도의 편집 모드나 Edit 버튼은 없습니다. 모바일 환경이거나 편집 권한이 없는 경우 전체 화면 뷰어는 읽기 전용입니다.

graph LR
    A[Open Dataset]:::start --> B[Click Image]:::proc
    B --> C[Annotate in Fullscreen]:::proc
    C --> D[Changes Auto-Save]:::out
    D --> E[Next Image]:::proc
    E --> B

    classDef start fill:#4CAF50,color:#fff
    classDef proc fill:#2196F3,color:#fff
    classDef out fill:#9C27B0,color:#fff

어노테이션 모드#

Draw은 공간 어노테이션 작업의 기본 모드입니다. 감지(detect), 세그먼트(segment), 시맨틱(semantic), OBB 데이터셋의 경우, 스마트 어노테이션을 사용할 수 있을 때 툴바에서 Smart 모드도 제공합니다.

포즈 어노테이션은 스켈레톤 템플릿과 함께 Draw을 사용합니다. Smart 버튼이 나타나지만 비활성화되며 "Coming Soon"으로 표시됩니다. 분류는 클래스 사이드바를 직접 사용하며 드로잉 툴바나 Smart 버튼이 전혀 표시되지 않습니다.

스마트 어노테이션은 현재 클라우드 또는 온프레미스 스토리지로 지원되는 연결된 데이터셋에서는 사용할 수 없습니다.

Draw 모드 도구#

바운딩 박스 (Detect)#

객체 주변에 직사각형 박스를 그립니다:

1. 클래스 사이드바에서 클래스 선택
2. 기본 Draw 모드에서 클릭하고 드래그하여 직사각형을 그리십시오.
3. 놓아서 박스를 완성합니다.

폴리곤 (Segment)#

정밀한 폴리곤 마스크를 그립니다:

1. 클래스 사이드바에서 클래스 선택
2. 기본 Draw 모드에서 클릭하여 꼭짓점을 추가하거나, Shift을 누른 채 마우스를 움직여 조밀한 점을 자유로그리기(freehand) 하십시오.
3. 더블 클릭하거나, 첫 번째 꼭짓점을 클릭하거나, Enter 또는 Escape을 눌러 폴리곤을 닫으십시오.

키포인트 (Pose)#

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

1. 클래스 사이드바에서 클래스 선택
2. 기본 Draw 모드에서 툴바의 템플릿 선택기에서 스켈레톤 템플릿을 선택하십시오.
3. 이미지를 클릭하여 모든 키포인트를 한 번에 배치합니다.
4. 개별 키포인트를 드래그하여 위치를 조정합니다.

내장 스켈레톤 템플릿#

에디터에는 5가지 내장 템플릿이 포함되어 있습니다:

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

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

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

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

방향성 바운딩 박스 (OBB)#

기울어진 객체에 대해 회전된 박스를 그립니다:

1. 클래스 사이드바에서 클래스 선택
2. 기본 Draw 모드에서 클릭하고 드래그하여 초기 박스를 그리십시오.
3. 회전 핸들을 사용하여 각도를 조정합니다
4. 코너 핸들을 드래그하여 크기를 조정합니다

분류(Classify)#

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

1. 이미지를 클릭하여 전체 화면 에디터 열기
2. 클래스 사이드바에서 클래스를 선택하거나 1-9에서 숫자 키를 누르십시오.

스마트 어노테이션#

스마트 어노테이션은 에디터에 모델 기반 어노테이션 기능을 추가합니다. 스마트 모드에서는 Segment Anything Model (SAM)을 사용하여 클릭 기반 어노테이션을 수행하거나, 사전 학습된 Ultralytics YOLO 모델 및 자체 미세 조정된 YOLO 모델을 사용하여 예측을 어노테이션으로 추가할 수 있습니다. 스마트 어노테이션은 detect, segment, semantic, OBB 작업에 사용할 수 있습니다.

SAM 스마트 어노테이션#

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

1. Smart을 선택하거나 S을 누르십시오.
2. 어노테이션을 추가할 객체를 클릭하면 SAM이 실시간으로 초기 마스크를 생성합니다
3. 추가 클릭으로 마스크를 정교화합니다: 현재 마스크 외부를 클릭하여 범위를 추가하거나, 현재 마스크 내부를 클릭하여 영역을 뺍니다
4. Enter 또는 Escape을 눌러 어노테이션을 저장하거나, 원클릭 워크플로우를 위해 **자동 적용(auto-apply)**을 활성화하십시오.

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

    classDef start fill:#4CAF50,color:#fff
    classDef proc fill:#2196F3,color:#fff
    classDef decide fill:#FF9800,color:#fff
    classDef out fill:#9C27B0,color:#fff

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

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

자동 적용 모드(Auto-Apply Mode)#

자동 적용 모드는 각 클릭 후 SAM 마스크를 자동으로 저장하여 스마트 어노테이션 속도를 높여주며, Enter을 누를 필요가 없습니다. 툴바의 자동 적용 버튼으로 토글하거나 A을 누르십시오.

SAM 모델 선택#

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

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

YOLO 스마트 어노테이션#

YOLO 모델이 선택된 상태에서 스마트 어노테이션은 사전 학습된 Ultralytics 모델 또는 직접 미세 조정한 모델의 예측값을 추가할 수 있습니다.

1. Smart을 선택하거나 S을 누르십시오.
2. 툴바의 모델 선택기에서 YOLO 모델을 선택하십시오 (Official 또는 My Models).
3. Predict 클릭
4. 추가된 어노테이션을 검토하고 필요한 수정 작업을 수행합니다

클래스 사이드바#

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

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

컨텍스트 메뉴#

선택한 주석을 마우스 오른쪽 버튼으로 클릭하여 다음을 포함하는 컨텍스트 메뉴를 엽니다:

표시 설정#

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

십자선 커서#

어노테이션 작업 중에 십자선 오버레이가 커서 위치를 추적하고 캔버스에 픽셀 좌표를 표시합니다. 이는 정밀하게 어노테이션을 배치하는 데 도움이 됩니다. 가시성 드롭다운을 통해 켜고 끌 수 있습니다.

SAM 호버 미리보기#

스마트 모드에서 SAM은 포인트를 클릭하기 전에 실시간 호버 미리보기를 제공합니다. 이 미리보기는 detect, segment, semantic 및 OBB 작업에서 사용할 수 있습니다. 세분화 클릭을 추가하면 미리보기가 업데이트되어 현재 마스크와 활성 작업에 대한 주석 유형이 반영됩니다.

다각형 정점 편집#

세그먼트 주석의 경우, 그린 후에 다각형 정점을 편집할 수 있습니다:

• 정점 이동: 정점 핸들을 드래그하여 위치를 조정합니다
• 꼭짓점 삭제: 꼭짓점을 선택하고 Delete을 눌러 제거하십시오.

클래스 관리#

클래스 만들기#

Classes 탭에서 데이터셋의 어노테이션 클래스를 정의하십시오:

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

주석 도중 새 클래스 추가#

편집기를 떠나지 않고 주석을 작성하는 동안 직접 새 클래스를 만들 수 있습니다:

1. 이미지에 주석 그리기
2. 클래스 사이드바에서 Add class을 클릭하십시오 (또는 사이드바 검색 상자에 새 이름을 입력하십시오).
3. 클래스 이름 입력
4. Enter를 눌러 생성 및 할당

이를 통해 데이터에서 새로운 객체 유형을 만날 때 클래스를 정의하는 원활한 워크플로가 가능해집니다.

클래스 편집#

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

클래스 색상#

각 클래스에는 Ultralytics 팔레트의 색상이 할당됩니다. Classes 탭의 색상 선택기를 사용하여 색상을 사용자 정의할 수 있으며, 선택된 색상은 해당 데이터셋 전체에서 사용됩니다.

키보드 단축키#

키보드 단축키를 사용한 효율적인 주석 작업:

실행 취소/다시 실행#

주석 편집기는 전체 실행 취소/다시 실행 기록을 유지합니다:

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

기록 추적 항목:

• 주석 추가 (단일 및 일괄)
• 주석 편집 (이동, 크기 조절, 회전)
• 주석 삭제 (단일 및 일괄)
• 클래스 변경 (단일 및 일괄)
• 주석 재정렬 (z-순서)
• 다각형 정점 편집 (추가, 제거, 이동)
• 키포인트 이동

주석 저장#

마지막 어노테이션 편집 후 1초가 지나면 변경 사항이 자동으로 저장됩니다. 또한 다른 이미지로 이동하거나 전체 화면 에디터를 닫을 때도 저장됩니다.

• 지금 저장: 저장 버튼을 클릭하거나 Cmd/Ctrl+S을 누르십시오.
• 닫기: 닫기 버튼을 클릭하거나, 이미지 바깥쪽을 클릭하거나, Escape을 누르십시오. 닫으면 보류 중인 변경 사항에 대한 백그라운드 저장이 트리거됩니다.

FAQ#