> 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/workflows/ja/burokku/blocks/visualize-predictions/heatmap-visualization.md).

# ヒートマップ可視化

画像内の検出結果に基づいてヒートマップを描画します。

提供された検出結果に基づいて画像上にヒートマップを描画します。熱は時間とともに蓄積され、ぼかした円の半透明オーバーレイとして描画されます。

## このブロックの仕組み

このブロックは画像と検出予測を受け取り、ヒートマップを描画します。このブロックは:

1. 画像と予測を入力として受け取ります。
2. 検出位置に基づいて熱を蓄積します。
3. 熱を表すぼかした円の半透明オーバーレイを描画します。

## 一般的な使用例

* **密度分析**: シーン内の物体の密度を可視化します。
* **交通監視**: 人通りの多いエリアを特定します。
* **小売分析**: 店舗内の来客動線を分析します。

### タイプ識別子

ステップで次の識別子を使用してください `"type"` フィールド: `roboflow_core/heatmap_visualization@v1` を、ワークフローにステップとして追加します。

### プロパティ

| **名前**       | **型**   | **説明**                                                             | 参照 |
| ------------ | ------- | ------------------------------------------------------------------ | -- |
| `name`       | `str`   | このステップの一意の識別子を入力してください。                                            | ❌  |
| `copy_image` | `bool`  | このオプションを有効にすると、可視化用に入力画像のコピーを作成し、元画像を保持します。複数の可視化を重ねる場合に使用してください.. | ✅  |
| `位置`         | `str`   | ヒートマップの検出に対する相対位置..                                                | ✅  |
| `不透明度`       | `float` | オーバーレイマスクの不透明度。0から1の間です..                                          | ✅  |
| `半径`         | `int`   | ヒート円の半径..                                                          | ✅  |
| `カーネルサイズ`    | `int`   | ヒートマップをぼかすためのカーネルサイズ..                                             | ✅  |
| `上部の色相`      | `int`   | ヒートマップ上部の色相。デフォルトは0（赤）です..                                         | ✅  |
| `下部の色相`      | `int`   | ヒートマップ下部の色相。デフォルトは125（青）です..                                       | ✅  |
| `静止物体を無視`    | `bool`  | True の場合、移動しているオブジェクト（トラッカーIDに基づく）のみがヒートマップに寄与します..                | ✅  |
| `移動閾値`       | `int`   | オブジェクトを移動中とみなすために必要な最小移動量（ピクセル）..                                  | ✅  |

この **参照** この列は、 `workflow` の実行時に利用可能な動的値でプロパティをパラメータ化できる可能性を示します。 *バインディング* の詳細を参照してください。

### 実行時互換性

`ソフト` - ランタイム `hosted_serverless`, `dedicated_deployment`; 実行 `リモート`; 入力 `動画` : ヒートマップの蓄積と静止オブジェクトのフィルタリングは、プロセスメモリ内に動画ごとのトラッキング状態を保持します。ステートレスまたは複数レプリカの HTTP ランタイムでリモートステップ実行を行うと、連続するフレームが異なるワーカープロセスによって処理される場合があるため、ヒート履歴がワーカー間でリセットされたり分割されたりします。安定したフレーム間可視化には、InferencePipeline 内でローカルステップ実行を使用してください。

`ソフト` - 入力 `image` : このブロックは、動画または繰り返しフレームのワークフローからの時間的コンテキストに依存します。静止画像／写真では、追跡、比較、集計、可視化に意味のある履歴がないため、このブロックの利点はほとんど、またはまったくありません。

### 入力および出力バインディング

利用可能な接続は、そのバインディング種別に依存します。 `ヒートマップ可視化` バージョン `v1` に、どのバインディング種別があるか確認してください。

<details>

<summary>入力と出力のバインディング</summary>

* input
  * `image` ([*`image`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/image.md)）：可視化する画像..
  * `copy_image` ([*`boolean`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/boolean.md)）：このオプションを有効にすると、可視化用に入力画像のコピーを作成し、元画像を保持します。複数の可視化を重ねる場合に使用してください..
  * `predictions` (*Union\[*[*`instance_segmentation_prediction`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/instance-segmentation-prediction.md)*,* [*`keypoint_detection_prediction`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/keypoint-detection-prediction.md)*,* [*`object_detection_prediction`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/object-detection-prediction.md)*,* [*`rle_instance_segmentation_prediction`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/rle-instance-segmentation-prediction.md)*]*): 可視化するモデル予測..
  * `メタデータ` ([*`video_metadata`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/video-metadata.md)): 異なる動画ごとに個別の状態を維持するための video\_identifier を含む動画メタデータ..
  * `位置` ([*`string`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/string.md)): ヒートマップの検出に対する相対位置..
  * `不透明度` ([*`float`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/float.md)): オーバーレイマスクの不透明度。0から1の間です..
  * `半径` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)): ヒート円の半径..
  * `カーネルサイズ` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)): ヒートマップをぼかすためのカーネルサイズ..
  * `上部の色相` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)): ヒートマップ上部の色相。デフォルトは0（赤）です..
  * `下部の色相` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)): ヒートマップ下部の色相。デフォルトは125（青）です..
  * `静止物体を無視` ([*`boolean`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/boolean.md)): True の場合、移動しているオブジェクト（トラッカーIDに基づく）のみがヒートマップに寄与します..
  * `移動閾値` ([*`integer`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)): オブジェクトを移動中とみなすために必要な最小移動量（ピクセル）..
* output
  * `image` ([`image`](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/image.md)）：ワークフロー内の画像。

</details>

<details>

<summary>JSON定義の例</summary>

```json
{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/heatmap_visualization@v1",
	    "image": "$inputs.image",
	    "copy_image": true,
	    "predictions": "$steps.object_detection_model.predictions",
	    "metadata": "$inputs.video_metadata",
	    "position": "BOTTOM_CENTER",
	    "opacity": 0.2,
	    "radius": 40,
	    "kernel_size": 25,
	    "top_hue": 0,
	    "low_hue": 125,
	    "ignore_stationary": true,
	    "motion_threshold": 25
	}
```

</details>
