Link to this section어노테이션 에디터#

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

Link to this section지원되는 작업 유형#

어노테이션 에디터는 6가지 YOLO 작업 유형을 모두 지원합니다:

Link to this section작업 세부 정보#

Link to this section시작하기#

이미지 어노테이션 방법:

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

Link to this section어노테이션 모드#

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

Link to this section수동 어노테이션 도구#

Link to this section바운딩 박스 (Detect)#

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

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

Link to this section폴리곤 (Segment)#

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

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

Link to this section키포인트 (Pose)#

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

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

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

Link to this section내장 스켈레톤 템플릿#

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

Link to this section사용자 지정 스켈레톤 템플릿#

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

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

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

Link to this section방향성 바운딩 박스 (OBB)#

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

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

Link to this section분류(Classify)#

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

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

Link to this section스마트 어노테이션#

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

Link to this sectionSAM 스마트 어노테이션#

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

Link to this section자동 적용 모드(Auto-Apply Mode)#

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

Link to this sectionSAM 모델 선택#

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

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

Link to this sectionYOLO 스마트 어노테이션#

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

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

Link to this section클래스 사이드바#

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

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

Link to this section컨텍스트 메뉴#

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

Link to this section표시 설정#

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

Link to this section십자선 커서#

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

Link to this sectionSAM 호버 미리보기#

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

Link to this section다각형 정점 편집#

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

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

Link to this section클래스 관리#

Link to this section클래스 만들기#

Classes 탭에서 데이터셋에 대한 주석 클래스를 정의합니다:

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

Link to this section주석 도중 새 클래스 추가#

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

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

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

Link to this section클래스 편집#

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

Link to this section클래스 색상#

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

Link to this section키보드 단축키#

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

Link to this section실행 취소/다시 실행#

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

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

기록 추적 항목:

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

Link to this section주석 저장#

Save를 클릭하거나 Cmd/Ctrl+S를 누르면 주석이 저장됩니다:

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

Link to this sectionFAQ#

Link to this sectionSAM 주석은 얼마나 정확합니까?#

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

• 배경과 객체의 뚜렷한 구분
• 이미지 품질 및 해상도
• 제공된 긍정적/부정적 점의 수

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

Link to this section기존 주석을 가져올 수 있습니까?#

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

Link to this section동일한 클래스의 여러 객체를 어떻게 주석 처리합니까?#

주석을 그린 후:

1. 동일한 클래스를 선택된 상태로 유지하십시오
2. 다음 주석을 그리십시오
3. 모든 객체에 라벨이 지정될 때까지 반복하십시오

키보드 단축키 1-9로 클래스를 빠르게 선택할 수 있습니다.

Link to this section부분적으로 주석 처리된 데이터셋으로 학습할 수 있습니까?#

네, 하지만 최상의 결과를 위해서는 다음을 수행하십시오:

• 각 이미지에서 대상 클래스의 모든 객체에 라벨을 지정하십시오
• Annotations 필터를 Unannotated로 설정하여 주석이 필요한 이미지를 식별하십시오
• 라벨이 없는 이미지는 학습에서 제외되며, 라벨이 지정된 이미지만 손실(loss) 계산에 기여합니다

Link to this section어떤 SAM 모델을 사용해야 합니까?#

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

Link to this section어떤 작업이 SAM 스마트 주석을 지원합니까?#

SAM 스마트 주석은 detect, segment, semantic, OBB 작업에서 사용할 수 있습니다. Classification 및 pose 작업은 수동 주석만 사용합니다.

Link to this section포즈 주석을 위한 사용자 지정 스켈레톤 템플릿을 만들 수 있습니까?#

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

Link to this section스켈레톤 템플릿 간에 어떻게 전환합니까?#

주석 툴바의 템플릿 선택기 드롭다운을 클릭하십시오. 기본 제공 템플릿(Person, Hand, Face, Dog, Box) 또는 저장된 사용자 지정 템플릿을 선택하십시오. 선택한 템플릿에 따라 이미지를 클릭할 때 배치되는 키포인트가 결정됩니다.