For the complete documentation index, see llms.txt. This page is also available as Markdown.

탐지 이벤트 로그

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

이 블록은 추적된 객체의 감지 이벤트 로그를 유지합니다. 각 추적된 객체에 대해 다음을 기록합니다: 클래스 이름, 처음 및 마지막으로 감지된 프레임 번호, 절대 월클록 타임스탬프(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 런타임에서 원격 단계 실행을 사용하면 연속 요청이 서로 다른 워커 프로세스에서 처리될 수 있으므로, 호출 사이에 상태가 초기화되어 출력은 추적/카운팅/집계에 의미가 없습니다. 프레임 간 안정적인 결과를 원하면 InferencePipeline에서 로컬 단계 실행을 사용하세요.

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

입력 및 출력 바인딩

사용 가능한 연결은 바인딩 종류에 따라 다릅니다. 다음 바인딩 종류가 무엇인지 확인하세요 Detection Event Log 버전 v1 에 있습니다.

입력 및 출력 바인딩
  • 입력

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

    • detections (Union[instance_segmentation_prediction, object_detection_prediction]): 바이트 트래커에서 추적된 감지 결과입니다(tracker_id가 있어야 함)..

    • frame_threshold (integer): 객체가 로그되기 전에 감지되어야 하는 프레임 수입니다..

    • flush_interval (integer): 오래된 이벤트에 대한 정리 작업을 얼마나 자주(프레임 기준) 실행할지..

    • stale_frames (integer): 이 프레임 수 동안 감지되지 않은 이벤트를 제거합니다..

    • reference_timestamp (float): 더 이상 사용되지 않으며 폐기되었습니다. 절대 타임스탬프는 이제 frame_timestamp 메타데이터에서 직접 가져오며(또는 대체값으로 time.time() 사용)..

    • fallback_fps (float): 비디오 메타데이터에 FPS 정보가 없을 때 사용할 대체 FPS입니다. 상대 타임스탬프 계산에 사용됩니다..

  • 출력

    • event_log (dictionary): 딕셔너리.

    • detections (Union[object_detection_prediction, instance_segmentation_prediction]): sv.Detections(...) 객체 형식의 감지된 바운딩 박스가 있는 예측 결과, 만약 object_detection_prediction 또는 sv.Detections(...) 객체 형식의 감지된 바운딩 박스와 세그멘테이션 마스크가 있는 예측 결과, 만약 instance_segmentation_prediction.

    • total_logged (integer): 정수 값.

    • total_pending (integer): 정수 값.

    • complete_events (dictionary): 딕셔너리.

예시 JSON 정의

마지막 업데이트

도움이 되었나요?