> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/arabic/alblwkat-alwzyfyh/blocks-reference/ai-blocks/traffic-intersection-analysis.md).

# Traffic Intersection Analysis

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

## 📥 المدخلات (sockets) <a href="#inputs" id="inputs"></a>

* `Rectangle - ID List` — أرسل هنا الكائنات المتتبعة (مربعات الاحتواء مع معرفات التتبع).
* `Polygon Areas` — قدم منطقة أو أكثر متعددة الأضلاع التي تُعرِّف مناطق التقاطع المراد مراقبتها.
* `Reset Tracking Log` — مدخل منطقي (Boolean) لمسح سجل التتبع والتعدادات المخزنة.

## 📤 المخرجات (sockets) <a href="#outputs" id="outputs"></a>

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

## 🕹️ الضوابط <a href="#controls" id="controls"></a>

* `Reset Tracking Log` — فعّل هذا المدخل (مثلاً عبر مفتاح يدوي) لإعادة تعيين جميع العدادَات والتاريخ الداخلي.
* (مناطق المضلع تُزوَّد عبر مقبس `Polygon Areas`; استخدم كتلة اختيار متعدد للمضلعات لتحديدها.)

## 🎯 الميزات الرئيسية <a href="#features" id="features"></a>

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

## ⚙️ آلية العمل (مستوى عالٍ) <a href="#how-it-works" id="how-it-works"></a>

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

## 📝 تعليمات الاستخدام <a href="#usage" id="usage"></a>

1. أرسل الاكتشافات المتتبعة إلى مدخل `Rectangle - ID List`. استخدم متتبّعًا يُنتج مربعات مع معرفات مستقرة.
2. حدِّد مناطق التقاطع بمضلعات ووصلها إلى مدخل `Polygon Areas`.
3. لمسح العدّادات والتاريخ في أي وقت، أرسل إشارة TRUE إلى مدخل `Reset Tracking Log`.
4. اطّلع على إحصاءات المسارات الحية من مخرج `Tracking Data` واستخدمها للعرض أو التسجيل أو التصدير.

## 💡 نصائح وحيل <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* استخدم `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`.
* إذا كانت الاكتشافات مضطربة، فكّر في وضع أنبوب تلطيف قصير قبل التتبع (مثلاً معالجة صورة خفيفة لإزالة الضوضاء) لضمان ثبات معرفات التتبع.

## 🛠️ استكشاف الأخطاء وإصلاحها <a href="#troubleshooting" id="troubleshooting"></a>

* لا توجد انتقالات مسجَّلة: تأكد أن `Rectangle - ID List` يحتوي معرفات تتبع مستقرة عبر الإطارات (المعرفات غير المستقرة تمنع اكتشاف تغيّر المناطق).
* تخصيص المنطقة غير صحيح: تأكد أن إحداثيات المضلعات تتماشى مع رؤية الكاميرا؛ استخدم `Image ROI Polygon Multi` لإعادة رسم المضلعات على الصورة الفعلية.
* العدادَات لا تُعاد إلى الصفر: تأكد أن مدخل `Reset Tracking Log` يتلقى إشارة TRUE (مثلاً من `Logic Input` أو كتلة تحكم أخرى).
* تسميات نوع المركبة مفقودة: تُجمّع أعداد المسارات حسب نوع المركبة عند توفر هذه البيانات الوصفية؛ تأكد أن المتتبّع يخرج الفئة/النوع مع المعرفات.