सामग्री पर जाएं
For the complete documentation index, see llms.txt. This page is also available as Markdown.

डिटेक्शन इवेंट लॉग

समय के साथ डिटेक्शन इवेंट्स को ट्रैक करता है, यह लॉग करते हुए कि वस्तुएँ पहली बार कब प्रकट होती हैं और बनी रहती हैं।

यह ब्लॉक ट्रैक किए गए ऑब्जेक्ट्स से डिटेक्शन इवेंट्स का लॉग बनाए रखता है। प्रत्येक ट्रैक किए गए ऑब्जेक्ट के लिए यह रिकॉर्ड करता है: class name, पहली और आखिरी बार देखे गए frame numbers, absolute wall-clock timestamps (frame_timestamp metadata से प्राप्त Unix epoch floats, या fallback के रूप में time.time()), और वीडियो शुरू होने के बाद से seconds में relative timestamps। किसी ऑब्जेक्ट को 'pending' से 'logged' status में ले जाने से पहले कम-से-कम निर्दिष्ट संख्या के frames (frame_threshold) तक देखा जाना चाहिए। stale events (जो stale_frames frames तक नहीं देखे गए) को periodic cleanup (हर flush_interval frames) के दौरान हटा दिया जाता है। जब कोई logged event stale हो जाता है, तो उसे complete_events output में emit किया जाता है, जिसमें उन ऑब्जेक्ट्स का पूरा event data होता है जिन्हें log होने के लिए पर्याप्त समय तक ट्रैक किया गया था और जो बाद में scene छोड़ चुके हैं। reference_timestamp parameter deprecated है और अब उपयोग नहीं होता।

प्रकार पहचानकर्ता

चरण में निम्नलिखित पहचानकर्ता का उपयोग करें "type" फ़ील्ड: roboflow_core/detection_event_log@v1 अपने वर्कफ़्लो में इस ब्लॉक को एक चरण के रूप में जोड़ने के लिए।

गुण

नाम

प्रकार

विवरण

संदर्भ

name

str

इस चरण के लिए एक अद्वितीय पहचानकर्ता दर्ज करें।

❌

frame_threshold

int

किसी ऑब्जेक्ट को लॉग किए जाने से पहले कितने फ़्रेमों तक देखा जाना चाहिए।

✅

flush_interval

int

पुराने हो चुके events के लिए cleanup operation कितनी बार (फ़्रेमों में) चलाना है।

✅

stale_frames

int

उन events को हटाएँ जिन्हें इतने फ़्रेमों से नहीं देखा गया है।

✅

reference_timestamp

float

अब deprecated है, और उपयोग नहीं होता। Absolute timestamps अब सीधे frame_timestamp metadata (या fallback के रूप में time.time()) से लिए जाते हैं।

✅

fallback_fps

float

जब वीडियो metadata FPS जानकारी नहीं देता, तब उपयोग करने के लिए fallback FPS. Relative timestamps की गणना के लिए उपयोग होता है।

✅

यह संदर्भ कॉलम, वर्कफ़्लो रनटाइम में उपलब्ध गतिशील मानों के साथ इस गुण को पैरामीटराइज़ करने की संभावना दर्शाता है वर्कफ़्लो रनटाइम. अधिक जानकारी के लिए देखें Bindings ।

रनटाइम संगतता

सॉफ्ट - रनटाइम hosted_serverless, dedicated_deployment; निष्पादन रिमोट; इनपुट वीडियो : ब्लॉक प्रति-वीडियो स्थिति को प्रक्रिया मेमोरी में बनाए रखता है (video_metadata.video_identifier द्वारा key किया गया)। Stateless या multi-replica HTTP runtimes पर remote step execution के साथ, क्रमिक अनुरोध अलग-अलग worker processes द्वारा सर्व किए जा सकते हैं, इसलिए calls के बीच state reset हो जाता है और tracking / counting / aggregation के लिए output अर्थहीन हो जाता है। स्थिर cross-frame results के लिए InferencePipeline में local step execution का उपयोग करें।

सॉफ्ट - इनपुट image : ब्लॉक वीडियो या repeated-frame workflows से प्राप्त temporal context पर निर्भर करता है। एक स्थिर image/photo के साथ, ट्रैक करने, तुलना करने, एकत्रित करने या दृश्यीकृत करने के लिए कोई अर्थपूर्ण history नहीं होती, इसलिए यह ब्लॉक बहुत कम या कोई लाभ नहीं देता।

इनपुट और आउटपुट बाइंडिंग्स

उपलब्ध कनेक्शन इसके binding kinds पर निर्भर करते हैं। जाँचें कि डिटेक्शन इवेंट लॉग संस्करण v1 में कौन-से binding kinds हैं।

इनपुट और आउटपुट बाइंडिंग्स
  • इनपुट

    • image (image): वीडियो metadata (frame number, timestamp) के लिए image का संदर्भ।

    • डिटेक्शंस (Union[instance_segmentation_prediction, object_detection_prediction]): byte tracker से ट्रैक की गई detections (tracker_id होना चाहिए)।

    • frame_threshold (पूर्णांक): किसी ऑब्जेक्ट को लॉग किए जाने से पहले कितने फ़्रेमों तक देखा जाना चाहिए।

    • flush_interval (पूर्णांक): पुराने हो चुके events के लिए cleanup operation कितनी बार (फ़्रेमों में) चलाना है।

    • stale_frames (पूर्णांक): उन events को हटाएँ जिन्हें इतने फ़्रेमों से नहीं देखा गया है।

    • reference_timestamp (float): अब deprecated है, और उपयोग नहीं होता। Absolute timestamps अब सीधे frame_timestamp metadata (या fallback के रूप में time.time()) से लिए जाते हैं।

    • fallback_fps (float): जब वीडियो metadata FPS जानकारी नहीं देता, तब उपयोग करने के लिए fallback FPS. Relative timestamps की गणना के लिए उपयोग होता है।

  • आउटपुट

    • event_log (शब्दकोश): शब्दकोश।

    • डिटेक्शंस (Union[object_detection_prediction, instance_segmentation_prediction]): sv.Detections(...) ऑब्जेक्ट के रूप में detected bounding boxes के साथ Prediction, यदि object_detection_prediction ): या sv.Detections(...) ऑब्जेक्ट के रूप में detected bounding boxes और segmentation masks के साथ Prediction, यदि instance_segmentation_prediction.

    • total_logged (पूर्णांक): पूर्णांक मान।

    • total_pending (पूर्णांक): पूर्णांक मान।

    • complete_events (शब्दकोश): शब्दकोश।

उदाहरण JSON परिभाषा

अंतिम अपडेट

क्या यह उपयोगी था?