> 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枚の画像 = 2×2、9枚の画像 = 3×3、10枚の画像 = 4×4）。これにより、複数画像の比較、サムネイル表示、またはバッチ可視化出力の作成に最適な、コンパクトで整理されたレイアウトが実現します。このブロックは、同じ画像が再利用された場合のパフォーマンスを最適化するためにキャッシュを使用します。

## 一般的な使用例

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

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

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

* **画像処理ブロック** (例: 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ピクセルの範囲です。。 | ✅  |

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

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

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

<details>

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

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

</details>
