> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ultralytics YOLO

> Ultralytics YOLO モデルで W&B を使用して、実験管理、モデル チェックポイント保存、コンピュータビジョンの可視化を行います。

export const ColabLink = ({url}) => <a href={url} target="_blank" rel="noopener noreferrer" className="colab-link">
    <svg width="20" height="20" viewBox="0 0 24 24" fill="currentColor" xmlns="http://www.w3.org/2000/svg">
      <path d="M14.25.18l.9.2.73.26.59.3.45.32.34.34.25.34.16.33.1.3.04.26.02.2-.01.13V8.5l-.05.63-.13.55-.21.46-.26.38-.3.31-.33.25-.35.19-.35.14-.33.1-.3.07-.26.04-.21.02H8.77l-.69.05-.59.14-.5.22-.41.27-.33.32-.27.35-.2.36-.15.37-.1.35-.07.32-.04.27-.02.21v3.06H3.17l-.21-.03-.28-.07-.32-.12-.35-.18-.36-.26-.36-.36-.35-.46-.32-.59-.28-.73-.21-.88-.14-1.05-.05-1.23.06-1.22.16-1.04.24-.87.32-.71.36-.57.4-.44.42-.33.42-.24.4-.16.36-.1.32-.05.24-.01h.16l.06.01h8.16v-.83H6.18l-.01-2.75-.02-.37.05-.34.11-.31.17-.28.25-.26.31-.23.38-.2.44-.18.51-.15.58-.12.64-.1.71-.06.77-.04.84-.02 1.27.05zm-6.3 1.98l-.23.33-.08.41.08.41.23.34.33.22.41.09.41-.09.33-.22.23-.34.08-.41-.08-.41-.23-.33-.33-.22-.41-.09-.41.09zm13.09 3.95l.28.06.32.12.35.18.36.27.36.35.35.47.32.59.28.73.21.88.14 1.04.05 1.23-.06 1.23-.16 1.04-.24.86-.32.71-.36.57-.4.45-.42.33-.42.24-.4.16-.36.09-.32.05-.24.02-.16-.01h-8.22v.82h5.84l.01 2.76.02.36-.05.34-.11.31-.17.29-.25.25-.31.24-.38.2-.44.17-.51.15-.58.13-.64.09-.71.07-.77.04-.84.01-1.27-.04-1.07-.14-.9-.2-.73-.25-.59-.3-.45-.33-.34-.34-.25-.34-.16-.33-.1-.3-.04-.25-.02-.2.01-.13v-5.34l.05-.64.13-.54.21-.46.26-.38.3-.32.33-.24.35-.2.35-.14.33-.1.3-.06.26-.04.21-.02.13-.01h5.84l.69-.05.59-.14.5-.21.41-.28.33-.32.27-.35.2-.36.15-.36.1-.35.07-.32.04-.28.02-.21V6.07h2.09l.14.01.21.03zm-6.47 14.25l-.23.33-.08.41.08.41.23.33.33.23.41.08.41-.08.33-.23.23-.33.08-.41-.08-.41-.23-.33-.33-.23-.41-.08-.41.08z" />
    </svg>
    Colabで試す
  </a>;

<ColabLink url="https://colab.research.google.com/github/wandb/examples/blob/master/colabs/ultralytics/01_train_val.ipynb" />

[Ultralytics](https://github.com/ultralytics/ultralytics) は、画像分類、物体検出、画像セグメンテーション、姿勢推定といったタスク向けのコンピュータビジョンモデルを提供しています。[YOLOv8](https://docs.ultralytics.com/models/yolov8/) は、リアルタイム物体検出モデルである YOLO シリーズの 1 つのバージョンであり、Ultralytics ではこれに加えて [SAM (Segment Anything Model)](https://docs.ultralytics.com/models/sam/#introduction-to-sam-the-segment-anything-model)、[RT-DETR](https://docs.ultralytics.com/models/rtdetr/)、[YOLO-NAS](https://docs.ultralytics.com/models/yolo-nas/) などのコンピュータビジョンモデルも提供しています。Ultralytics は、API を通じてこれらのモデルをトレーニング、ファインチューニング、適用するための、すぐに使えるワークフローも提供しています。

このページでは、W\&B が実験のメトリクス、モデル チェックポイント、検証画像または推論画像に対する予測を自動的にトラッキングして可視化できるように、W\&B を Ultralytics と統合する方法を説明します。インストール、トレーニングと検証のワークフロー、および推論専用のワークフローについて説明します。

<div id="get-started">
  ## はじめに
</div>

インテグレーションを使用するには、まず `ultralytics` と `wandb` の両方をインストールし、サポートされているバージョンの `ultralytics` を使用していることを確認する必要があります。

`ultralytics` と `wandb` をインストールします。

<Tabs>
  <Tab title="コマンドライン">
    ```shell theme={null}
    pip install --upgrade ultralytics==8.0.238 wandb

    # または
    # conda install ultralytics
    ```
  </Tab>

  <Tab title="ノートブック">
    ```bash theme={null}
    !pip install --upgrade ultralytics==8.0.238 wandb
    ```
  </Tab>
</Tabs>

<Note>
  開発チームは、このインテグレーションを `ultralytics` v8.0.238 以下でテストしました。インテグレーションに関する問題を報告する場合は、`yolov8` タグを付けて [GitHub issue](https://github.com/wandb/wandb/issues/new?template=sdk-bug.yml) を作成してください。
</Note>

両方のパッケージをインストールしたら、次に W\&B を使用して Ultralytics のワークフローをインストルメンテーションできます。

<div id="track-experiments-and-visualize-validation-results">
  ## 実験をトラッキングし、検証結果を可視化する
</div>

<ColabLink url="https://colab.research.google.com/github/wandb/examples/blob/master/colabs/ultralytics/01_train_val.ipynb" />

このセクションでは、[Ultralytics](https://docs.ultralytics.com/modes/predict/) モデルを使用してトレーニング、ファインチューニング、検証を行い、[W\&B](https://wandb.ai/site) を使って実験管理、モデル チェックポイントの保存、モデルのパフォーマンスの可視化を行う一般的なワークフローを紹介します。

インテグレーションの詳細については、[Supercharging Ultralytics with W\&B](https://wandb.ai/geekyrakshit/ultralytics/reports/Supercharging-Ultralytics-with-Weights-Biases--Vmlldzo0OTMyMDI4) を参照してください。

Ultralytics で W\&B インテグレーションを使用するには、`wandb.integration.ultralytics.add_wandb_callback` 関数を import します。このコールバックは、Ultralytics モデルで W\&B のログを登録するエントリポイントです。

```python theme={null}
import wandb
from wandb.integration.ultralytics import add_wandb_callback

from ultralytics import YOLO
```

次に、任意の `YOLO` モデルを初期化し、モデルで推論を実行する前に `add_wandb_callback` 関数を呼び出します。トレーニングの前にコールバックをアタッチすると、各エポックで自動的にログされるようになります。これにより、トレーニング、ファインチューニング、検証、または推論を実行すると、W\&B は experiment のログと画像を自動的に保存し、[コンピュータビジョンタスク向けのインタラクティブ オーバーレイ](/ja/models/track/log/media/#image-overlays-in-tables)を使用してグラウンドトゥルースと対応する予測結果の両方を重ねて表示するとともに、[`wandb.Table`](/ja/models/tables/) に追加のインサイトも保存します。

```python theme={null}
with wandb.init(project="ultralytics", job_type="train") as run:

    # YOLOモデルを初期化する
    model = YOLO("yolov8n.pt")

    # UltralyticsにW&Bコールバックを追加する
    add_wandb_callback(model, enable_model_checkpointing=True)

    # モデルをトレーニング/ファインチューニングする
    # 各エポックの終了時に、検証バッチの予測結果が
    # コンピュータビジョンタスク向けの有益でインタラクティブなオーバーレイとともに
    # W&B 表にログされます
    model.train(project="ultralytics", data="coco128.yaml", epochs=5, imgsz=640)
```

コールバックをアタッチしてトレーニングを開始すると、run からトレーニング メトリクス、モデル チェックポイント、エポックごとの検証の可視化が W\&B project にストリーミングされるようになります。

Ultralytics のトレーニングまたはファインチューニング ワークフロー で W\&B を使用してトラッキングした Experiments は、次のように表示されます:

<blockquote class="imgur-embed-pub" lang="en" data-id="a/TB76U9O"><a href="https://imgur.com/a/TB76U9O">YOLO ファインチューニング Experiments</a></blockquote><script async src="https://s.imgur.com/min/embed.js" charset="utf-8" />

エポックごとの検証結果は、[W\&B Table](/ja/models/tables/) を使用して次のように可視化されます:

<blockquote class="imgur-embed-pub" lang="en" data-id="a/kU5h7W4"><a href="https://imgur.com/a/kU5h7W4">W\&B 検証可視化 Table</a></blockquote><script async src="https://s.imgur.com/min/embed.js" charset="utf-8" />

<div id="visualize-prediction-results">
  ## 予測結果を可視化する
</div>

<ColabLink url="https://colab.research.google.com/github/wandb/examples/blob/master/colabs/ultralytics/00_inference.ipynb" />

このセクションでは、[Ultralytics](https://docs.ultralytics.com/modes/predict/) のモデルを推論に使用し、[W\&B](https://wandb.ai/site) を使って結果を可視化する一般的なワークフローを紹介します。

Google Colab でコードを試すこともできます。[Open in Colab](https://wandb.me/ultralytics-inference)

トレーニングのワークフローと同様に、Ultralytics で W\&B インテグレーションを使用するには、`wandb.integration.ultralytics.add_wandb_callback` 関数を import してください。

```python theme={null}
import wandb
from wandb.integration.ultralytics import add_wandb_callback

from ultralytics.engine.model import YOLO
```

次に、インテグレーションのテスト用に画像をいくつかダウンロードします。静止画、動画、またはカメラソースを使用できます。推論ソースの詳細については、[Ultralytics ドキュメント](https://docs.ultralytics.com/modes/predict/)を参照してください。

```bash theme={null}
!wget https://raw.githubusercontent.com/wandb/examples/ultralytics/colabs/ultralytics/assets/img1.png
!wget https://raw.githubusercontent.com/wandb/examples/ultralytics/colabs/ultralytics/assets/img2.png
!wget https://raw.githubusercontent.com/wandb/examples/ultralytics/colabs/ultralytics/assets/img4.png
!wget https://raw.githubusercontent.com/wandb/examples/ultralytics/colabs/ultralytics/assets/img5.png
```

テスト画像を配置したら、`wandb.init()` を使用して W\&B の [run](/ja/models/runs/) を初期化します。次に、使用する `YOLO` モデルを初期化し、モデルで推論を実行する前に、そのモデルに対して `add_wandb_callback` 関数を呼び出します。これにより、推論を実行すると、W\&B は [コンピュータビジョンタスク向けのインタラクティブ オーバーレイ](/ja/models/track/log/media/#image-overlays-in-tables) を重ねた画像を、追加のインサイトとともに [`wandb.Table`](/ja/models/tables/) へ自動的にログします。

```python theme={null}
# W&B Run を初期化する
with wandb.init(project="ultralytics", job_type="inference") as run:
    # YOLO モデルを初期化する
    model = YOLO("yolov8n.pt")

    # Ultralytics 用の W&B コールバックを追加する
    add_wandb_callback(model, enable_model_checkpointing=True)

    # 予測を実行すると、バウンディングボックスやセグメンテーションマスクの
    # インタラクティブオーバーレイとともに W&B 表へ自動的にログされる
    model(
        [
            "img1.png",
            "img2.png",
            "img4.png",
            "img5.png",
        ]
    )
```

<Note>
  トレーニングまたはファインチューニングのワークフローでは、`wandb.init()` を使って明示的に run を初期化する必要はありません。ただし、コードが予測のみを行う場合は、run を明示的に作成する必要があります。
</Note>

推論を実行すると、W\&B は予測されたバウンディングボックスとセグメンテーションマスクを、インタラクティブなオーバーレイとして W\&B run にログします。

インタラクティブなバウンディングボックスのオーバーレイは、次のように表示されます。

<blockquote class="imgur-embed-pub" lang="en" data-id="a/UTSiufs"><a href="https://imgur.com/a/UTSiufs">WandB Image Overlay</a></blockquote><script async src="https://s.imgur.com/min/embed.js" charset="utf-8" />

詳細は、[W\&B image overlays guide](/ja/models/track/log/media/#image-overlays)を参照してください。

<div id="more-resources">
  ## その他の参考資料
</div>

* [W\&BでUltralyticsをさらに強化する](https://wandb.ai/geekyrakshit/ultralytics/reports/Supercharging-Ultralytics-with-Weights-Biases--Vmlldzo0OTMyMDI4)
* [YOLOv8による物体検出: エンドツーエンドのワークフロー](https://wandb.ai/reviewco/object-detection-bdd/reports/Object-Detection-using-YOLOv8-An-End-to-End-Workflow--Vmlldzo1NTAyMDQ1)
