> 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. 画像のリストと出力寸法（幅と高さ）を入力として受け取ります
2. 画像数に基づいてグリッドサイズを計算します（画像枚数の平方根を切り上げた値に等しい寸法の正方形グリッドを作成します）
3. 出力キャンバスをグリッドの寸法に基づいて同じサイズのセルに分割します
4. 各入力画像を、アスペクト比を維持したまま割り当てられたセル内に収まるようリサイズします（画像は歪みなくセル寸法に合わせてスケーリングされます）
5. 左上隅から画像を配置し、左から右へ、上から下へ埋めていきます（行優先順）
6. 各リサイズ後の画像をセル内で中央揃えにし、均等に間隔の取れたグリッドレイアウトを作成します
7. 入力画像をすべてグリッドに配置した単一の出力画像を返します

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

## 一般的な使用例

* **バッチ画像比較**: 複数の画像をグリッド内で左右に並べて簡単に比較できるようにし、異なるモデル、時点、または処理手順の結果を同時に可視化できます
* **サムネイルギャラリーの作成**: 画像コレクションからサムネイルグリッドを作成し、複数画像をコンパクトに表示する必要があるギャラリー表示、画像ブラウザー、プレビュー画面に利用できます
* **複数画像ワークフローの結果**: バッチ処理、Image Slicer の出力、バッファコレクションなどの複数画像ワークフローの結果を、概要確認用に整理されたグリッド形式で表示します
* **前後比較**: 比較・検証ワークフロー向けに、ビフォー／アフター画像、元画像と処理後画像、または複数のワークフロー出力をグリッドに配置します
* **時系列可視化**: 異なる時点、フレーム、またはスナップショットの画像をグリッドに表示し、時間変化、シーケンス、進行状況を可視化します
* **品質管理とレビュー**: 複数の画像をまとめて評価・検証する必要がある品質管理ワークフロー、バッチレビュー、検査プロセス向けにグリッドレイアウトを作成します

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

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

* **画像処理ブロック** （例: 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` | このステップの一意の識別子を入力してください。                                                                                                 | ❌  |
| `幅`    | `int` | 出力グリッド画像のピクセル幅。画像グリッドを配置するキャンバス全体の幅を制御します。幅はグリッドの寸法に基づいて同じサイズのセルに分割されます。一般的な値は、希望する出力サイズと画像数に応じて 1280～3840 ピクセルの範囲です。   | ✅  |
| `高さ`   | `int` | 出力グリッド画像のピクセル高さ。画像グリッドを配置するキャンバス全体の高さを制御します。高さはグリッドの寸法に基づいて同じサイズのセルに分割されます。一般的な値は、希望する出力サイズと画像数に応じて 720～2160 ピクセルの範囲です。 | ✅  |

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

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

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

<details>

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

* 入力
  * `画像` ([*`list_of_values`*](/workflows/ja/gaido/developer-guide/kinds/list-of-values.md)): グリッドレイアウトに配置する画像のリスト。Buffer、Image Slicer、Dynamic Crop などのブロック、または複数画像を出力する他のブロックの画像出力リストを指定できます。画像は画像数に基づいて自動的に正方形グリッドに配置され、アスペクト比を維持したままグリッドセルに収まるようにリサイズされます。
  * `幅` ([*`integer`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)): 出力グリッド画像のピクセル幅。画像グリッドを配置するキャンバス全体の幅を制御します。幅はグリッドの寸法に基づいて同じサイズのセルに分割されます。一般的な値は、希望する出力サイズと画像数に応じて 1280～3840 ピクセルの範囲です。
  * `高さ` ([*`integer`*](/workflows/ja/gaido/developer-guide/kinds/integer.md)): 出力グリッド画像のピクセル高さ。画像グリッドを配置するキャンバス全体の高さを制御します。高さはグリッドの寸法に基づいて同じサイズのセルに分割されます。一般的な値は、希望する出力サイズと画像数に応じて 720～2160 ピクセルの範囲です。
* 出力
  * `画像` ([`画像`](/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": "$steps.buffer.output",
	    "width": 2560,
	    "height": 1440
	}
```

</details>