> 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/object-detection-tracker.md).

# Object\_Detection\_Tracker

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

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

* `Input Image` الإطار الحالي المستخدم للعرض والسياق التتبعي.
* `Detected Rectangles` قائمة صناديق الإحاطة (bounding boxes) المكتشفة. زوّد هنا المستطيلات الناتجة عن كتلة كشف الأجسام.
* `Detected Classes` قائمة بأسماء الفئات المقابلة للكشوف الموفَّرة. تُستخدم لبناء تسمية فئة مستقرة لكل كائن متتبع.

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

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

* `Result Image` صورة مشروحة بصناديق الإحاطة، المعرفات وتسميات الفئات لكل مسار نشط.
* `Position - ID List` قائمة بمراكز مواقع الكائنات المتتبعة مع المعرفات المسندة وأسماء الفئات المستقرة.
* `Rectangle - ID List` قائمة بالمستطيلات المزاوجة مع المعرفات وأسماء الفئات المستقرة.

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

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

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

## ⚙️ آلية العمل <a href="#how-it-works" id="how-it-works"></a>

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

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

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

* تعيين معرف ثابت عبر الإطارات لكل كائن مكتشف.
* تثبيت تسمية الفئة لكل مسار بحيث تصبح التسميات مع مرور الوقت متسقة.
* إخراج نتائج مرئية إلى جانب قوائم مهيكلة للتحليلات أو التسجيل.
* مقاومة لفقدان الكشوف القصير المؤقت.
* إنشاء مسارات جديدة للكشوف التي لا تطابق مسارات قائمة وإنهاء المسارات القديمة تلقائيًا.

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

1. وصل مصدر صورة بمقبس `Input Image` (مثال: Camera USB، IP camera، تدفق أو إطارات محمّلة مسبقًا).
2. وصل بلوك كشف لتزويد `Detected Rectangles` و`Detected Classes` بالمعلومات.
3. استخدم `Result Image` لمعاينة نتيجة التتبع.
4. استخدم مخرجات `Position - ID List` و`Rectangle - ID List` لإرسالها إلى كتل لاحقة للعد أو التسجيل أو التحليلات.

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

* لتحصل على أفضل النتائج، زود هذا البلوك بكشوف موثوقة من بلوك كشف الأجسام مثل `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` قبل التتبع لتحسين جودة الكشف.

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

* لا تظهر مسارات: تأكد من أن مقابسي `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`.