주석 편집기#

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

지원되는 Task 유형#

주석 편집기는 6가지 YOLO 작업 유형에 대한 주석 도구를 제공합니다.

깊이 정답은 업로드하는 쌍을 이루는 맵이며 직접 그리는 것이 아니므로, 깊이 데이터셋에서는 편집기가 읽기 전용으로 열립니다.

작업 세부 정보#

시작하기#

이미지에 주석을 지정하려면 다음을 수행합니다.

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은(는) 공간 어노테이션 작업을 위한 기본 모드입니다. 감지, 분할, 의미론적 분할, 포즈 및 OBB 데이터셋의 경우, 스마트 어노테이션을 사용할 수 있을 때 툴바에서도 Smart 모드를 제공합니다.

포즈 어노테이션은 골격 템플릿과 함께 Draw을(를) 사용하며, 해당 Smart 모드는 SAM 선택 도구와 자동 적용 토글 없이 YOLO 포즈 모델만 제공합니다. 분류는 클래스 사이드바를 직접 사용하며 드로잉 툴바나 Smart 버튼이 전혀 표시되지 않습니다.

현재 클라우드 또는 On Premise 스토리지를 기반으로 하는 연결된 데이터셋에서는 스마트 주석을 사용할 수 없습니다.

그리기 모드 도구#

바운딩 박스 (Detect)#

객체 주위에 직사각형 박스를 그립니다.

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

폴리곤 (Segment)#

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

1. 클래스 사이드바에서 클래스를 선택합니다.
2. 기본 Draw 모드에서 클릭하여 꼭짓점을 추가하거나, Shift을 누른 상태로 마우스를 움직여 조밀한 점을 자유롭게 그립니다.
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부터 숫자 키를 누릅니다.

스마트 주석#

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

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 스마트 주석은 다음을 생성할 수 있습니다.

• 분할 작업용 폴리곤
• 탐지 작업용 바운딩 박스
• OBB 작업용 방향성 박스

자동 적용 모드#

자동 적용 모드는 클릭할 때마다 SAM 마스크를 자동으로 저장하여 스마트 주석 작업을 빠르게 수행합니다 — Enter을 누를 필요가 없습니다. 툴바의 자동 적용 버튼을 사용하거나 A을 눌러 전환합니다.

SAM 모델 선택#

Smart 모드가 활성화되면 툴바에 모델 선택기가 나타납니다. 6가지 SAM 모델을 사용할 수 있으며, 데이터셋에 적합한 속도와 정확도의 트레이드오프를 고려하여 선택하십시오.

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

YOLO 스마트 주석#

YOLO 모델을 선택하면 스마트 주석에서 사전 학습된 Ultralytics 모델 또는 자체 파인튜닝한 모델의 예측 결과를 추가할 수 있습니다.

1. Smart을 선택하거나 S을 누릅니다.
2. 툴바의 모델 선택기에서 YOLO 모델을 선택합니다(Official 또는 My Models).
3. Predict을 클릭합니다.
4. 추가된 주석을 검토하고 필요한 부분을 수정합니다.

배치 어노테이션#

배치 어노테이션은 열려 있는 이미지 대신 전체 데이터셋에 대해 하나의 YOLO 모델을 실행합니다. 에디터에서 YOLO 예측 후 토스트의 Inference All 액션 또는 데이터셋 페이지의 More actions > Batch Annotation에서 엽니다. 최대 3개의 이미지 채널을 가진 Platform 호스팅 데이터셋의 데이터셋 편집자에게 제공되며, 깊이를 제외한 모든 작업에 사용할 수 있습니다.

1. 선택 도구(Official 또는 My Models)에서 모델을 선택하세요.
2. 신뢰도(기본값 0.25) 및 IoU(기본값 0.7) 슬라이더를 조절하세요. 슬라이더를 이동함에 따라 Test run 스트립에 모델이 몇 가지 샘플 이미지에서 찾는 항목이 표시됩니다.
3. Include annotated images를 켜면 이미 레이블이 있는 이미지에 대해서도 실행됩니다. 실행 시 모델이 찾은 항목이 추가되고 기존 레이블은 유지됩니다.
4. Estimated Cost를 검토하고 Start를 클릭하세요.

기본적으로 레이블이 지정되지 않은 이미지만 어노테이션되며 기존 레이블은 절대 변경되지 않습니다. 실행에는 데이터셋 클래스가 필요합니다. 모델의 클래스가 데이터셋의 클래스와 다른 경우 Map classes 단계를 통해 각 모델 클래스를 데이터셋 클래스에 매핑하거나 건너뛸 수 있으며, 클래스가 없는 데이터셋에서는 클래스를 생성합니다. 실행은 클래스가 존재한 후에만 시작됩니다. 실행을 시작하면 데이터셋 버전이 먼저 저장되므로 결과가 마음에 들지 않을 경우 데이터셋을 복원할 수 있습니다.

데이터셋 페이지에는 실행 진행 상황이 표시되며, Stop을 누르면 지금까지 처리된 이미지가 유지되고 비용이 청구됩니다. 실행이 완료되면 요약에 처리된 이미지와 추가된 어노테이션 및 클래스가 표시됩니다.

클래스 사이드바#

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

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

컨텍스트 메뉴#

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

가시성 컨트롤#

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

십자선 커서#

annotation 중 십자선 오버레이가 커서 위치를 추적하고 캔버스에 픽셀 좌표를 표시합니다. 이를 통해 annotation을 정밀하게 배치할 수 있습니다. 가시성 드롭다운에서 전환할 수 있습니다.

SAM 호버 미리 보기#

Smart 모드에서 SAM은 어떤 점을 클릭하기 전에 실시간 호버 미리 보기를 제공합니다. 이 미리 보기는 detect, segment, semantic, OBB task에서 사용할 수 있습니다. 세부 조정을 위한 클릭을 추가하면 현재 mask와 활성 task의 annotation type을 반영하도록 미리 보기가 업데이트됩니다.

폴리곤 꼭짓점 편집#

segment annotation의 경우, 그린 후 폴리곤 꼭짓점을 편집할 수 있습니다:

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

클래스 관리#

클래스 생성#

Classes 탭에서 dataset의 annotation 클래스를 정의합니다:

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

Annotation 중 새 클래스 추가#

editor를 나가지 않고 annotation 중에 직접 새 클래스를 생성할 수 있습니다:

1. 이미지에 annotation을 그립니다
2. 클래스 사이드바에서 Add class을 클릭합니다(또는 사이드바 검색 상자에 새 이름을 입력합니다)
3. 클래스 이름을 입력합니다
4. Enter를 눌러 생성하고 할당합니다

이를 통해 데이터에서 새로운 object type을 발견할 때 클래스를 정의할 수 있는 원활한 workflow를 사용할 수 있습니다.

클래스 편집#

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

클래스 색상#

각 클래스에는 Ultralytics palette의 색상이 할당됩니다. Classes 탭의 color picker를 사용하여 색상을 사용자 지정할 수 있으며, 선택한 색상은 해당 dataset 전체에서 사용됩니다.

키보드 단축키#

키보드 단축키를 사용한 효율적인 annotation:

실행 취소/다시 실행#

annotation editor는 전체 실행 취소/다시 실행 기록을 유지합니다:

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

기록 항목:

• annotation 추가(단일 및 일괄)
• annotation 편집(이동, 크기 조정, 회전)
• annotation 삭제(단일 및 일괄)
• 클래스 변경(단일 및 일괄)
• 주석 순서 변경(z-order)
• 폴리곤 꼭짓점 편집(추가, 제거, 이동)
• 키포인트 이동

주석 저장#

마지막 주석 편집 후 1초가 지나면 변경 사항이 자동으로 저장됩니다. 다른 이미지로 이동하거나 전체 화면 편집기를 닫을 때도 저장됩니다.

• 지금 저장: 저장 버튼을 클릭하거나 Cmd/Ctrl+S을 누릅니다.
• 닫기: 닫기 버튼을 클릭하거나 이미지 바깥을 클릭하거나 Escape을 누릅니다. 닫을 때 보류 중인 변경 사항이 백그라운드에서 저장됩니다.

FAQ#