HeatMap

هذه الدالة البلوكية تقوم بتصوّر الأماكن التي يتراكم فيها الحركة مع مرور الوقت ضمن مجال رؤية ثابت. تنشئ تراكباً لونياً يوضح المناطق ذات الحركة المتكررة — مفيد للمراقبة، تحليل الحركة المرورية، أو إنشاء خرائط حرارة للنشاط.

📥 المدخلات

• Image Any صورة (رمادية أو ملونة) أو تدفق إطارات لتحليل الحركة.

📤 المخرجات

• Image Any صورة ملونة مع تراكب خريطة حرارة يُبرز المناطق ذات الحركة المتكررة.

🕹️ الضوابط

• Threshold يضبط حساسية الكشف عن المقدمة. قيم أعلى تتجاهل التغييرات الصغيرة وتركز على الحركة الأقوى.

• MaxValue يحدد مقدار الإضافة التي يضيفها كل حدث حركة إلى خريطة الحرارة المتراكمة. قيم أكبر تزيد من مساهمة كل حدث.

• Alpha يضبط وزن الإطار الأول الأصلي عند مزجه مع خريطة الحرارة الملونة. قيم أقل تجعل التراكب الملون أقوى.

• Beta يضبط وزن خريطة الحركة الملونة المتراكمة عند المزج. قيم أعلى تجعل خريطة الحرارة أكثر بروزاً.

⚙️ آلية العمل

• عند التشغيل الأول، يقوم البلوك بالتقاط الإطار الأول واحتفاظه كمرجع للخلفية.

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

• بكسلات الحركة المكتشفة تتراكم في صورة داخلية واحدة بمرور الوقت.

• تُلوَّن الصورة المتراكمة وتُمزج مع الإطار الأول المحفوظ باستخدام ضوابط Alpha و Beta لإنتاج التراكب النهائي.

• يستمر التراكم حتى يتوقف التشغيل أو يتم إعادة تعيين البلوك.

🎯 المزايا

• تراكم مستمر لإنشاء خرائط حرارة طويلة المدى للحركة.

• مجموعة تحكم بسيطة لتحقيق توازن بين الحساسية وقوة التصور.

• تراكب في الوقت الحقيقي لرؤية أماكن النشاط الأكبر داخل المشهد.

• دعم إعادة التعيين الصارم لمسح البيانات المتراكمة بين التشغيلات.

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

1. أدخل تدفق كاميرا مباشر أو إطارات فيديو إلى مدخل Image Any.

2. اضبط Threshold للتركيز على الحركة المهمة وتجاهل الضوضاء.

3. عدّل MaxValue لتحديد مدى مساهمة كل حدث في خريطة الحرارة.

4. استخدم Alpha و Beta لموازنة الرؤية بين المشهد الأصلي وخريطة الحرارة الملونة.

5. أوقف أو أعد تعيين التشغيل عندما تريد مسح الخريطة المتراكمة.

💡 نصائح وحيل

• لمصادر الكاميرا الحية، اقترن بهذا البلوك مع Camera USB أو Camera IP (ONVIF) أو Stream Reader لتغذية الإطارات المستمرة.

• إذا كانت الإطارات كبيرة وتحتاج فقط لمعاينة عامة، أضف Image Resize قبل هذا البلوك لتقليل المعالجة وتسريع التراكم.

• للتركيز على منطقة معينة، اقصّ باستخدام Image ROI أو Image ROI Select قبل تغذية الإطارات.

• إذا كنت تفضل قناع مقدمة منفصل أو نماذج خلفية إضافية، جرّب الجمع مع Background Subtractor للكشف عن المقدمة قبل التراكم.

• استخدم Show Image لمعاينة التراكب مباشرة في واجهة المستخدم.

• احفظ النتائج دورياً باستخدام Image Logger أو سجّل الجلسات مع Record Video لتحليل لاحق.

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

• إذا أظهرت خريطة الحرارة ضوضاء زائدة، زِد قيمة Threshold وفكّر في المعالجة المسبقة مثل Blur أو Denoising.

• إذا نمت مناطق الحركة بسرعة كبيرة، خفض MaxValue أو أعد تشغيل/إعادة تعيين التشغيل دورياً لمسح التراكم القديم.

• إذا كان التراكب باهتاً أو قوياً جداً، عدّل Alpha و Beta لتحقيق التوازن المرئي المطلوب.

• إذا لم يتم اكتشاف أي حركة، تأكد أن الإطارات المدخلة تتغير وليست متطابقة؛ جرّب تغذية كاميرا حية مثل Camera USB للتأكد من عمل البلوك.