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

# グリッド可視化

複数の画像をグリッドレイアウトに配置し、画像のリストを自動的に正方形グリッドに整理して、サイズを自動調整しながらセル単位で配置することで、並べて比較したり、サムネイル表示や一括可視化に利用できます。

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

このブロックは画像のリストを受け取り、それらを1つの出力画像内でグリッドレイアウトに配置します。このブロックは次のとおりです。

1. 画像のリストと出力サイズ（幅と高さ）を入力として受け取ります
2. 画像の数に基づいてグリッドサイズを計算します（画像数の平方根を切り上げた寸法の正方形グリッドを作成します）
3. 出力キャンバスをグリッドサイズに基づいて同じ大きさのセルに分割します
4. 各入力画像をアスペクト比を維持したまま割り当てられたセルに収まるようにリサイズします（画像は歪みなくセルの寸法に収まるように縮小・拡大されます）
5. 画像を左上から順に配置し、左から右へ、上から下へ埋めていきます（行優先順）
6. リサイズした各画像をセルの中央に配置し、均等に間隔の空いたグリッドレイアウトを作成します
7. グリッドに配置されたすべての入力画像を含む1つの出力画像を返します

このブロックは複数の画像を自動的にグリッドに整理し、簡単に比較したり一括表示したりできます。各画像はアスペクト比を保ったままグリッドのセルに収まるようにリサイズされ、画像はセル内で中央揃えされます。グリッドの寸法は自動的に計算され、ほぼ正方形のグリッドになります（例: 4枚の画像 = 2x2、9枚の画像 = 3x3、10枚の画像 = 4x4）。これにより、複数画像の比較、サムネイル表示、一括可視化出力の作成に最適な、コンパクトで整理されたレイアウトが実現します。同じ画像を再利用する場合、このブロックはキャッシュを使用して性能を最適化します。

## 一般的な使用例

* **バッチ画像比較**：複数の画像をグリッド上で横並びに配置して比較しやすくし、異なるモデル、時点、または処理ステップの結果を同時に可視化できます
* **サムネイルギャラリーの作成**：画像のコレクションからサムネイルグリッドを作成し、ギャラリー表示、画像ブラウザ、または複数画像をコンパクトに表示する必要があるプレビュー画面に利用できます
* **複数画像ワークフローの結果**：バッチ処理、画像スライサーの出力、バッファコレクションなどの複数画像ワークフローの結果を、概要把握用に整理されたグリッド形式で表示します
* **ビフォー／アフター比較**：ビフォー画像とアフター画像、元画像と処理後画像、または複数のワークフロー出力をグリッドに配置して、比較や検証のワークフローに利用します
* **時系列可視化**：異なる時点、フレーム、またはスナップショットの画像をグリッドに表示し、時間的な変化、連続性、進行を可視化します
* **品質管理とレビュー**：複数の画像をまとめて評価や検証のために確認する必要がある品質管理ワークフロー、バッチレビュー、検査プロセス向けにグリッドレイアウトを作成します

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

このブロックのグリッド出力画像は次に接続できます：

* **画像処理ブロック** （例：Buffer、Image Slicer、Dynamic Crop）グリッドレイアウトに配置された画像リストを受け取るために
* **データ保存ブロック** （例：Local File Sink、CSV Formatter、Roboflow Dataset Upload）ドキュメント作成、レポート、またはバッチレビューの目的でグリッド画像を保存するために
* **Webhookブロック** ダッシュボード、ギャラリー、またはバッチ閲覧インターフェースで表示するために、グリッド可視化を外部システム、API、またはWebアプリケーションへ送信するために
* **通知ブロック** （例：Email Notification、Slack Notification）複数画像を含むアラートやレポートの視覚的証拠としてグリッド画像を送信するために
* **動画出力ブロック** ライブの複数画像監視やバッチ可視化ワークフロー向けに、グリッドレイアウトの動画ストリームや録画を作成するために
* **他の可視化ブロック** 単一画像を受け取れるもの。これにより、グリッド出力をさらに処理したり、追加の注釈と組み合わせたりできます

### 型識別子

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

### プロパティ

| **名前** | **型** | **説明**                                                                                                                  | 参照 |
| ------ | ----- | ----------------------------------------------------------------------------------------------------------------------- | -- |
| `name` | `str` | このステップの一意の識別子を入力してください。                                                                                                 | ❌  |
| `幅`    | `整数`  | 出力グリッド画像のピクセル単位の幅。画像グリッドが配置されるキャンバスの全幅を制御します。幅はグリッドの寸法に基づいて同じ大きさのセルに分割されます。一般的な値は、希望する出力サイズと画像数に応じて1280〜3840ピクセルの範囲です。  | ✅  |
| `高さ`   | `整数`  | 出力グリッド画像のピクセル単位の高さ。画像グリッドが配置されるキャンバスの全高を制御します。高さはグリッドの寸法に基づいて同じ大きさのセルに分割されます。一般的な値は、希望する出力サイズと画像数に応じて720〜2160ピクセルの範囲です。 | ✅  |

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

### 入力と出力のバインディング

利用可能な接続は、そのバインディング種別によって異なります。どのバインディング種別が `グリッドの可視化` のバージョン `v1` あるか確認してください。

<details>

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

* 入力
  * `images` (*Union\[*[*`list_of_values`*](/workflows/ja/gaido/developer-guide/kinds/list-of-values.md)*,* [*`image`*](/workflows/ja/gaido/developer-guide/kinds/image.md)*]*）：グリッドレイアウトに配置する画像。1つ以上の参照を追加します。すべて同じバッチレベルにしてください。個別の画像（例： `["$inputs.image", "$steps.depth_estimation.image"]` 入力画像をモデルの可視化結果と横並びで比較するためなど）や、単一レベルの画像リスト（例：Buffer の出力）を追加できます。これらはグリッドにフラット化されます。Dynamic Crop のような画像ごとのバッチは `クロップ` または Image Slicer `スライス` 1段階深くネストされています。ここに追加する前に Dimension Collapse ブロックでフラット化してください。これらを同じレベルの画像と直接混在させるとワークフローのコンパイルに失敗し、これらだけを使用すると、1つの結合グリッドではなく画像ごとに別々の単一セルグリッドが作成されます。画像は自動的に正方形グリッドに配置され（画像数から計算されます）、アスペクト比を維持したままセルに収まるようにリサイズされます。
  * `幅` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：出力グリッド画像のピクセル単位の幅。画像グリッドが配置されるキャンバスの全幅を制御します。幅はグリッドの寸法に基づいて同じ大きさのセルに分割されます。一般的な値は、希望する出力サイズと画像数に応じて1280〜3840ピクセルの範囲です。
  * `高さ` ([*`整数`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)）：出力グリッド画像のピクセル単位の高さ。画像グリッドが配置されるキャンバスの全高を制御します。高さはグリッドの寸法に基づいて同じ大きさのセルに分割されます。一般的な値は、希望する出力サイズと画像数に応じて720〜2160ピクセルの範囲です。
* 出力
  * `image` ([`image`](/workflows/ja/gaido/developer-guide/kinds/image.md)): ワークフロー内の画像。

</details>

<details>

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

```json
{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/grid_visualization@v1",
	    "images": [
	        "$inputs.image",
	        "$steps.depth_estimation.image"
	    ],
	    "width": 2560,
	    "height": 1440
	}
```

</details>