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アノテーションモード#

エディタには、ツールバーから選択可能な2つのアノテーションモードがあります:

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. 2つのポイントを選択してキーポイントを接続します（シーケンシャルにキーポイントを配置すると、接続は自動的に描画されます）
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 スマートアノテーションでは以下を生成できます：

• セグメンテーションタスク用の ポリゴン
• 検出タスク用の バウンディングボックス
• OBB タスク用の 回転バウンディングボックス

Link to this section自動適用（Auto-Apply）モード#

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

Link to this sectionSAM モデルの選択#

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

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

Link to this sectionYOLO Smartアノテーション#

YOLOモデルを選択すると、Smartアノテーションを使用して、事前学習済みのUltralyticsモデルまたは独自のファインチューニング済みモデルからの予測を追加できます。

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

Link to this sectionクラスサイドバー#

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

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

Link to this sectionコンテキストメニュー#

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

Link to this section表示設定#

表示ドロップダウン（目アイコン）を使用して、各要素の表示を切り替えます：

Link to this section十字線カーソル#

編集モードでは、十字線オーバーレイがカーソル位置を追跡し、キャンバス上にピクセル座標を表示します。これは正確な位置にアノテーションを配置するのに役立ちます。表示ドロップダウンから切り替えることができます。

Link to this sectionSAMホバープレビュー#

Smartモードでは、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 New 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-order)
• ポリゴン頂点の編集（追加、削除、移動）
• キーポイントの移動

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部分的にアノテーションされたデータセットで学習できますか？#

はい、可能ですが、最良の結果を得るためには：

• 各画像内の対象クラスのすべてのオブジェクトにラベルを付ける
• ラベルフィルタをUnlabeledに設定して、まだアノテーションが必要な画像を特定する
• 未ラベルの画像は学習から除外され、ラベル付きの画像のみが損失に寄与します

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）または保存済みのカスタムテンプレートを選択します。選択したテンプレートによって、画像をクリックしたときに配置されるキーポイントが決まります。