検出イベントログ

時間の経過に伴う検出イベントを追跡し、オブジェクトが最初に現れた時点や継続している時点を記録します。

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

型識別子

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

プロパティ

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

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

ランタイム互換性

soft - ランタイム hosted_serverless, dedicated_deployment；実行 リモート；入力 動画 - 動画入力: ブロックは、プロセスメモリ内で動画ごとの状態を保持します（video_metadata.video_identifier でキー付け）。ステートレスまたは複数レプリカの HTTP ランタイムでリモートステップ実行を行うと、連続するリクエストが異なるワーカープロセスで処理される可能性があるため、呼び出し間で状態がリセットされ、出力は追跡／カウント／集計には意味を持ちません。安定したフレーム間結果を得るには、永続的な WebRTC セッションでローカルステップ実行を使用してください。

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

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

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

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

• 入力

  • 画像 (画像）：動画メタデータ（フレーム番号、タイムスタンプ）用の画像への参照。

  • 検出 (Union[object_detection_prediction, instance_segmentation_prediction]）：byte tracker による追跡検出（tracker_id が必要）。

  • frame_threshold (整数）：オブジェクトがログに記録される前に検出されている必要があるフレーム数。

  • flush_interval (整数）：古いイベントに対してクリーンアップ処理を実行する頻度（フレーム単位）。

  • stale_frames (整数）：このフレーム数の間検出されなかったイベントを削除します。

  • reference_timestamp (float）：非推奨で、もはや使用されません。絶対タイムスタンプは現在、frame_timestamp メタデータから直接取得されます（またはフォールバックとして time.time()）。

  • fallback_fps (float）：動画メタデータに FPS 情報がない場合に使用するフォールバック FPS。相対タイムスタンプの計算に使用されます。

• 出力

  • event_log (辞書）：辞書。

  • 検出 (Union[object_detection_prediction, instance_segmentation_prediction]）：sv.Detections(...) 形式の検出バウンディングボックスを含む予測。 object_detection_prediction または、sv.Detections(...) 形式の検出バウンディングボックスとセグメンテーションマスクを含む予測。 instance_segmentation_prediction.

  • total_logged (整数）：整数値。

  • total_pending (整数）：整数値。

  • complete_events (辞書）：辞書。

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
	}