# Annotation Groups

annotation group は、プロジェクト内のすべての class を包含するカテゴリです。これは次の問いに答えるものです。 **「この dataset ではどのような種類のものがラベル付けされていますか？」**

すべての project には annotation group があります。同じ annotation group を共有する project は、class list と annotations も共有するため、画像を複製することなく、複数の project 間でラベル付け済みデータを再利用できます。

### Annotation Groups が重要な理由

同じ画像でも、何を検出しようとしているかによって異なる方法で annotation できます。たとえば、チェス盤の画像には次のようなラベルを付けられます。

* **チェスの駒** （pawn、knight、bishop、rook、queen、king）を 1 つの project で
* **ボードゲーム** （chess、checkers、backgammon）を別の project で

<figure><img src="https://3740591140-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2FlAGSeaI1gnhq9XVs0BY4%2Fchess-two-ways.jpg?alt=media&#x26;token=6c016ca7-3a5e-44d8-bf70-729756dc8998" alt=""><figcaption></figcaption></figure>

これら 2 つの project は異なるカテゴリのものを表しているため、annotation group も異なります。各 project は共有画像に対して独自の annotations セットを維持し、その画像は使用量として 1 回だけカウントされます。

複数の project が同じ annotation group を共有している場合、ある project で行われた annotation の変更は他の project にも反映されます。これは、ラベル付け済み画像の共通プールから特化した dataset を構築したい場合に便利です。

### Shared Annotations の設定

project を作成する際、他の project と annotations を共有するよう選択できます。

1. チェックを入れます **「Share image annotations with other projects」** を project 作成中に。
2. annotation group フィールドで、自動補完の候補から既存の annotation group を選択するか、新しい名前を入力して作成します。
3. この project に追加された画像のうち、同じ annotation group を持つ他の project にも存在するものは、その annotations を共有します。

shared annotations を有効にしない場合、その project には自動的に一意の annotation group が割り当てられます。project の annotation group は、後で project settings から変更できます。

{% hint style="warning" %}
project 間で annotations を共有すると、ある project で annotation を編集または削除した際に、同じ annotation group 内の他のすべての project にも影響します。shared annotations を有効にする前に、チームがこれを認識していることを確認してください。
{% endhint %}

### Shared Annotations の識別

共有 annotations を識別するには、画像または project 上のチェーンリンクアイコン 🔗 を探してください

* The **annotation tool**、画像の横
* The **asset library**、画像プレビュー上
* **projects** 同じ annotation group を共有するものは、別の場所では project list にそれとともに表示されます

<figure><img src="https://3740591140-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2FeVP4x0BWUia3G2JmmbV8%2Fimage.png?alt=media&#x26;token=1c080673-1a75-46fb-bde0-d84e3e167c20" alt="Project listing with annotation group tooltip"><figcaption><p>shared annotation group のアイコンと tooltip を表示した Project listing</p></figcaption></figure>

<figure><img src="https://3740591140-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2Fwr703R6RafjHvCyDdThT%2FCleanShot%202026-04-06%20at%2011.13.03.png?alt=media&#x26;token=3e6a87ce-dab5-4aa6-9bdc-95d7e6f838ef" alt="Annotation tool with annotation group tooltip"><figcaption><p>shared アイコンと tooltip を表示した Annotation Tool</p></figcaption></figure>

チェーンリンクアイコンにカーソルを合わせると、その画像を共有している他の project を一覧表示する tooltip が表示されます。これにより、annotation を変更する前に、その影響範囲を把握できます。
