Traffic Intersection Analysis

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

📥 المدخلات (sockets)

• Rectangle - ID List — أرسل هنا الكائنات المتتبعة (مربعات الاحتواء مع معرفات التتبع).

• Polygon Areas — قدم منطقة أو أكثر متعددة الأضلاع التي تُعرِّف مناطق التقاطع المراد مراقبتها.

• Reset Tracking Log — مدخل منطقي (Boolean) لمسح سجل التتبع والتعدادات المخزنة.

📤 المخرجات (sockets)

• Tracking Data — أعداد المسارات المجمّعة (بصيغة شبيهة بـ JSON) تُظهر عدد المركبات من كل نوع التي انتقلت بين أزواج المناطق (مثال: "1-2": {"car": 3, "bus": 1}).

🕹️ الضوابط

• Reset Tracking Log — فعّل هذا المدخل (مثلاً عبر مفتاح يدوي) لإعادة تعيين جميع العدادَات والتاريخ الداخلي.

• (مناطق المضلع تُزوَّد عبر مقبس Polygon Areas; استخدم كتلة اختيار متعدد للمضلعات لتحديدها.)

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

• يستخدم مربعات الاحتواء المتتبعة ومعرفات التتبع لربط الاكتشافات عبر الإطارات واكتشاف انتقالات المناطق.

• يحتفظ بتاريخ مواضع قصير لكل معرف متتبع لتهدئة الضوضاء في المواضع قبل تقرير أي منطقة يشغلها الكائن.

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

• يدعم مناطق متعددة متعددة الأضلاع (كل منطقة قد تحتوي نقاط زوايا عديدة).

• خيار لإعادة التعيين لمسح التاريخ والعدادات عند الحاجة.

⚙️ آلية العمل (مستوى عالٍ)

• تستقبل الكتلة قائمة بالمربعات المتتبعة مع المعرفات وربما أسماء فئات المركبات.

• لكل عنصر متتبع تُحسب نقطة تمثيلية (منتصف الأسفل لمربع الاحتواء) ويُحتفظ بتاريخ قصير لنقاط هذا المعرف.

• تُحسب النقطة التمثيلية (متوسط المواقع الأخيرة) وتُختبر مقابل كل منطقة مضلعة لتحديد المنطقة الحالية للمركبة.

• عندما يتغير موقع المركبة من منطقة إلى أخرى (مثلاً من المنطقة 1 إلى المنطقة 2)، يُسجل الانتقال وتزداد عدّاد المسار المقابل لنوع المركبة.

• تُخرج الأعداد المجمّعة للمسارات كبيانات مُهيكلة عبر مقبس Tracking Data.

• تفعيل Reset Tracking Log يمسح كل السجلات والعدادات المخزنة.

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

1. أرسل الاكتشافات المتتبعة إلى مدخل Rectangle - ID List. استخدم متتبّعًا يُنتج مربعات مع معرفات مستقرة.

2. حدِّد مناطق التقاطع بمضلعات ووصلها إلى مدخل Polygon Areas.

3. لمسح العدّادات والتاريخ في أي وقت، أرسل إشارة TRUE إلى مدخل Reset Tracking Log.

4. اطّلع على إحصاءات المسارات الحية من مخرج Tracking Data واستخدمها للعرض أو التسجيل أو التصدير.

💡 نصائح وحيل

• استخدم Object_Detection_Tracker لإنتاج مخرج Rectangle - ID List. هذه الكتلة تُعطي مربعات متتبعة ومعرفات مناسبة لتحليل المسارات.

• ارسم واحفظ مناطق المضلعات باستخدام Image ROI Polygon Multi ووصل مخرج Polygons لديها إلى مدخل Polygon Areas. هذه الأداة تسهّل تعريف المناطق بصريًا.

• استخدم Logic Input لتوفير مشغل يدوي لـ Reset Tracking Log عندما تريد إعادة العدّ في فترات معروفة (تغيير الورديات، اختبارات، إلخ).

• للتحقق بصريًا، وصل الاكتشافات إلى Draw Detections لتراكب المربعات/المعرفات على الفيديو، ثم أرسل الصورة الناتجة إلى Show Image لمعاينة النتائج مباشرة.

• صدّر النتائج المجمّعة للتقارير باستخدام Data to JSON أو CSV Export عبر مخرج Tracking Data.

• إذا كانت الاكتشافات مضطربة، فكّر في وضع أنبوب تلطيف قصير قبل التتبع (مثلاً معالجة صورة خفيفة لإزالة الضوضاء) لضمان ثبات معرفات التتبع.

🛠️ استكشاف الأخطاء وإصلاحها

• لا توجد انتقالات مسجَّلة: تأكد أن Rectangle - ID List يحتوي معرفات تتبع مستقرة عبر الإطارات (المعرفات غير المستقرة تمنع اكتشاف تغيّر المناطق).

• تخصيص المنطقة غير صحيح: تأكد أن إحداثيات المضلعات تتماشى مع رؤية الكاميرا؛ استخدم Image ROI Polygon Multi لإعادة رسم المضلعات على الصورة الفعلية.

• العدادَات لا تُعاد إلى الصفر: تأكد أن مدخل Reset Tracking Log يتلقى إشارة TRUE (مثلاً من Logic Input أو كتلة تحكم أخرى).

• تسميات نوع المركبة مفقودة: تُجمّع أعداد المسارات حسب نوع المركبة عند توفر هذه البيانات الوصفية؛ تأكد أن المتتبّع يخرج الفئة/النوع مع المعرفات.