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

# YOLOv5

> YOLOv5 に組み込まれた 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>
    Try in Colab
  </a>;

<ColabLink url="https://colab.research.google.com/github/wandb/examples/blob/master/colabs/yolo/Train_and_Debug_YOLOv5_Models_with_Weights_%26_Biases_.ipynb" />

[Ultralytics' YOLOv5](https://www.ultralytics.com/yolo) ("You Only Look Once") モデルファミリーは、畳み込みニューラルネットワークを用いてリアルタイムの物体検出を実現します。

[W\&B](https://wandb.com) は YOLOv5 と直接統合されており、実験のメトリクスのトラッキング、モデルとデータセットのバージョン管理、モデルの予測結果の高度な可視化などの機能を提供します。**YOLO の実験を実行する前に、`pip install` を 1 回実行するだけで利用できます。**

<Note>
  W\&B のすべてのログ機能は、[PyTorch DDP](https://pytorch.org/tutorials/intermediate/ddp_tutorial.html) などのデータ並列マルチ GPU トレーニングで利用可能です。
</Note>

<h2 id="track-core-experiments">
  コア実験をトラッキングする
</h2>

まず、YOLOv5 と一緒に W\&B Python SDK (`wandb`) をインストールし、通常どおりトレーニングを実行してください。`wandb` をインストールすると、W\&B に組み込まれた[ログ機能](/ja/products/wandb/track/log)が有効化され、システムメトリクス、モデルのメトリクス、メディアがインタラクティブな[ダッシュボード](/ja/products/wandb/track/workspaces)にログされます。

```bash theme={"system"}
pip install wandb
git clone https://github.com/ultralytics/yolov5.git
python yolov5/train.py  # 小規模なデータセットで小さなネットワークをトレーニングする
```

W\&B が標準出力に表示するリンクを開いてください。

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/yolov5_experiment_tracking.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=d93e6f498a7f8236e22b069ebc8c8f8a" alt="YOLOv5 のトレーニングメトリクスとシステムチャートが表示された W&B ダッシュボード。" width="2228" height="2572" data-path="products/wandb/_media/yolov5_experiment_tracking.png" />
</Frame>

<h2 id="customize-the-integration">
  インテグレーションをカスタマイズする
</h2>

実験管理ができるようになったら、YOLO にいくつかのコマンドライン引数を渡すことで、モデルやデータセットのバージョン管理、予測の可視化といった W\&B の追加機能を有効にできます。

* `--save_period` に数値を指定すると、W\&B は `save_period` エポックごとの終了時に [モデルのバージョン](/ja/products/registry) を保存します。このバージョンにはモデルの重みが含まれ、検証セットで最も性能の高いモデルにタグが付けられます。
* `--upload_dataset` フラグを有効にすると、バージョン管理のためにデータセットもアップロードされます。
* `--bbox_interval` に数値を指定すると、データの可視化が有効になります。W\&B は `bbox_interval` エポックごとの終了時に、検証セットに対するモデルの出力をアップロードします。

<Tabs>
  <Tab title="モデルのバージョン管理のみ">
    ```bash theme={"system"}
    python yolov5/train.py --epochs 20 --save_period 1
    ```
  </Tab>

  <Tab title="モデルのバージョン管理とデータの可視化">
    ```bash theme={"system"}
    python yolov5/train.py --epochs 20 --save_period 1 \
      --upload_dataset --bbox_interval 1
    ```
  </Tab>
</Tabs>

<Note>
  すべての W\&B アカウントで、データセットとモデル用に 100 GB の無料ストレージを利用できます。
</Note>

実際の表示例は次のとおりです。

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/yolov5_model_versioning.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=7ded6e99ba12fc48d616e1b40d5e0d2b" alt="モデルのバージョン管理" width="803" height="328" data-path="products/wandb/_media/yolov5_model_versioning.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/wandb/_media/yolov5_data_visualization.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=62be1027f2613749434d1fb7bfc82e5d" alt="データの可視化" width="1277" height="736" data-path="products/wandb/_media/yolov5_data_visualization.png" />
</Frame>

<Note>
  データとモデルのバージョン管理を使用すると、一時停止した実験やクラッシュした実験を、セットアップせずにどのデバイスからでも再開できます。詳細は [Colab](https://wandb.me/yolo-colab) を参照してください。
</Note>


## Related topics

- [インテグレーションの概要](/ja/products/wandb/integrations.md)
