> 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/anomaly-heatmap-visualization.md).

# 異常ヒートマップの可視化

異常検知モデルの異常マップをヒートマップとして画像上に重ねます。

ある対象の異常マップを描画する **異常検出モデル** （PatchCore または FoundAD）を、その計算元の画像上に重ねるため、モデルが正常だと学習したものから外れる画像の部分が明るく表示されます。

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

1. 画像とモデルの `anomaly_map` と `anomaly_threshold` を入力として受け取ります
2. マップ（ネットワークの正方形入力解像度で提供されるもの）を画像上に拡張します
3. 各マップ値を、しきい値を基準点とした固定スケールに配置します： `t = value / (value + threshold)`そのため、0 は透明になり、しきい値はランプの中央に位置し、証拠が増えるにつれてランプは飽和します
4. 選択した `color_map` そして選択した `opacity`

スケールはモデルのしきい値のみに依存し、画像には依存しません。そのため、同じ色はどのフレームでも同じ証拠を意味し、正常画像にもマップが表示されます。デフォルトの `ROBOFLOW` ランプは、Roboflow アプリがモデルプレビューで描画する黄色から赤へのランプで、証拠が低い部分では透明になります。OpenCV のランプ（`JET`, `TURBO`, `INFERNO`, `VIRIDIS`, `HOT`）は同じスケール上の不透明なカラーマップです。透過表示するには `opacity` それらを通して画像を見ることができます。

モデルブロックの `anomaly_decision_threshold` 出力を渡すと、ランプの中央がブロックの判定（そのしきい値と `confidence`）; デフォルトの信頼度 0.5 では、それは `anomaly_threshold`.

## 一般的な使用例

* **欠陥の局所化**：異常部分が正常とどこが異なるかを作業者に示す
* **モデルレビュー**：モデルが反応するものをラベル付き欠陥と比較する
* **レポートとアラート**：ヒートマップを通知やデータセットのアップロードに添付する

## 他のブロックへの接続

注釈付き画像は、他の可視化ブロック（たとえば Classification Label Visualization を使って判定を上部に表示するもの）、データ保存ブロック、webhook や通知ブロック、または動画出力に接続できます。

### タイプ識別子

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

### プロパティ

| **名前**              | **型**   | **説明**                                                                                               | 参照 |
| ------------------- | ------- | ---------------------------------------------------------------------------------------------------- | -- |
| `name`              | `str`   | このステップの一意の識別子を入力してください。                                                                              | ❌  |
| `copy_image`        | `bool`  | このオプションを有効にすると、可視化用に入力画像のコピーを作成し、元画像を保持します。複数の可視化を重ねる場合に使用してください..                                   | ✅  |
| `anomaly_threshold` | `float` | 色のランプの基準となる生の異常スコア。ランプの中央に対応します。モデルブロックの anomaly\_decision\_threshold 出力を接続して、ランプがブロックの判定に従うようにします。。 | ✅  |
| `color_map`         | `str`   | ヒートマップのカラーバー。ROBOFLOW は Roboflow アプリの黄色から赤へのランプで、証拠が低い部分では透明です。その他は不透明な OpenCV のカラーマップです。。           | ✅  |
| `opacity`           | `float` | ヒートマップのオーバーレイの不透明度。0.0（不可視）から 1.0（ランプ本来の透明度のみ）まで。。                                                   | ✅  |

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

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

利用可能な接続は、そのバインディング種別に依存します。 `異常ヒートマップの可視化` バージョン `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)）：このオプションを有効にすると、可視化用に入力画像のコピーを作成し、元画像を保持します。複数の可視化を重ねる場合に使用してください..
  * `anomaly_map` ([*`numpy_array`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/numpy-array.md)）：異常検出モデルブロックからの異常マップ。ネットワーク入力解像度での生の局所的な異常証拠..
  * `anomaly_threshold` ([*`float`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/float.md)）：色のランプの基準となる生の異常スコア。ランプの中央に対応します。モデルブロックの anomaly\_decision\_threshold 出力を接続して、ランプがブロックの判定に従うようにします。。
  * `color_map` ([*`string`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/string.md)）：ヒートマップのカラーバー。ROBOFLOW は Roboflow アプリの黄色から赤へのランプで、証拠が低い部分では透明です。その他は不透明な OpenCV のカラーマップです。。
  * `opacity` ([*`float_zero_to_one`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/float-zero-to-one.md)）：ヒートマップのオーバーレイの不透明度。0.0（不可視）から 1.0（ランプ本来の透明度のみ）まで。。
* 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/anomaly_heatmap_visualization@v1",
	    "image": "$inputs.image",
	    "copy_image": true,
	    "anomaly_map": "$steps.anomaly_model.anomaly_map",
	    "anomaly_threshold": "$steps.anomaly_model.anomaly_decision_threshold",
	    "color_map": "ROBOFLOW",
	    "opacity": 0.75
	}
```

</details>
