アノテーションエディタ#

Ultralytics Platformには、バウンディングボックス、ポリゴン、キーポイント、回転ボックス、分類を使用して画像にラベル付けするためのアノテーションエディターが含まれています。このエディターは、手動描画、SAMを活用したスマートアノテーション、および互換性のあるYOLOモデルからの予測をサポートしています。

graph TB
    subgraph Draw["Draw Mode"]
        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タスクタイプすべてをサポートしています。

タスクの詳細#

はじめに#

画像のアノテーション手順:

1. データセットに移動します
2. 画像を1回クリックすると、全画面アノテーションエディターが開きます
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 を使用します。分類ではクラスサイドバーを直接使用するため、描画ツールバーは表示されません。

現在、接続されたデータセットではスマートアノテーションを利用できません。

描画モードのツール#

バウンディングボックス (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. 2つのポイントを選択してキーポイントを接続します（順次キーポイントを配置すると、接続は自動的に描画されます）
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 モード#

Auto-apply モードは、クリックのたびに SAM マスクを自動保存することでスマートアノテーションを高速化します（Enter を押す必要はありません）。ツールバーの auto-apply ボタンで切り替えるか、A を押してください。

SAM モデルの選択#

スマートモードがアクティブな場合、ツールバーにモデル選択ツールが表示されます。5種類の SAM モデルが利用可能です。データセットに適した速度と精度のトレードオフに基づいて選択してください：

Smartモードが有効な状態でモデルを切り替えると、現在の画像の予測器が自動的に再初期化されます。

YOLO スマートアノテーション#

YOLO モデルを選択した状態で、スマートアノテーションは、学習済みの Ultralytics モデルまたは自身でファインチューニングしたモデルからの予測を追加できます。

1. Smart を選択するか、S を押します
2. ツールバーのモデル選択ツールから YOLO モデルを選択します（Official または My Models）
3. Predict をクリックします
4. 追加されたアノテーションを確認し、必要な修正を行います

クラスサイドバー#

アノテーションエディターには、キャンバスの右側に折りたたみ可能なクラスサイドバーが含まれています。サイドバーでは以下の機能を提供します。

• クラスの検索: 検索フィールドに入力してクラスリストをフィルタリングします。完全一致を選択するにはEnterを押すか、一致がない場合は新しいクラスを作成してください。
• インラインでの新しいクラス作成: リストの下部にあるAdd classをクリックし、名前を入力して、必要に応じてカスタムカラーを選択します。Enterを押すと作成されます。
• インラインでクラス名を編集: クラス名の上にマウスを合わせ、鉛筆アイコンをクリックして名前を変更します。
• カラーピッカー: クラスの横にあるカラー見本をクリックして、その色を変更します。
• クラスごとのアノテーション数: 各クラスの行には、アノテーションの数が上付き文字で表示されます。
• 展開/折りたたみ: シェブロンをクリックしてクラスを展開し、その下にある個々のアノテーションを表示します。
• 双方向ホバーハイライト: キャンバス上のアノテーションにマウスを合わせるとサイドバーでハイライトされ、その逆も同様です。サイドバーは関連するクラスへ自動的にスクロールします。
• 個々のアノテーションの非表示/表示: アノテーション行の目アイコンをクリックして、キャンバス上の表示を切り替えます。
• アノテーションを削除: アノテーション行のゴミ箱アイコンをクリックして削除します。
• キーボードショートカット: 1-9を押すと、最初の9つのクラスを素早く選択できます。

コンテキストメニュー#

選択したアノテーションを右クリックして、以下のコンテキストメニューを開きます。

表示コントロール#

表示ドロップダウン（目アイコン）を使用して、個々の要素の表示を切り替えることができます。

十字カーソル#

アノテーション中、十字線のオーバーレイがカーソルの位置を追跡し、キャンバスにピクセル座標を表示します。これにより、精度よくアノテーションを配置できます。表示ドロップダウンから切り替えることができます。

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)#

SAMアノテーションの精度はどの程度ですか？#

SAMはほとんどのオブジェクトに対して高品質なマスクを提供します。精度は以下に依存します：

• 背景とオブジェクトの区別
• 画像の品質と解像度
• 提供された正/負のポイントの数

最良の結果を得るには、まずオブジェクトの中心をクリックし、次にマスク外をクリックしてカバレッジを追加し、マスク内をクリックして近くのオブジェクトや背景を除去してください。

既存のアノテーションをインポートできますか？#

はい。データセットをYOLO形式のラベルファイルでアップロードしてください。プラットフォームが自動的に解析し、エディタに表示します。

同じクラスの複数のオブジェクトをアノテーションするにはどうすればよいですか？#

アノテーションを描画した後：

1. 同じクラスを選択したままにする
2. 次のアノテーションを描画する
3. すべてのオブジェクトにラベルが付けられるまで繰り返す

キーボードショートカットの1-9でクラスを素早く選択できます。

部分的にアノテーションされたデータセットで学習できますか？#

はい。ただし最良の結果を得るには：

• 各画像内の対象クラスのすべてのオブジェクトにラベルを付ける
• AnnotationsフィルターをUnannotatedに設定して、アノテーションが必要な画像を特定する

どのSAMモデルを使用すべきですか？#

SAM 3がデフォルトであり、最新世代のモデルです。最高品質のマスクを得るために、まずはこれを使用してください。一般的なオブジェクトでより高速なインタラクティブワークフローを実現するにはSAM 2.1 Smallに切り替え、複雑な形状でより高いマスク精度が必要な場合はSAM 2.1 Largeを使用してください。単純で高コントラストなオブジェクトで最大の速度を得るにはSAM 2.1 Tinyを使用してください。

どのタスクがSAMスマートアノテーションをサポートしていますか？#

SAMスマートアノテーションは、detect、segment、semantic、およびOBBタスクで利用可能です。分類（classification）およびポーズ（pose）タスクは手動アノテーションのみを使用します。

ポーズアノテーション用にカスタムのスケルトンテンプレートを作成できますか？#

はい。スケルトンテンプレートピッカーの横にある**+**ボタンをクリックしてテンプレートエディタを開きます。キーポイントを配置し、名前を付け、接続を描画して保存します。カスタムテンプレートはアカウントに保存され、すべてのポーズデータセットで使用可能です。

スケルトンテンプレートを切り替えるにはどうすればよいですか？#

アノテーションツールバーのテンプレートピッカーのドロップダウンをクリックします。組み込みのテンプレート（Person、Hand、Face、Dog、Box）または保存したカスタムテンプレートを選択してください。選択したテンプレートによって、画像をクリックしたときに配置されるキーポイントが決まります。