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

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タスクに対応するアノテーションツールを提供します。

深度のグラウンドトゥルースはアップロードするペアマップであり、描画するものではないため、深度データセットではエディターが読み取り専用で開きます。

タスクの詳細#

はじめに#

画像にアノテーションを付けるには、次の手順を実行します。

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 モードではSAMピッカーや自動適用トグルなしでYOLO姿勢推定モデルのみを提供します。画像分類ではクラスサイドバーを直接使用し、描画ツールバーや Smart ボタンは一切表示されません。

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

描画モードのツール#

バウンディングボックス（Detect）#

オブジェクトの周囲に長方形のボックスを描画します。

1. クラスサイドバーでクラスを選択します
2. デフォルトのDrawモードで、クリックしてドラッグし、長方形を描画します
3. マウスボタンを離してボックスを完成させます

ポリゴン（Segment）#

正確なポリゴンマスクを描画します。

1. クラスサイドバーでクラスを選択します
2. デフォルトのDrawモードでクリックして頂点を追加するか、Shiftを押しながらマウスを動かして密な点をフリーハンドで描画します
3. ダブルクリックするか、最初の頂点をクリックするか、EnterまたはEscapeを押してポリゴンを閉じます

キーポイント（Pose）#

スケルトンテンプレートを使用してPoseにアノテーションを付けます。ツールバーからテンプレートを選択し、1回クリックしてすべてのキーポイントを配置した後、個々のキーポイントをドラッグして位置を調整します。

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 から数字キーを押します

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

スマートアノテーションにより、モデル支援アノテーションがエディターに追加されます。スマートモードでは、クリックベースのアノテーションに セグメント・エニシング・モデル (SAM) を使用するか、事前学習済みの Ultralytics YOLOモデルおよび独自のファインチューニング済みYOLOモデルを使用して予測をアノテーションとして追加できます。SAMスマートアノテーションは detect、segment、semantic、および OBB タスクで利用可能であり、YOLOスマートアノテーションは pose も対象とします。

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スマートアノテーションでは、次を生成できます。

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

自動適用モード#

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

SAMモデルの選択#

スマートモードが有効な場合、ツールバーにモデルピッカーが表示されます。データセットに適した速度と精度のトレードオフに基づいて選択できる6つのSAMモデルが用意されています。

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

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

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

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

一括アノテーション#

一括アノテーションは、開いている画像ではなくデータセット全体に対して1つのYOLOモデルを実行します。データセットページの その他のアクション > 一括アノテーション から開くか、エディターでのYOLO予測後のトーストにある すべての推論 アクションから開きます。これは、深度を除くすべてのタスクにおいて、最大3つの画像チャンネルを持つプラットフォームホスト型のデータセット上のデータセットエディターで利用可能です。

1. ピッカーからモデルを選択します（Official または My Models）。
2. 信頼度（デフォルト 0.25）と IoU（デフォルト 0.7）のスライダーを調整します。スライダーを動かすと、テスト実行 ストリップに、いくつかのサンプル画像上でモデルが検出した内容が表示されます。
3. アノテーション済み画像を含める をオンにすると、すでにラベルが付いている画像に対しても実行され、実行によりモデルが検出した内容が追加され、既存のラベルが維持されます。
4. 推定コスト を確認し、開始 をクリックします。

デフォルトではラベルなしの画像のみがアノテーションされ、既存のラベルが変更されることはありません。実行にはデータセットクラスが必要です。モデルのクラスがデータセットのクラスと異なる場合は、クラスのマップ ステップで各モデルクラスをデータセットクラスにマップするかスキップし、クラスのないデータセットではクラスを作成します。実行はクラスが存在するようになって初めて開始されます。実行を開始すると最初に データセットバージョン が保存されるため、結果が気に入らない場合はデータセットを復元できます。

データセットページには実行の進捗が表示され、停止 をクリックすると、それまでに処理された画像が保持されて課金されます。実行が完了すると、処理された画像、および追加されたアノテーションとクラスを示すサマリーが表示されます。

クラスサイドバー#

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

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

コンテキストメニュー#

選択したアノテーションを右クリックすると、次の項目を含むコンテキストメニューが開きます。

表示コントロール#

表示ドロップダウン（目のアイコン）では、個々の要素の表示を切り替えられます。

十字線カーソル#

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

SAMホバープレビュー#

Smartモードでは、SAMが任意のポイントをクリックする前にリアルタイムのホバープレビューを提供します。このプレビューは detect、segment、semantic、OBB タスクで利用できます。調整用のクリックを追加すると、アクティブなタスクの現在のマスクとアノテーションタイプを反映してプレビューが更新されます。

ポリゴン頂点の編集#

segmentアノテーションでは、描画後にポリゴンの頂点を編集できます。

• 頂点を移動: 任意の頂点ハンドルをドラッグして位置を変更します
• 頂点を削除: 頂点を選択し、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-order）
• ポリゴン頂点の編集（追加、削除、移動）
• キーポイントの移動

アノテーションの保存#

最後のアノテーション編集から1秒後に、変更が自動的に保存されます。また、別の画像に移動したときや、フルスクリーンエディターを閉じたときにも保存されます。

• 今すぐ保存: 保存ボタンをクリックするか、Cmd/Ctrl+S を押します
• 閉じる: 閉じるボタンをクリックするか、画像の外側をクリックするか、Escape を押します。閉じると、保留中の変更がバックグラウンドで保存されます

FAQ#