> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/datasets/ja/bjon/dataset-health-check.md).

# データセット健全性チェック

データセットの品質を評価し、改善します。

## 概要

Dataset Health Check では、プロジェクトに関連付けられたデータセットのさまざまな統計情報を確認できます。以下の情報が表示されます。

* データセット内の画像数。
* アノテーション数。
* 画像の平均サイズ。
* 画像のアスペクト比の中央値。
* アノテーションが欠落している画像の数。
* null アノテーションの数。
* データセット内の画像の寸法。
* オブジェクト数のヒストグラム。
* アノテーション位置のヒートマップ。

Dataset Health Check を使うと、データセットについてさまざまな知見を得られます。たとえば、null アノテーションがない場合は、取り組んでいるプロジェクトに応じていくつか追加することを検討できます。アノテーションが欠落している画像がある場合は、詳細を確認し、必要なアノテーションを追加できます。

プロジェクトのヘルスチェックを表示するには、Dataset ページを開き、「Health Check」タブをクリックします。

<figure><img src="https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-088e5e12e4a8d3196e187a5b4d97bffb73d7cc9a%2FScreenshot%202025-05-19%20at%2011.49.32.png?alt=media" alt=""><figcaption></figcaption></figure>

Health Check タブが開きます。

<figure><img src="https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-4dab0946c168b9f6f769eeba3e07ae10e075b2c8%2FScreenshot%202025-05-19%20at%2011.51.10.png?alt=media" alt=""><figcaption></figcaption></figure>

このページでは、次の情報を確認できます。

* train、test、valid の各データセットに含まれる画像のクラス数の内訳。
* データセット内の画像サイズとアスペクト比の概要。
* アノテーションが多く存在する場所を示すヒートマップ。
* データセット内の各画像でアノテーションされているクラス数を示すヒストグラム。

## Webアプリ

### 画像寸法の分析

「画像寸法の分析」セクションでは、データセット内の元画像のサイズとアスペクト比について説明します。

プロジェクトのバージョンを作成する際に Resize 拡張を適用すると（ほとんどすべてのユースケースで強く推奨します）、バージョン内の画像はリサイズされますが、元画像はそのまま維持されます。

<figure><img src="https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-3382cff7ff266fe2c67869601c806f74e9819e7f%2FScreenshot%202025-06-09%20at%2011.38.21.webp?alt=media" alt=""><figcaption></figcaption></figure>

### アノテーションのヒートマップ

モデルをトレーニングする際は、データセットがモデルのデプロイ先の環境を適切に反映していることが重要です。

カメラのフレーム内のどこにでもアノテーション対象が現れる環境にモデルをデプロイする場合は、画像内のさまざまな位置に現れるオブジェクトをアノテーションすることが重要です。たとえば、さまざまなサイズのオブジェクトがリアルタイムで移動する工場のラインや、スマートフォンで撮影したオブジェクトの画像などが該当します。

画像内のさまざまな場所にあるオブジェクトにラベルを付けることで、モデルが特定の場所にあるオブジェクトの識別方法だけを学習する過学習を防げます。

アノテーションのヒートマップは、画像内のアノテーションが多い場所と少ない場所を示します。データセットのアノテーションが特定の場所に偏りすぎている状況を特定するのに役立ちます。

<figure><img src="https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-e2b93242f6a34898ac5f12ed79be48e3e9531e35%2FScreenshot%202025-06-09%20at%2011.40.13.png?alt=media" alt=""><figcaption></figcaption></figure>

ヒートマップ上の範囲をドラッグすると、選択した範囲に該当する画像を表示できます。

<figure><img src="https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-6148d58b35b272cd092604e6902d9bdefd04809b%2FScreenshot%202025-06-09%20at%2011.45.20.png?alt=media" alt=""><figcaption></figcaption></figure>

### 画像ごとのオブジェクト数のヒストグラム

各画像にアノテーションされたオブジェクトがいくつ含まれているか、その分布を示します。

モデルに入力する画像に、オブジェクトが複数含まれる場合があるなら、オブジェクトのインスタンス数が異なる画像をデータセットに含めることをおすすめします。これにより、注目するオブジェクトがない画像、1つある画像、複数ある画像に対して、モデルが適切に汎化できるようになります。

ヒストグラムの例を以下に示します。

<figure><img src="https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-f6bdf31894a57af06ca4b95039e6c4fb05959f26%2FScreenshot%202025-06-09%20at%2011.49.58.png?alt=media" alt=""><figcaption></figcaption></figure>

ヒストグラムの任意の棒を選択すると、指定した数のオブジェクトを含む画像を表示できます。

<figure><img src="https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-6d725d3e00ff97b2371621d135290cf026cc8006%2FScreenshot%202025-06-09%20at%2011.50.30.webp?alt=media" alt=""><figcaption></figcaption></figure>

## HTTP API

API は Health Check タブと同じ件数、クラスのバランス、オブジェクト数のヒストグラムを返しますが、ヒートマップと画像寸法は含まれません。プロジェクトの最初のレポート、または `regenerate=true`を指定してリクエストしたレポートは、リクエスト中に生成されるため、大規模なデータセットでは数分かかることがあります。それ以降の呼び出しでは保存済みのレポートが返されますが、最新の変更が反映されていない場合があります。現在の数値が必要な場合は、 `generated`を確認し、 `regenerate=true` を渡してください。

{% openapi src="/files/73b4191aee6bb1511d38af399d1b6a01a6a36b48" path="/{workspace}/{project}/health" method="get" %}
[dataset-health-check.yaml](https://2416768182-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVfRxNsvCh4GOyqrjmzX%2Fuploads%2Fgit-blob-2b42cf2015d696b256144fe462289cfec2f66bbe%2Fdataset-health-check.yaml?alt=media)
{% endopenapi %}

## Roboflow Agent

プロジェクトの状態について [Roboflow Agent](https://docs.roboflow.com/agents/roboflow-agent) に質問できます（例: 「モデルが小さなオブジェクトを見逃すのはなぜですか？」）。Agent は保存済みのレポートを読み、サンプル画像を確認し、調査結果を裏付けるグラフを表示します。レポートがない場合や古くなっている場合は、Agent に更新を依頼してください。更新はバックグラウンドで実行され、完了すると Agent が新しいレポートを読み込みます。

## MCP Server

AI エージェントを [MCP Server](https://docs.roboflow.com/agents/mcp-server) に接続すると、次のツールでデータセットの状態を確認できます。

<table data-search="false"><thead><tr><th width="290">ツール</th><th>説明</th></tr></thead><tbody><tr><td><code>projects_health</code></td><td>プロジェクトのデータセットのヘルスチェックを取得します。</td></tr></tbody></table>
