アノテーションエディタ
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サポートされているタスクタイプ
アノテーションエディタは、5つのYOLOタスクタイプすべてをサポートしています。
| タスク | ツール | アノテーションフォーマット |
|---|---|---|
| Detect | 矩形（Rectangle） | バウンディングボックス (x, y, 幅, 高さ) |
| Segment | ポリゴン | ピクセル単位の正確なマスク (ポリゴンの頂点) |
| Pose | キーポイント | スケルトンテンプレート (人物、手、顔、犬、ボックス、カスタム) |
| OBB | 回転ボックス（Oriented Box） | 回転されたバウンディングボックス (4隅) |
| Classify | クラスセレクタ | 画像レベルのラベル |
5つのアノテーションタイプはすべて、各画像上にまとめて保存されます。データセットのアクティブなタスクタイプを切り替えても、既存のアノテーションが失われることはありません。それらは保持され、切り替えると再度表示されます。
タスクの詳細
物体検出
機能: 軸に沿ったバウンディングボックスを使用してオブジェクトとその位置を特定します。
ラベルフォーマット: class_id center_x center_y width height (すべて0〜1に正規化)
例: 0 0.5 0.5 0.2 0.3 — クラス0、(50%, 50%)を中心とし、幅20%、高さ30%
ユースケース: 在庫カウント、交通監視、野生生物検知、セキュリティシステム
インスタンスセグメンテーション
機能: 各オブジェクトインスタンスに対してピクセル単位で正確なマスクを作成します。
ラベルフォーマット: class_id x1 y1 x2 y2 x3 y3 ... (ポリゴンの頂点、0〜1に正規化)
例: 0 0.1 0.1 0.9 0.1 0.9 0.9 0.1 0.9 — 四角形のマスク
ユースケース: 医療画像診断、自動運転車、写真編集、農業分析
姿勢推定
機能: スケルトントラッキングのための身体キーポイントを検出します。
ラベルフォーマット: class_id cx cy w h kx1 ky1 v1 kx2 ky2 v2 ...
- 可視フラグ:
0=ラベルなし、1=ラベルありだが遮蔽されている、2=ラベルありかつ可視
例: 0 0.5 0.5 0.2 0.3 0.6 0.7 2 0.4 0.8 1 — 2つのキーポイントを持つ人物
ユースケース: スポーツ分析、理学療法、アニメーション、ジェスチャー認識
回転バウンディングボックス (OBB)
機能: 角度を考慮したバウンディングボックスで回転したオブジェクトを検出します。
ラベルフォーマット: class_id x1 y1 x2 y2 x3 y3 x4 y4 (4つの角の点、正規化済み)
例: 0 0.1 0.1 0.9 0.1 0.9 0.9 0.1 0.9 — 回転した矩形
ユースケース: 航空画像、文書分析、製造検査、船舶検知
画像分類
機能: 画像全体に単一のラベルを割り当てます。
ラベルフォーマット: フォルダベース — クラス名ごとに整理された画像 (train/cats/, train/dogs/)
ユースケース: コンテンツモデレーション、品質管理、医療診断、シーン認識
導入
画像にアノテーションを付ける方法:
- データセットに移動します
- 画像をクリックしてフルスクリーンビューアを開きます
Editをクリックしてアノテーションモードに入ります- ツールバーからアノテーションツールを選択します
- 画像上にアノテーションを描画します
- 完了したら
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アノテーションモード
エディタにはツールバーから選択できる2つのアノテーションモードがあります:
| モード | 説明 | ショートカット |
|---|---|---|
| 手動 | タスク固有のツールを使ってアノテーションを描画します (全5タスクタイプ) | V |
| スマート | SAMまたはYOLOモデルによる支援付きアノテーション (検知、セグメント、OBBのみ) | S |
手動アノテーションツール
バウンディングボックス (検知)
オブジェクトの周りに長方形を描画します:
- 編集モードに入り、
Drawを選択します - クリックしてドラッグし、長方形を描画します
- 離すとボックスが完成します
- ドロップダウンからクラスを選択します
- 8つの角やエッジのハンドルをドラッグしてサイズを変更します
- 中心をドラッグして移動します
DeleteまたはBackspaceを押して選択したアノテーションを削除します
ポリゴン (セグメント)
正確なポリゴンマスクを描画します:
- 編集モードに入り、
Drawを選択します - クリックして頂点を追加するか、
Shiftを押しながらマウスを動かしてフリーハンドで詳細なポイントを描画します - 最初の頂点をクリックするか、
EnterまたはEscapeを押してポリゴンを閉じます - ドロップダウンからクラスを選択します
- 個々の頂点をドラッグして調整します
- ポリゴン全体をドラッグして移動します
- 頂点をクリックし、
Deleteを押して削除します
キーポイント (ポーズ)
スケルトンテンプレートを使用してポーズをアノテートします。ツールバーからテンプレートを選択し、一度クリックしてすべてのキーポイントを配置した後、個々のキーポイントをドラッグして位置を調整します。
- 編集モードに入り、
Drawを選択します - ツールバーのテンプレートピッカーからスケルトンテンプレートを選択します
- 画像をクリックして、すべてのキーポイントを一度に配置します
- 個々のキーポイントをドラッグして位置を調整します
Enterを押して確定するか、Escapeを押してキャンセルします
組み込みスケルトンテンプレート
エディタには5つの組み込みテンプレートが含まれています:
| テンプレート | Keypoints | 説明 |
|---|---|---|
| 人物 (Person) | 17 | COCO人体ポーズ — 鼻、目、耳、肩、肘、手首、腰、膝、足首 |
| 手 (Hand) | 21 | Ultralytics 手のキーポイント — 手首、親指、人差し指、中指、薬指、小指の関節 |
| 顔 (Face) | 68 | iBUG 300W 顔のランドマーク — 顎、眉毛、鼻、目、口 |
| 犬 (Dog) | 18 | AP-10K 動物ポーズ — 鼻、頭、首、肩、尾の付け根、尾、および4本の脚 (肘、膝、肉球) |
| ボックス (Box) | 4 | 角のキーポイント — 左上、右上、右下、左下 |
カスタムスケルトンテンプレート
任意のポーズ構造用のカスタムテンプレートを作成します：
- テンプレートピッカーの隣にある + ボタンをクリックします
- 必要に応じて Start from... をクリックし、既存のテンプレートのキーポイントと接続を読み込んで開始点とします
- キャンバス上をクリックしてキーポイントを配置します
- 各キーポイントに名前を付け、色をカスタマイズします
- 2つのポイントを選択してキーポイントを接続します（キーポイントを順番に配置すると、接続が自動的に描画されます）
- テンプレートを保存して、データセット全体で再利用できるようにします
カスタムテンプレートはアカウントに保存され、すべてのポーズデータセットで使用可能です。
テンプレートシステムは、手動による順次キーポイント配置に代わるものです。COCOスケルトンのために17回クリックする代わりに、Personテンプレートを選択して1回クリックするだけで、すべてのキーポイントが正しいスケルトンレイアウトに配置されます。その後、ドラッグして特定のポーズに合わせて位置を調整します。
各キーポイントには可視性フラグがあります：0 = ラベルなし、1 = ラベルありだが遮蔽されている、2 = ラベルありで可視。遮蔽されたキーポイント（他のオブジェクトの背後にあるもの）は可視性 1 としてマークする必要があります。モデルはその位置を推論することを学習します。
回転バウンディングボックス (OBB)
角度のあるオブジェクトに対して回転ボックスを描画します：
- 編集モードに入り、
Drawを選択します - クリック＆ドラッグして初期ボックスを描画します
- 回転ハンドルを使用して角度を調整します
- コーナーハンドルをドラッグしてサイズを変更します
- ドロップダウンからクラスを選択します
分類 (Classify)
画像レベルのクラスラベルを割り当てます：
- 編集モードに入ります
- クラス選択ボタンのあるサイドパネルが表示されます
- クラスボタンをクリックするか、数字キー
1-9を押します
スマートアノテーション
スマートアノテーションは、モデル支援によるアノテーションをエディタに追加します。Smartモードでは、Segment Anything Model (SAM) を使用したクリックベースのアノテーションや、学習済みの Ultralytics YOLO モデルおよび自身でファインチューニングした YOLO モデルを使用して予測をアノテーションとして追加できます。スマートアノテーションは detect、segment、および OBB タスクで利用可能です。
SAM スマートアノテーション
SAM モデルを選択した状態：
- 編集モードに入り
Smartを選択するか、Sを押します - アノテーション対象のオブジェクトをクリックします — SAM がリアルタイムで初期マスクを生成します
- 追加のクリックでマスクを調整します：現在のマスクの 外側 をクリックして範囲を追加するか、現在のマスクの 内側 をクリックして領域を削除します
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- オブジェクトの中心をクリックすることから始めます
- マスクの外側を再度クリックして範囲を拡大します
- マスクの内側をクリックして不要な領域を削除します
- ワンクリックアノテーションのために auto-apply (
A) を有効にします - auto-apply がオンの状態で
Shiftを押しながら操作すると、マスクが適用される前に複数のポイントを配置できます - エッジが明確な個別のオブジェクトに対して最も効果的です
- 細長いオブジェクトや重なっているオブジェクトには、何度かクリックして微調整を行います
SAM スマートアノテーションは以下を生成できます：
- ポリゴン (セグメンテーションタスク用)
- バウンディングボックス (検出タスク用)
- 指向性ボックス (OBBタスク用)
SAM スマートアノテーションは detect、segment、および OBB タスクでのみ利用可能です。分類およびポーズタスクには手動アノテーションが必要です。
Auto-apply モード
Auto-apply モードは、クリックごとに SAM マスクを自動保存することでスマートアノテーションを高速化します（Enter を押す必要はありません）。ツールバーの auto-apply ボタンで切り替えるか、A を押してください。
| モード | 動作 |
|---|---|
| Auto-apply オン | クリックごとにマスクが自動的に適用されます |
Auto-apply オン + Shift | 最初に複数のポイントを配置し、ボタンを離すとマスクが適用されます |
| Auto-apply オフ (デフォルト) | 自由にポイントを配置し、Enter を押して適用します |
Auto-apply は、オブジェクトが明確に分離されており、1回のクリックで正確なマスクが生成できるデータセットに最適です。複雑なオブジェクトや重なっているオブジェクトの場合は、auto-apply をオフにし、複数のポジティブ/ネガティブポイントを使用して保存前にマスクを微調整してください。
SAM モデル選択
Smart モードがアクティブな場合、ツールバーにモデルピッカーが表示されます。5つの SAM モデルが利用可能です。データセットに適した速度と精度のトレードオフに基づいて選択してください：
| モデル | サイズ | 速度推定 (Speed) | 備考 |
|---|---|---|---|
| SAM 2.1 Tiny | 75 MB | 最速 | |
| SAM 2.1 Small | 88 MB | 高速 | |
| SAM 2.1 Base | 154 MB | 中速 | |
| SAM 2.1 Large | 428 MB | 低速 | SAM 2.1 で最も高精度 |
| SAM 3 | 3.45 GB | 最も低速 | デフォルト、最新世代 |
Smart モード中にモデルを切り替えると、現在の画像に対する予測器が自動的に再初期化されます。
YOLO スマートアノテーション
YOLO モデルを選択した状態では、スマートアノテーションを使用して、学習済みの Ultralytics モデルや自身でファインチューニングしたモデルからの予測を追加できます。
- 編集モードに入り
Smartを選択するか、Sを押します - ツールバーのモデルピッカーから YOLO モデルを選択します（
OfficialまたはMy Models） Predictをクリックします- 追加されたアノテーションを確認し、必要な修正を行います
- モデルピッカーには、現在のデータセットのタスクと一致するモデルのみが表示されます。
- IoU
0.7以上で既存のアノテーションと重なる重複予測はスキップされます。
クラスサイドバー
アノテーションエディタには、キャンバスの右側に折りたたみ可能なクラスサイドバーが含まれています。サイドバーは以下を提供します：
- クラス検索: 検索フィールドに入力してクラスリストをフィルタリングします。完全一致で
Enterを押すと選択され、一致がない場合は新しいクラスを作成できます。 - クラスのインライン作成: リスト下部の
Add classをクリックし、名前を入力して必要に応じてカスタムカラーを選択します。Enterを押して作成します。 - クラス名のインライン編集: クラス名にカーソルを合わせ、鉛筆アイコンをクリックして名前を変更します。
- カラーピッカー: クラスの隣にあるカラー見本をクリックして色を変更します。
- クラス別アノテーション数: 各クラスの行に、アノテーション数の上付き文字が表示されます。
- 展開/折りたたみ: シェブロンをクリックしてクラスを展開し、その下にある個々のアノテーションを確認します。
- 双方向ホバーハイライト: キャンバス上でアノテーションをホバーするとサイドバー内でハイライトされ、その逆も同様です。サイドバーは関連するクラスまで自動スクロールおよび自動展開されます。
- 個別の注釈の表示/非表示: 注釈の行にある目のアイコンをクリックすると、キャンバス上での表示/非表示を切り替えられます。
- 注釈の削除: 注釈の行にあるゴミ箱アイコンをクリックすると、その注釈を削除できます。
- キーボードショートカット:
1-9キーを押すと、最初の9つのクラスを素早く選択できます。
コンテキストメニュー
選択した注釈を右クリックすると、以下のコンテキストメニューが表示されます。
| アクション | ショートカット |
|---|---|
| 注釈の削除 | Delete / Backspace |
| 最前面へ移動 | Cmd/Ctrl+Shift+] |
| 最背面へ移動 | Cmd/Ctrl+Shift+[ |
| 前面へ移動 | Cmd/Ctrl+] |
| 背面へ移動 | Cmd/Ctrl+[ |
表示設定
表示ドロップダウン（目のアイコン）から、個々の要素の表示を切り替えられます。
| 切り替え | 説明 |
|---|---|
| アノテーション | すべての注釈オーバーレイの表示/非表示 |
| クラスラベル | 注釈のクラス名ラベルの表示/非表示 |
| ピクセル表示 | ズーム確認用のピクセルレンダリング（全画面）の切り替え |
| 十字線 | ピクセル座標を表示する十字カーソルの表示（編集モード） |
| ナビゲーションサムネイル | ナビゲーションサムネイルストリップの表示（全画面） |
| すべて表示 | 注釈、ラベル、十字線、サムネイルを一括で切り替え（ピクセル表示には影響しません） |
十字カーソル
編集モードでは、十字カーソルのオーバーレイがカーソル位置を追跡し、キャンバス上のピクセル座標を表示します。これにより、正確な注釈配置が可能になります。表示ドロップダウンから切り替え可能です。
SAMホバープレビュー
スマートモードでは、SAMがポイントをクリックする前にリアルタイムでホバープレビューを提供します。このプレビューは、detect、segment、OBBタスクで利用可能です。調整用のクリックを追加すると、プレビューが更新され、現在のマスクとアクティブなタスクの注釈タイプが反映されます。
ポリゴン頂点の編集
セグメント注釈では、描画後にポリゴンの頂点を編集できます。
- 頂点の移動: 頂点のハンドルをドラッグして再配置します
- 頂点の削除: 頂点を選択して
Deleteキーを押して削除します
クラス管理
クラスの作成
データセットの注釈クラスを Classes タブで定義します。
Classesタブへ移動します- 下部の入力フィールドにクラス名を入力します
AddをクリックするかEnterキーを押します- Ultralyticsパレットから色が自動的に割り当てられます
注釈中に新しいクラスを追加
エディタを離れることなく、注釈中に直接新しいクラスを作成できます。
- 画像上に注釈を描画します
- クラスのドロップダウンで
Add New Classをクリックします - クラス名を入力します
- Enterキーを押して作成し、割り当てます
これにより、データ内で新しいオブジェクトタイプに遭遇した際に、その場でクラスを定義するシームレスなワークフローが可能になります。
データセット全体のすべてのクラスは、統合されたテーブルで管理されます。クラス名や色の変更は、データセット全体に自動的に反映されます。
クラスの編集
- 名前変更: テーブル内のクラス名をクリックしてインラインで編集します
- 色の変更: カラーパレットをクリックしてカラーピッカーを開きます
- 検索: 検索フィールドを使用してクラス名をフィルタリングします
- 並べ替え: カラムヘッダーをクリックして、名前、ラベル数、または画像数で並べ替えます
クラスの色
各クラスには、Ultralyticsパレットから色が割り当てられます。Classes タブのカラーピッカーを使用して色をカスタマイズできます。色はプラットフォーム全体で一貫しており、認識しやすくなっています。
キーボードショートカット
キーボードショートカットによる効率的な注釈作成：
| ショートカット | アクション |
|---|---|
Cmd/Ctrl+S | 注釈の保存 |
Cmd/Ctrl+Z | 元に戻す |
Cmd/Ctrl+Y | やり直し |
Escape | 保存 / 選択解除 / 終了 |
Delete / Backspace | 選択したアノテーションを削除 |
1-9 | クラス1〜9を選択 |
Cmd/Ctrl+Scroll | ズームイン/アウト |
Cmd/Ctrl++ または Cmd/Ctrl+= | ズームイン |
Cmd/Ctrl+- | ズームアウト |
Cmd/Ctrl+0 | 表示サイズにリセット |
Space+Drag | ズーム時のキャンバスのパン |
Shift+Click | 注釈の複数選択 |
Cmd/Ctrl+A | すべての注釈を選択 |
すべてのショートカットを表示
アノテーションツールバーのキーボードアイコンをクリックすると、ショートカットの参照が開きます。
元に戻す/やり直し
アノテーションエディタは、完全な元に戻す/やり直しの履歴を保持します：
- 元に戻す:
Cmd/Ctrl+Z - やり直し:
Cmd/Ctrl+Y
履歴で追跡される操作：
- アノテーションの追加 (シングルおよびバッチ)
- アノテーションの編集 (移動、サイズ変更、回転)
- アノテーションの削除 (シングルおよびバッチ)
- クラスの変更 (シングルおよびバッチ)
- アノテーションの並べ替え (Zオーダー)
- ポリゴン頂点の編集 (追加、削除、移動)
- キーポイントの移動
元に戻すスタックに固定の制限はありません。現在の編集セッション中に行ったすべての変更を、Editをクリックした時の画像の元の状態まで戻すことができます。
アノテーションの保存
Saveをクリックするか、Cmd/Ctrl+Sを押すとアノテーションが保存されます：
- 保存: 保存ボタンをクリックするか、
Cmd/Ctrl+Sを押します - キャンセル: キャンセルをクリックして変更を破棄します
- Escape: 未保存の変更がある場合は保存し、それ以外の場合は編集モードを終了します
他の画像へ移動する前に、必ず保存してください。保存されていない変更は失われます。
FAQ
SAMアノテーションの精度はどの程度ですか？
SAMはほとんどのオブジェクトに対して高品質なマスクを提供します。精度は以下に依存します：
- 背景からのオブジェクトの際立ち
- 画像の品質と解像度
- 提供されたポジティブ/ネガティブポイントの数
最良の結果を得るには、オブジェクトの中心をクリックすることから始め、次にマスク外をクリックして範囲を追加し、マスク内をクリックして近くのオブジェクトや背景を除外してください。
既存のアノテーションをインポートできますか？
はい、YOLO-format label filesでデータセットをアップロードしてください。プラットフォームが自動的に解析し、エディタに表示します。
同じクラスの複数のオブジェクトにアノテーションを付けるにはどうすればよいですか？
アノテーションを描画した後：
- 同じクラスを選択したままにする
- 次のアノテーションを描画する
- すべてのオブジェクトにラベルが付けられるまで繰り返す
キーボードショートカットの1-9でクラスを素早く選択できます。
部分的にアノテーションされたデータセットでトレーニングできますか？
はい、可能ですが、最良の結果を得るには以下を行ってください：
- 各画像内のターゲットクラスのすべてのオブジェクトにラベルを付ける
- ラベルフィルターを
Unlabeledに設定して、まだアノテーションが必要な画像を特定する - ラベルのない画像はトレーニングから除外され、ラベル付けされた画像のみが損失に寄与します
どのSAMモデルを使用すべきですか？
SAM 3がデフォルトであり、最新世代のモデルです。最高品質のマスクを得るには、ここから始めてください。一般的なオブジェクトに対して高速な対話型ワークフローが必要な場合はSAM 2.1 Smallに切り替え、複雑な形状でより高いマスク精度が必要な場合はSAM 2.1 Largeを使用してください。単純でコントラストの高いオブジェクトで最大速度を得るにはSAM 2.1 Tinyを使用してください。
どのタスクがSAMスマートアノテーションをサポートしていますか？
SAMスマートアノテーションはdetect、segment、OBBタスクで利用可能です。分類およびポーズタスクは手動アノテーションのみを使用します。
ポーズアノテーション用のカスタムスケルトンテンプレートを作成できますか？
はい。スケルトンテンプレートピッカーの横にある**+**ボタンをクリックして、テンプレートエディタを開きます。キーポイントを配置し、名前を付け、接続を描画して保存します。カスタムテンプレートはアカウントに保存され、すべてのポーズデータセットで使用可能です。
スケルトンテンプレートを切り替えるにはどうすればよいですか？
アノテーションツールバーのテンプレートピッカーのドロップダウンをクリックします。組み込みのテンプレート（Person、Hand、Face、Dog、Box）または保存したカスタムテンプレートを選択します。選択したテンプレートによって、画像をクリックしたときに配置されるキーポイントが決まります。