Object_Detection_Tracker

هذه دالة تتعقب الكائنات عبر الإطارات اعتمادًا على نتائج الكشف التي تزودها بها. تقوم بتعيين معرفات ثابتة للأجسام المتحركة، تحتفظ بتاريخ قصير لكل مسار (بما في ذلك تسمية الفئة المستقرة عندما تكون متاحة)، وتُخرج صورة مشروحة بالإضافة إلى قوائم يمكنك استخدامها للعد أو التسجيل أو التحليلات عالية المستوى.

📥 المدخلات

• Input Image الإطار الحالي المستخدم للعرض والسياق التتبعي.

• Detected Rectangles قائمة صناديق الإحاطة (bounding boxes) المكتشفة. زوّد هنا المستطيلات الناتجة عن كتلة كشف الأجسام.

• Detected Classes قائمة بأسماء الفئات المقابلة للكشوف الموفَّرة. تُستخدم لبناء تسمية فئة مستقرة لكل كائن متتبع.

ملاحظة: هذه مقابس مدخلات. قم بتغذية الكشوف من كتلة كشف الأجسام إلى هذه المقابس.

📤 المخرجات

• Result Image صورة مشروحة بصناديق الإحاطة، المعرفات وتسميات الفئات لكل مسار نشط.

• Position - ID List قائمة بمراكز مواقع الكائنات المتتبعة مع المعرفات المسندة وأسماء الفئات المستقرة.

• Rectangle - ID List قائمة بالمستطيلات المزاوجة مع المعرفات وأسماء الفئات المستقرة.

ملاحظة: هذه مقابس مخرجات. استخدمها للعرض المرئي أو العد أو لإرسال بيانات التتبع إلى كتل أخرى.

🕹️ الضوابط

لا يحتوي هذا البلوك على ضوابط مرئية خاصة بالمستخدم داخل البلوك نفسه. السلوك يتحكم به بيانات الكشف التي تزوده بها وكيفية إعداد الكتل الصاعدة لحساسية وتواتر الكشف.

⚙️ آلية العمل

• يستقبل البلوك كشوف لكل إطار (مستطيلات وفئات) مع صورة الإطار الحالي.

• يزاوج الكشوف الجديدة مع المسارات القائمة للحفاظ على ثبات الهويات عبر الإطارات.

• لكل مسار يحتفظ البلوك بتاريخ قصير من كشوف الفئة بحيث تصبح الفئة المعروضة مستقرة (يتجنب التقليب السريع للتسميات بسبب تصنيفات خاطئة مؤقتة).

• يتحمل البلوك حالات الفقدان المؤقتة للكشف (إطارات بدون كشف) حتى لا تختفي المسارات فورًا، ويزيل المسارات التي تظل خاملة لفترة أطول.

• المخرجات تتضمن صورة مشروحة للعرض المرئي وقوائم مهيكلة (مواقع ومستطيلات مرفقة بالمعرّفات وأسماء الفئات) للمعالجة اللاحقة.

هذا السلوك تلقائي؛ يمكنك التحكم في جودة التتبع بشكل أساسي عن طريق جودة وتواتر الكشوف الواردة.

🎯 الميزات الرئيسية

• تعيين معرف ثابت عبر الإطارات لكل كائن مكتشف.

• تثبيت تسمية الفئة لكل مسار بحيث تصبح التسميات مع مرور الوقت متسقة.

• إخراج نتائج مرئية إلى جانب قوائم مهيكلة للتحليلات أو التسجيل.

• مقاومة لفقدان الكشوف القصير المؤقت.

• إنشاء مسارات جديدة للكشوف التي لا تطابق مسارات قائمة وإنهاء المسارات القديمة تلقائيًا.

📝 تعليمات الاستخدام

1. وصل مصدر صورة بمقبس Input Image (مثال: Camera USB، IP camera، تدفق أو إطارات محمّلة مسبقًا).

2. وصل بلوك كشف لتزويد Detected Rectangles وDetected Classes بالمعلومات.

3. استخدم Result Image لمعاينة نتيجة التتبع.

4. استخدم مخرجات Position - ID List وRectangle - ID List لإرسالها إلى كتل لاحقة للعد أو التسجيل أو التحليلات.

💡 نصائح وحيل

• لتحصل على أفضل النتائج، زود هذا البلوك بكشوف موثوقة من بلوك كشف الأجسام مثل Object Detection أو Object Detection - Custom أو Object Detection (D-FINE).

• لعرض الكشوف قبل/بعد التتبع، وصل Result Image إلى Show Image أو Draw Detections.

• لتسجيل النتائج المرئية، أرسل Result Image إلى Image Logger أو Record Video.

• للتركيز على منطقة معينة، اقتطع الإدخال أولًا باستخدام Image ROI أو Image ROI Select أو Image ROI Polygon قبل تزويد الكشوف.

• لتصفية الكشوف الخاطئة أو لعد الكائنات داخل منطقة محددة فقط، اجمع Rectangle - ID List مع Rectangles in Rectangle أو Check Area (Polygon).

• استخدم إخراج Rectangle - ID List لتغذية تطبيقات أعلى مستوى مثل Traffic Intersection Analysis لعد المركبات أو رصد عبور المناطق.

• إذا كانت الكشوف ضوضائية، جرّب إضافة معالجة مسبقة مثل Blur أو Image Threshold أو HSV Filter قبل التتبع لتحسين جودة الكشف.

🛠️ استكشاف المشاكل وإصلاحها

• لا تظهر مسارات: تأكد من أن مقابسي Detected Rectangles وDetected Classes تتلقى بيانات كشف صحيحة من بلوك كشف الأجسام.

• تتغير المعرفات بسرعة أو تتقلب التسميات كثيرًا: حسّن استقرار الكشوف (محدد أفضل، معالجة مسبقة) أو قلل الضوضاء في الكشوف حتى يتمكن البلوك من بناء تاريخ فئة مستقر.

• تختفي المسارات بسرعة كبيرة: تأكد من تزويد الكشوف عبر إطارات متتالية؛ إذا كانت الكشوف متقطعة فكر في تسوية البيانات أو زيادة تكرار الكشف في المراحل السابقة.

• الكثير من المسارات قصيرة العمر: حاول تصفية الكشوف الصغيرة أو منخفضة الثقة قبل إرسالها، أو استخدم اقتطاع المنطقة (مثل Image ROI Select) لتقليل الإيجابيات الكاذبة.

مثال سريع للإعداد: Camera USB (Camera USB) -> بلوك كشف الأجسام (مثل Object Detection (D-FINE)) -> Object_Detection_Tracker -> Show Image / Image Logger / Traffic Intersection Analysis.