탐지 이벤트 로그

탐지 이벤트를 시간에 따라 추적하며, 객체가 처음 나타나고 유지될 때를 기록합니다.

이 블록은 추적된 객체의 탐지 이벤트 로그를 유지합니다. 각 추적 객체에 대해 클래스 이름, 처음 및 마지막으로 확인된 프레임 번호, 절대 월드클록 타임스탬프(frame_timestamp 메타데이터에서 파생된 Unix epoch 부동소수점 값 또는 대체값으로 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입니다. 상대 타임스탬프 계산에 사용됩니다..	✅

이 참조 열은 워크플로우 런타임에서 사용 가능한 동적 값으로 속성을 매개변수화할 수 있는 가능성을 나타냅니다 워크플로우 런타임입니다. 자세한 내용은 바인딩 을 참조하세요.

런타임 호환성

소프트 - 런타임 hosted_serverless, dedicated_deployment; 실행 원격; 입력 비디오 : 블록은 프로세스 메모리에서 비디오별 상태를 유지합니다(video_metadata.video_identifier로 키가 지정됨). 상태 비저장 또는 다중 복제 HTTP 런타임에서 원격 단계 실행을 사용하면 연속 요청이 서로 다른 워커 프로세스에서 처리될 수 있으므로, 호출마다 상태가 초기화되고 출력은 추적/카운팅/집계에 의미가 없어집니다. 안정적인 프레임 간 결과를 위해 지속적인 WebRTC 세션에서 로컬 단계 실행을 사용하세요.

소프트 - 입력 이미지 : 블록은 비디오 또는 반복 프레임 워크플로우의 시간적 컨텍스트에 의존합니다. 정지 이미지/사진에는 추적, 비교, 집계 또는 시각화할 의미 있는 이력이 없으므로, 이 블록은 거의 또는 전혀 이점을 제공하지 않습니다.

입력 및 출력 바인딩

사용 가능한 연결은 바인딩 유형에 따라 달라집니다. 어떤 바인딩 유형인지 확인하세요 탐지 이벤트 로그 버전 v1 을 가지고 있는지.

입력 및 출력 바인딩

• 입력

  • 이미지 (이미지): 비디오 메타데이터(프레임 번호, 타임스탬프)를 위한 이미지 참조.

  • detections (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 (딕셔너리): 딕셔너리.

  • detections (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
	}