> 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/video-processing/buffer.md).

# バッファ

渡された最後の\`length\`個の値を配列で返します。

最後のN個の値のスライディングウィンドウバッファを、最近の入力をFIFO（先入れ先出し）キューに保存し、最新の要素を先頭に追加し、バッファが指定長を超えると最古の要素を自動的に削除することで維持し、時間的データ収集、フレーム履歴追跡、バッチ処理準備、スライディングウィンドウ分析のワークフローを可能にします。

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

このブロックは、渡された最新の値を格納するローリングバッファを保持し、時間とともにデータのスライディングウィンドウを作成します。このブロックは：

1. 画像、検出結果、値など、任意の型の入力データと設定パラメータ（バッファ長とパディングオプション）を受け取ります
2. ワークフローの実行をまたいで保持される内部バッファを維持します：
   * ブロックが最初に作成されたとき、バッファは空のリストとして初期化されます
   * バッファの状態は、ワークフロー実行中ずっと保持されます
   * 各バッファブロックインスタンスは、それぞれ独立したバッファを持ちます
3. バッファに新しいデータを追加します：
   * 最新の値をバッファ配列の先頭（インデックス0）に挿入します
   * 最新の値がバッファの先頭に表示されます
   * 古い値は配列内の後ろの位置へシフトされます
4. バッファサイズを管理します：
   * バッファ長が指定した `長さ` パラメータを超えると、最古の要素を削除します
   * 最新の `長さ` 値のみを保持します
   * スライディングウィンドウサイズを自動的に維持します
5. オプションのパディングを適用します：
   * もし `パッド` が True の場合：バッファを `None` 値で埋め、ちょうど `長さ` 要素になるまで
   * より少ない `長さ` 値しか受信していない場合でも、一貫したバッファサイズを保証します
   * もし `パッド` が False の場合：バッファサイズは 0 から `長さ` まで増加し、値が追加されると `長さ`
6. バッファ配列を返します：
   * バッファされた値を順序どおり（最新が先頭）に含むリストを出力します
   * リストの長さは `長さ` に等しい（パディング有効時）か、現在のバッファサイズに等しい（パディング無効時）
   * 値は最新（インデックス0）から最古（最後のインデックス）へ順に並びます

バッファは、新しいデータが先頭に入り、容量に達すると古いデータが末尾から出ていくスライディングウィンドウパターンを実装します。これにより、最近の値の時間的履歴が作成され、以前のフレーム、検出結果、または測定値を参照する必要がある操作に役立ちます。バッファは任意のデータ型で動作するため、画像、検出結果、数値、またはその他のワークフロー出力に柔軟に対応できます。

## 一般的な使用例

* **フレーム履歴の追跡**: 時間的解析のために最近のビデオフレームの履歴を保持します（例：フレームシーケンスの追跡、最近の画像履歴の保持、比較用フレームの収集）。時間的フレーム解析ワークフローを可能にします
* **検出履歴**: トレンド分析や比較のために最近の検出結果をバッファします（例：時間経過による検出の変化の追跡、現在の検出と前回の検出の比較、検出パターンの解析）。検出履歴ワークフローを可能にします
* **バッチ処理の準備**: 複数の値をまとめて処理する前に収集します（例：最近の画像をバッチ処理する、複数の検出結果を集約する、バッチ操作用のデータを準備する）。バッチ処理ワークフローを可能にします
* **スライディングウィンドウ解析**: データのローリングウィンドウに対して解析を行います（例：最近のフレームの傾向を解析する、移動平均を計算する、シーケンス内の変化を検出する）。スライディングウィンドウ解析ワークフローを可能にします
* **可視化シーケンス**: アニメーションやシーケンスの可視化のために最近のデータを保持します（例：フレームシーケンスの作成、時間的変化の可視化、最近の履歴の表示）。時間的可視化ワークフローを可能にします
* **時間的比較**: 現在の値を最近の履歴値と比較します（例：現在のフレームと前のフレームを比較する、時間経過による変化を検出する、時間的パターンを解析する）。時間的比較ワークフローを可能にします

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

このブロックは任意の型のデータを受け取り、バッファされた出力配列を生成します：

* **任意のブロックの後に** バッファする値を生成するブロックの後に配置します（例：画像ソースからの画像をバッファする、検出モデルからの検出結果をバッファする、分析ブロックからの値をバッファする）。データバッファリングワークフローを可能にします
* **配列を処理するブロックの前に** バッチ処理済みまたは履歴データを提供します（例：バッファされた画像を処理する、検出配列を解析する、値のシーケンスを扱う）。配列処理ワークフローを可能にします
* **可視化ブロックの前** シーケンスまたは時間的データを表示するために（例：フレームシーケンスの可視化、検出履歴の表示、時間的パターンの表示）。時間的可視化ワークフローを可能にします
* **分析ブロックの前に** 履歴データを必要とするブロックの前に（例：時間経過による傾向の解析、現在と履歴の比較、時間的シーケンスの処理）。時間的解析ワークフローを可能にします
* **集約ブロックの前に** 集約用に複数の値を提供します（例：バッファされた値を集約する、複数の検出結果を処理する、最近のデータを結合する）。集約ワークフローを可能にします
* **時間的処理パイプラインで** 最近の履歴を保持する必要がある場合（例：時間経過による変化の追跡、フレームシーケンスの保持、時間的解析のためのデータ収集）。時間的処理ワークフローを可能にします

## 要件

このブロックは任意のデータ型（画像、検出結果、値など）に対応します。バッファは同じワークフローインスタンス内で、ワークフローの実行をまたいで状態を維持します。 `長さ` パラメータは、バッファに保持する値の最大数を決定します。 `パッド` が有効な場合、バッファは常にちょうど `長さ` 要素を返します（必要に応じて `None` でパディングされます）。 `パッド` が無効な場合、バッファは 0 から `長さ` 要素まで、値が追加されるにつれて増加し、その後 `長さ` 要素を維持します。最古の値を削除することで保持します。バッファはワークフロー実行中ずっと保持され、ワークフローを再起動するとリセットされます。

### タイプ識別子

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

### プロパティ

| **名前** | **型**  | **説明**                                                                                                                                                                                                                         | 参照 |
| ------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -- |
| `name` | `str`  | このステップの一意の識別子を入力してください。                                                                                                                                                                                                        | ❌  |
| `長さ`   | `int`  | バッファに保持する要素の最大数。バッファがこの長さを超えると、最古の要素が自動的に削除されます。スライディングウィンドウのサイズを決定します。0より大きくなければなりません。一般的には、フレームシーケンスでは2～10、より長い履歴ではそれ以上の値が使われます。                                                                                             | ❌  |
| `パッド`  | `bool` | 一定のバッファサイズを維持するためにパディングを有効にします。True の場合、バッファは `None` 値で埋め、ちょうど `長さ` 要素でパディングされ、出力は常に `長さ` 個の項目になります。たとえ受信した値がそれより少なくても同様です。False の場合、バッファは 0 から `長さ` まで値が追加されるにつれて増加し、その後 `長さ` を維持します。下流のブロックが固定サイズの配列を必要とする場合はパディングを使用してください。 | ❌  |

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

### 実行時互換性

`ソフト` - ランタイム `hosted_serverless`, `dedicated_deployment`; 実行 `リモート`; 入力 `動画` : このブロックは、動画ごとの状態をプロセスメモリ内に保持します（video\_metadata.video\_identifierでキー付け）。ステートレスまたは複数レプリカのHTTPランタイムでリモートステップ実行を行うと、連続したリクエストが異なるワーカープロセスで処理される可能性があるため、呼び出し間で状態がリセットされ、トラッキング／カウント／集計には出力が無意味になります。フレーム間で安定した結果を得るには、InferencePipeline内でローカルステップ実行を使用してください。

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

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

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

<details>

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

* input
  * `データ` (*Union\[*[*`*`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/wildcard.md)*,* [*`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)*]*: バッファに追加する任意の型の入力データ。画像、検出結果、値、その他のワークフロー出力のいずれでもかまいません。最新の値はバッファ配列の先頭に追加されます。バッファは最近の値のスライディングウィンドウを維持します。
* output
  * `output` ([`list_of_values`](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/list-of-values.md)) : 任意の型の値のリスト。

</details>

<details>

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

```json
{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/buffer@v1",
	    "data": "$steps.visualization",
	    "length": 5,
	    "pad": true
	}
```

</details>
