PTZ ट्रैकिंग (ONVIF)
किसी वस्तु का अनुसरण करने के लिए ONVIF-संगत PTZ कैमरे को नियंत्रित करें
एक ONVIF-संगत PTZ (Pan-Tilt-Zoom) कैमरे को नियंत्रित करें ताकि वह स्वचालित रूप से पहचाने गए ऑब्जेक्ट्स का अनुसरण करे, प्रीसेट स्थितियों पर जाए, और PID नियंत्रण का उपयोग करके सुचारु ट्रैकिंग बनाए रखे — निगरानी, सुरक्षा मॉनिटरिंग, और स्वचालित कैमरा नियंत्रण वर्कफ़्लो के लिए।
यह ब्लॉक कैसे काम करता है
यह ब्लॉक ONVIF प्रोटोकॉल के माध्यम से PTZ कैमरों को नियंत्रित करता है ताकि वे वास्तविक समय में ऑब्जेक्ट्स को स्वचालित रूप से ट्रैक और फॉलो कर सकें। यह ब्लॉक:
अपस्ट्रीम ब्लॉक्स से ऑब्जेक्ट डिटेक्शन या इंस्टेंस सेगमेंटेशन प्रेडिक्शंस प्राप्त करता है
IP पता, पोर्ट, उपयोगकर्ता नाम, और पासवर्ड क्रेडेंशियल्स का उपयोग करके ONVIF-संगत PTZ कैमरे से कनेक्ट होता है
गति मोड निर्धारित करता है (फॉलो या प्रीसेट पर जाएँ):
फॉलो मोड के लिए:
ट्रैक करने के लिए लक्ष्य ऑब्जेक्ट चुनता है: या तो सबसे अधिक कॉन्फ़िडेंस वाला डिटेक्शन या कोई विशिष्ट ट्रैक किया गया ऑब्जेक्ट (यदि ट्रैकर IDs मौजूद हों)
ऑब्जेक्ट के बाउंडिंग बॉक्स के केंद्र की तुलना फ्रेम केंद्र से करके स्थिति त्रुटि की गणना करता है
सुचारु गति कमांड की गणना करने के लिए PID (Proportional-Integral-Derivative) नियंत्रण का उपयोग करता है:
प्रोपोर्शनल (Kp): वर्तमान स्थिति त्रुटि पर प्रतिक्रिया देता है
इंटीग्रल (Ki): समय के साथ स्थिर-अवस्था त्रुटियों को सुधारता है
डेरिवेटिव (Kd): भविष्य की त्रुटि का अनुमान लगाता है और दोलनों को कम करता है
गति कमांड्स को कैमरे की वेग सीमाओं के अनुरूप सामान्यीकृत करता है और कमांड बाढ़ रोकने के लिए रेट-लिमिटिंग लागू करता है
ONVIF ContinuousMove सेवा के माध्यम से कैमरे को निरंतर गति कमांड भेजता है
हंटिंग व्यवहार को रोकने के लिए डेड ज़ोन (केंद्र के आसपास का क्षेत्र जहाँ कैमरा हिलना बंद कर देता है) की निगरानी करता है
वैकल्पिक रूप से, जब ऑब्जेक्ट केंद्रित हो जाए तो उस पर ज़ूम करता है, और फ्रेम भरने के लिए ज़ूम गति समायोजित करता है
ट्रैकर IDs का उपयोग करके किसी विशिष्ट ऑब्जेक्ट का ट्रैकिंग तब तक बनाए रखता है जब तक वह गायब न हो जाए या ट्रैकिंग रीसेट न हो जाए
जब कोई ऑब्जेक्ट डिटेक्ट न हो, तो एक कॉन्फ़िगरेबल निष्क्रिय अवधि के बाद स्वचालित रूप से प्रीसेट स्थिति पर चला जाता है
गो टू प्रीसेट मोड के लिए:
ONVIF GotoPreset सेवा का उपयोग करके कैमरे को एक पूर्वनिर्धारित प्रीसेट स्थिति पर ले जाता है
कैमरे में प्रीसेट कार्यक्षमता का समर्थन होना चाहिए और प्रीसेट्स कॉन्फ़िगर होने चाहिए
कॉन्फ़िगरेशन में निर्दिष्ट प्रीसेट नाम का उपयोग करता है
वर्कफ़्लो निष्पादन को ब्लॉक होने से बचाने के लिए एक अलग इवेंट लूप का उपयोग करके कैमरा संचार को असिंक्रोनस रूप से प्रबंधित करता है
कैमरा स्थिति को प्रबंधित करता है, जिसमें seeking स्थिति, ट्रैक किए गए ऑब्जेक्ट IDs, ज़ूम स्थिति, और गति इतिहास शामिल हैं
दो आउटपुट लौटाता है:
भविष्यवाणियाँ: ट्रैक किया जा रहा डिटेक्शन (यदि कोई ऑब्जेक्ट फॉलो नहीं हो रहा है तो खाली)
खोज रहा है: बूलियन जो दर्शाता है कि कैमरा वर्तमान में किसी ऑब्जेक्ट की ओर बढ़ रहा है/खोज रहा है
यह ब्लॉक ऑब्जेक्ट केंद्र और फ्रेम केंद्र के बीच की दूरी के आधार पर सुचारु, अनुपातिक गति कमांड की गणना करने के लिए PID नियंत्रण का उपयोग करता है। गति को कैमरे की अधिकतम गति के प्रतिशत के रूप में सामान्यीकृत किया जाता है, और कैमरे को अपडेट्स से अभिभूत होने से बचाने के लिए कमांड्स पर रेट-लिमिट लगाई जाती है। डेड ज़ोन तब छोटे आंदोलनों को रोकता है जब ऑब्जेक्ट केंद्र के पास हो, जिससे हंटिंग व्यवहार कम होता है। जब ज़ूम सक्षम होता है, तो कैमरा पहले pan/tilt से ऑब्जेक्ट को केंद्र में लाता है, फिर फ्रेम में ऑब्जेक्ट को बनाए रखते हुए ज़ूम इन करता है।
सामान्य उपयोग मामले
निगरानी और सुरक्षा: निगरानी परिदृश्यों में व्यक्तियों या वाहनों को स्वचालित रूप से ट्रैक करें (जैसे, संदिग्ध गतिविधि का पीछा करना, घुसपैठियों को ट्रैक करना, सुरक्षा परिधि की निगरानी करना), जिससे स्वचालित निगरानी वर्कफ़्लो सक्षम होते हैं
खेल और इवेंट कवरेज: खेल आयोजनों या प्रदर्शनों के दौरान एथलीटों या वस्तुओं को ट्रैक करें (जैसे, मैदान पर खिलाड़ियों का पीछा करना, गेंद की गति को ट्रैक करना, इवेंट की कार्रवाई को कवर करना), जिससे स्वचालित खेल कवरेज वर्कफ़्लो सक्षम होते हैं
वन्यजीव मॉनिटरिंग: प्राकृतिक आवासों में जानवरों या वन्यजीवों का अनुसरण करें (जैसे, पक्षियों की गतिविधि को ट्रैक करना, अभयारण्यों में जानवरों का पीछा करना, वन्यजीव व्यवहार की निगरानी करना), जिससे वन्यजीव अवलोकन वर्कफ़्लो सक्षम होते हैं
औद्योगिक निगरानी: औद्योगिक परिवेश में ऑब्जेक्ट्स या कर्मियों का स्वचालित रूप से अनुसरण करें (जैसे, उपकरण की गति को ट्रैक करना, कर्मचारियों की गतिविधियों की निगरानी करना, सुविधाओं में वाहनों का पीछा करना), जिससे औद्योगिक स्वचालन वर्कफ़्लो सक्षम होते हैं
यातायात मॉनिटरिंग: यातायात परिदृश्यों में वाहनों या ऑब्जेक्ट्स को ट्रैक करें (जैसे, चौराहों से गुजरते वाहनों का पीछा करना, यातायात उल्लंघनों को ट्रैक करना, सड़क गतिविधि की निगरानी करना), जिससे स्वचालित यातायात मॉनिटरिंग वर्कफ़्लो सक्षम होते हैं
रिटेल विश्लेषिकी: रिटेल परिवेश में ग्राहकों या उत्पादों को ट्रैक करें (जैसे, ग्राहक मार्गों का अनुसरण करना, उत्पाद इंटरैक्शन को ट्रैक करना, खरीदारी व्यवहार की निगरानी करना), जिससे रिटेल एनालिटिक्स वर्कफ़्लो सक्षम होते हैं
अन्य ब्लॉक्स से जोड़ना
यह ब्लॉक प्रेडिक्शंस प्राप्त करता है और कैमरा नियंत्रण कमांड तथा ट्रैकिंग स्थिति उत्पन्न करता है:
ऑब्जेक्ट डिटेक्शन या इंस्टेंस सेगमेंटेशन ब्लॉकों के बाद कैमरे के साथ डिटेक्ट किए गए ऑब्जेक्ट्स को ट्रैक करने के लिए (जैसे, डिटेक्ट किए गए लोगों का अनुसरण करना, डिटेक्ट किए गए वाहनों को ट्रैक करना, डिटेक्ट किए गए ऑब्जेक्ट्स की निगरानी करना), जिससे डिटेक्शन-से-कैमरा-ट्रैकिंग वर्कफ़्लो सक्षम होते हैं
Byte Tracker ब्लॉकों के बाद सुसंगत IDs वाले विशिष्ट ट्रैक किए गए ऑब्जेक्ट्स का अनुसरण करने के लिए (जैसे, फ्रेमों के बीच किसी ट्रैक किए गए व्यक्ति का अनुसरण करना, किसी विशिष्ट वाहन की ट्रैकिंग बनाए रखना, किसी ट्रैक किए गए ऑब्जेक्ट की निरंतर निगरानी करना), जिससे ट्रैकिंग-से-कैमरा वर्कफ़्लो सक्षम होते हैं
डिटेक्शन फ़िल्टर ब्लॉक्स के बाद विशिष्ट ऑब्जेक्ट क्लासेस या फ़िल्टर किए गए डिटेक्शन्स को ट्रैक करने के लिए (जैसे, केवल विशिष्ट क्लासेस को ट्रैक करना, फ़िल्टर किए गए डिटेक्शन्स का अनुसरण करना, चयनित ऑब्जेक्ट्स की निगरानी करना), जिससे फ़िल्टर-ट्रैकिंग वर्कफ़्लो सक्षम होते हैं
विज़ुअलाइज़ेशन ब्लॉकों से पहले कैमरा गति स्थिति और ट्रैक किए गए ऑब्जेक्ट्स को प्रदर्शित करने के लिए (जैसे, ट्रैकिंग स्थिति को विज़ुअलाइज़ करना, seeking संकेतक दिखाना, कैमरा नियंत्रण फ़ीडबैक दिखाना), जिससे कैमरा नियंत्रण विज़ुअलाइज़ेशन वर्कफ़्लो सक्षम होते हैं
सूचना ब्लॉक्स से पहले जब कैमरा ट्रैक करना शुरू या बंद करे, तब अलर्ट करने के लिए (जैसे, ट्रैकिंग शुरू होने पर सूचित करना, ट्रैकिंग खोने पर अलर्ट करना, कैमरा स्थिति रिपोर्ट करना), जिससे कैमरा स्थिति सूचना वर्कफ़्लो सक्षम होते हैं
निगरानी और मॉनिटरिंग पाइपलाइनों में जहाँ स्वचालित कैमरा नियंत्रण किसी बड़े सुरक्षा या मॉनिटरिंग सिस्टम का हिस्सा होता है (जैसे, स्वचालित सुरक्षा प्रणालियाँ, मॉनिटरिंग पाइपलाइन्स, कैमरा नियंत्रण चेन), जिससे व्यापक निगरानी वर्कफ़्लो सक्षम होते हैं
आवश्यकताएँ
इस ब्लॉक के लिए नेटवर्क एक्सेस वाले ONVIF-संगत PTZ कैमरे की आवश्यकता होती है। कैमरे को Follow मोड के लिए ONVIF ContinuousMove सेवा और प्रीसेट मूवमेंट के लिए GotoPreset सेवा का समर्थन करना चाहिए। सर्वोत्तम प्रदर्शन के लिए, परिवर्तनीय गति क्षमता वाले कैमरे का उपयोग करें - जिन कैमरों में परिवर्तनीय गति नहीं है, वे simulate_variable_speed विकल्प का उपयोग कर सकते हैं, लेकिन उनमें झटकेदार गति हो सकती है। ब्लॉक को ऐसे प्रोसेस में चलना चाहिए जो नेटवर्क के माध्यम से कैमरे तक पहुँच सके, इसलिए यह Roboflow-होस्टेड रनटाइम्स से उपयोग योग्य नहीं है। सुचारु ट्रैकिंग बिना overshooting या hunting के प्राप्त करने के लिए PID ट्यूनिंग की अनुशंसा की जाती है - कैमरे की प्रतिक्रिया और वीडियो विलंबता के आधार पर pid_kp, pid_ki, और pid_kd पैरामीटर समायोजित करें। सटीक ट्रैकिंग के लिए, कैमरा गति और वीडियो फ़ीडबैक के बीच विलंब को कम करने हेतु eager buffer consumption रणनीति का उपयोग करें। यदि प्रीसेट मूवमेंट या auto-reset कार्यक्षमता का उपयोग कर रहे हैं, तो कैमरे में प्रीसेट्स कॉन्फ़िगर होने चाहिए।
प्रकार पहचानकर्ता
चरण में निम्नलिखित पहचानकर्ता का उपयोग करें "type" फ़ील्ड: roboflow_core/onvif_sink@v1 ताकि ब्लॉक को अपने वर्कफ़्लो में एक चरण के रूप में जोड़ा जा सके।
गुण
नाम
प्रकार
विवरण
संदर्भ
नाम
str
इस चरण के लिए एक अद्वितीय पहचानकर्ता दर्ज करें..
❌
camera_ip
str
ONVIF कनेक्शन के लिए कैमरे का IP पता या होस्टनेम। वर्कफ़्लो निष्पादन परिवेश से पहुँच योग्य होना चाहिए..
✅
camera_port
int
कैमरे का ONVIF सेवा पोर्ट (आमतौर पर 80, 8080, या कैमरा-विशिष्ट पोर्ट)। कैमरे की ONVIF कॉन्फ़िगरेशन से मेल खाना चाहिए..
✅
camera_username
str
ONVIF प्रमाणीकरण के लिए कैमरे का उपयोगकर्ता नाम। कैमरे पर PTZ नियंत्रण अनुमतियाँ होनी चाहिए..
✅
camera_password
str
ONVIF प्रमाणीकरण के लिए कैमरे का पासवर्ड। सुरक्षा के लिए इसे सीक्रेट के रूप में संग्रहीत किया जाना चाहिए..
✅
movement_type
str
कैमरे के लिए मूवमेंट मोड। 'Follow' मोड PID नियंत्रण का उपयोग करके डिटेक्ट किए गए ऑब्जेक्ट्स को ट्रैक करता है। 'Go To Preset' मोड कैमरे को एक पूर्वनिर्धारित प्रीसेट स्थिति पर ले जाता है (इसके लिए default_position_preset को कॉन्फ़िगर करना आवश्यक है)..
❌
simulate_variable_speed
बूल
मूल परिवर्तनीय गति समर्थन न रखने वाले कैमरों के लिए परिवर्तनीय गति सिमुलेशन सक्षम करें। सक्षम होने पर, प्रतिशत गति का अनुमान लगाने के लिए 100% गति कमांड भेजे जाते हैं, उसके बाद स्टॉप कमांड। इससे झटकेदार गति हो सकती है - केवल तभी उपयोग करें जब कैमरे में परिवर्तनीय गति क्षमता न हो..
✅
zoom_if_able
बूल
ट्रैक किए गए ऑब्जेक्ट के साथ फ्रेम भरने के लिए स्वचालित ज़ूम सक्षम करें। सक्षम होने पर, कैमरा पहले pan/tilt से ऑब्जेक्ट को केंद्र में लाता है, फिर तब तक ज़ूम इन करता है जब तक ऑब्जेक्ट फ्रेम को भर न दे। इसके लिए कैमरे में ज़ूम कार्यक्षमता का समर्थन होना चाहिए..
✅
follow_tracker
बूल
ट्रैकर IDs का उपयोग करके स्थायी ट्रैकिंग सक्षम करें। सक्षम होने पर, कैमरा सबसे अधिक कॉन्फ़िडेंस वाले डिटेक्शन की ट्रैकर ID पर लॉक हो जाता है और उस विशिष्ट ऑब्जेक्ट का तब तक अनुसरण करता रहता है जब तक वह गायब न हो जाए या ट्रैकिंग रीसेट न हो जाए। इसके लिए वर्कफ़्लो में ट्रैकर IDs असाइन करने हेतु Byte Tracker ब्लॉक आवश्यक है..
✅
dead_zone
int
फ्रेम केंद्र के आसपास पिक्सेल में डेड ज़ोन का आकार जहाँ कैमरा गति रुक जाती है। जब ऑब्जेक्ट केंद्र के पास होता है, तो यह हंटिंग व्यवहार को रोकता है। बड़े मान pan/tilt हंटिंग को कम करते हैं लेकिन ज़ूम हंटिंग का कारण बन सकते हैं। छोटे मान ज़ूम स्थिरता में सुधार करते हैं लेकिन pan/tilt ऑसिलेशन पैदा कर सकते हैं। सामान्य सीमा: 30-100 पिक्सेल..
✅
default_position_preset
str
डिफ़ॉल्ट/होम स्थिति के लिए प्रीसेट नाम। कैमरा निष्क्रिय अवधि के बाद (यदि move_to_position_after_idle_seconds सेट है) या Go To Preset मोड का उपयोग करते समय इस प्रीसेट पर लौटेगा। कैमरे में कॉन्फ़िगर किए गए प्रीसेट नाम से बिल्कुल मेल खाना चाहिए। प्रीसेट मूवमेंट कार्यक्षमता के लिए आवश्यक..
✅
move_to_position_after_idle_seconds
int
स्वचालित-रीसेट समय, सेकंड में। कैमरा इस अवधि तक खोज/गति बंद करने के बाद स्वचालित रूप से default_position_preset पर चला जाता है। auto-reset अक्षम करने के लिए 0 सेट करें। इसके लिए default_position_preset कॉन्फ़िगर होना चाहिए..
✅
camera_update_rate_limit
int
कैमरा गति कमांड्स के बीच न्यूनतम समय, मिलीसेकंड में। कैमरे को अभिभूत होने से बचाने के लिए ONVIF अपडेट्स पर रेट लिमिट लगाता है। कम मान अधिक प्रतिक्रियाशील ट्रैकिंग देते हैं लेकिन धीमे कैमरों पर अधिक भार डाल सकते हैं। अधिक मान कैमरा लोड कम करते हैं लेकिन गति कम सुचारु हो सकती है। सामान्य सीमा: 100-500ms..
✅
flip_x_movement
बूल
क्षैतिज (pan) गति की दिशा उलटें। यदि कैमरा छवि क्षैतिज रूप से मिरर है और गति उलटी लगती है, तो इसे सक्षम करें। छवि पलटने पर कैमरा गति सुधारने के लिए उपयोग करें..
✅
flip_y_movement
बूल
ऊर्ध्वाधर (tilt) गति की दिशा उलटें। कई कैमरों में Y-अक्ष उलटी होने के कारण यह डिफ़ॉल्ट रूप से सक्षम रहता है। यदि ऊर्ध्वाधर गति उलटी लगती है, तो इसे अक्षम करें..
✅
minimum_camera_speed
float
न्यूनतम गति, प्रतिशत के रूप में (0.0-1.0)। इस सीमा से नीचे के गति कमांड्स को इस न्यूनतम स्तर तक बढ़ाया जाता है। कुछ कैमरे बहुत कम गति को अनदेखा करते हैं - यदि कैमरा छोटे आंदोलनों पर प्रतिक्रिया नहीं देता, तो इसे बढ़ाएँ। सामान्य सीमा: 0.02-0.1 (2%-10%)..
✅
pid_kp
float
PID प्रोपोर्शनल गेन (Kp)। स्थिति त्रुटि पर प्रतिक्रिया नियंत्रित करता है - अधिक मान कैमरे को तेज़ प्रतिक्रिया देते हैं लेकिन overshooting और hunting का कारण बन सकते हैं। कम मान hunting घटाते हैं लेकिन ट्रैकिंग धीमी बनाते हैं। डिफ़ॉल्ट से शुरू करें और कैमरे की प्रतिक्रिया के आधार पर समायोजित करें। सामान्य सीमा: 0.1-0.5..
✅
pid_ki
float
PID इंटीग्रल गेन (Ki)। समय के साथ त्रुटि जमा करके स्थिर-अवस्था त्रुटि को समाप्त करता है। आमतौर पर 0 पर रखा जाता है क्योंकि इससे दोलन हो सकते हैं। यदि छोटे त्रुटियों के बावजूद कैमरा लगातार थोड़ा ऑफ-सेंटर रुकता है, तो इसे थोड़ा बढ़ाएँ (0.01-0.1)..
✅
pid_kd
float
PID डेरिवेटिव गेन (Kd)। भविष्य की त्रुटि का अनुमान लगाता है और दोलनों को कम करता है। उच्च मान वीडियो लैग के साथ स्थिरता सुधारते हैं, लेकिन अत्यधिक मान hunting का कारण बन सकते हैं। यदि कैमरा गति और वीडियो फ़ीडबैक के बीच पर्याप्त देरी है, तो इसे बढ़ाएँ (1-5)। यदि ट्रैकिंग झटकेदार लगे तो इसे घटाएँ..
✅
यह संदर्भ कॉलम उस संभावना को चिह्नित करता है कि प्रॉपर्टी को गतिशील मानों के साथ पैरामीटराइज़ किया जा सकता है, जो उपलब्ध हैं वर्कफ़्लो रनटाइम में। देखें बाइंडिंग्स अधिक जानकारी के लिए।
रनटाइम संगतता
कठिन - रनटाइम hosted_serverless, dedicated_deployment : इस ब्लॉक को PTZ कैमरे तक LAN एक्सेस की आवश्यकता होती है। Hosted Serverless और Roboflow Dedicated Deployments ग्राहक LAN तक नहीं पहुँच सकते।
इनपुट और आउटपुट बाइंडिंग्स
उपलब्ध कनेक्शन इसके बाइंडिंग प्रकारों पर निर्भर करते हैं। जाँचें कि कौन-से बाइंडिंग प्रकार PTZ ट्रैकिंग (ONVIF) संस्करण में v1 हैं।
अंतिम अपडेट
क्या यह उपयोगी था?