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

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. 画像を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 が使用されます。Smart ボタンが表示されますが、無効化されており「Coming Soon」とマークされます。分類ではクラスサイドバーが直接使用され、描画ツールバーや Smart ボタンは一切表示されません。

スマートアノテーションは現在、クラウドまたはオンプレミスストレージにバックアップされた接続済みデータセットでは利用できません。

描画モードのツール#

バウンディングボックス (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 モード#

自動適用モードでは、各クリック後にSAMマスクが自動的に保存されるため、スマートアノテーションが高速化されます。Enter を押す必要はありません。ツールバーの自動適用ボタンで切り替えるか、A を押します。

SAM モデルの選択#

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

スマートモードがアクティブな状態でモデルを切り替えると、現在の画像の予測器が自動的に再初期化されます。

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

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

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

クラスサイドバー#

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

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