> 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/advanced-blocks/detection-event-log.md).

# 検出イベントログ

検出イベントを時系列で追跡し、オブジェクトが最初に現れた時点と継続して存在する時点を記録します。

このブロックは、追跡対象オブジェクトからの検出イベントのログを保持します。各追跡対象オブジェクトについて、クラス名、最初と最後に検出されたフレーム番号、絶対的なウォールクロック時刻（frame\_timestamp メタデータから派生した Unix エポックの浮動小数、またはフォールバックとして time.time()）、および動画開始からの経過秒数での相対タイムスタンプを記録します。オブジェクトは、'pending' から 'logged' ステータスに移される前に、最低限のフレーム数（frame\_threshold）で検出されている必要があります。古くなったイベント（stale\_frames フレームの間検出されなかったもの）は、定期的なクリーンアップ（flush\_interval フレームごと）で削除されます。ログ済みイベントが古くなると、complete\_events 出力に送られます。ここには、ログに記録されるのに十分な長さ追跡され、その後シーンを離れたオブジェクトの完全なイベントデータが含まれます。reference\_timestamp パラメータは非推奨で、もはや使用されません。

### 型識別子

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

### プロパティ

| **名前**                | **型**   | **説明**                                                                                    | 参照 |
| --------------------- | ------- | ----------------------------------------------------------------------------------------- | -- |
| `名前`                  | `str`   | このステップの一意の識別子を入力してください。                                                                   | ❌  |
| `frame_threshold`     | `int`   | オブジェクトがログに記録される前に検出される必要があるフレーム数。                                                         | ✅  |
| `flush_interval`      | `int`   | 古いイベントに対するクリーンアップ操作を、どのくらいの頻度（フレーム単位）で実行するか。                                              | ✅  |
| `stale_frames`        | `int`   | このフレーム数の間検出されなかったイベントを削除します。                                                              | ✅  |
| `reference_timestamp` | `float` | 非推奨で、もはや使用されません。絶対タイムスタンプは現在、frame\_timestamp メタデータから直接取得されます（またはフォールバックとして time.time()）。 | ✅  |
| `fallback_fps`        | `float` | 動画メタデータに FPS 情報がない場合に使用するフォールバック FPS。相対タイムスタンプの計算に使用されます。                                 | ✅  |

この **参照** 列は、ワークフロー `ワークフロー` ランタイム。参照 *バインディング* 詳細については。

### ランタイム互換性

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

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

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

利用可能な接続は、そのバインディング種別に依存します。どのバインディング種別が `検出イベントログ` のバージョン `v1` を持っています。

<details>

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

* 入力
  * `画像` ([*`画像`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/image.md)): 動画メタデータ（フレーム番号、タイムスタンプ）の画像への参照。
  * `detections` (*Union\[*[*`instance_segmentation_prediction`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/instance-segmentation-prediction.md)*,* [*`object_detection_prediction`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/object-detection-prediction.md)*]*): byte tracker からの追跡済み検出（tracker\_id が必要）。
  * `frame_threshold` ([*`整数`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)): オブジェクトがログに記録される前に検出される必要があるフレーム数。
  * `flush_interval` ([*`整数`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)): 古いイベントに対するクリーンアップ操作を、どのくらいの頻度（フレーム単位）で実行するか。
  * `stale_frames` ([*`整数`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)): このフレーム数の間検出されなかったイベントを削除します。
  * `reference_timestamp` ([*`float`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/float.md)): 非推奨で、もはや使用されません。絶対タイムスタンプは現在、frame\_timestamp メタデータから直接取得されます（またはフォールバックとして time.time()）。
  * `fallback_fps` ([*`float`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/float.md)): 動画メタデータに FPS 情報がない場合に使用するフォールバック FPS。相対タイムスタンプの計算に使用されます。
* 出力
  * `event_log` ([`辞書`](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/dictionary.md)): 辞書。
  * `detections` (*Union\[*[*`object_detection_prediction`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/object-detection-prediction.md)*,* [*`instance_segmentation_prediction`*](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/instance-segmentation-prediction.md)*]*): 検出されたバウンディングボックスを含む予測。sv.Detections(...) 形式のオブジェクトで、もし `object_detection_prediction` または、検出されたバウンディングボックスとセグメンテーションマスクを含む予測。sv.Detections(...) 形式のオブジェクトで、もし `instance_segmentation_prediction`.
  * `total_logged` ([`整数`](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)): 整数値。
  * `total_pending` ([`整数`](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/integer.md)): 整数値。
  * `complete_events` ([`辞書`](https://docs.roboflow.com/workflows/ja/gaido/developer-guide/kinds/dictionary.md)): 辞書。

</details>

<details>

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

```json
{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/detection_event_log@v1",
	    "image": "$inputs.image",
	    "detections": "$steps.byte_tracker.tracked_detections",
	    "frame_threshold": 5,
	    "flush_interval": 30,
	    "stale_frames": 150,
	    "reference_timestamp": 1726570875.0,
	    "fallback_fps": 1.0
	}
```

</details>
