> 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/image-transformations/transformation-filters/heatmap.md).

# HeatMap

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

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

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

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

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

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

* `Threshold` يضبط حساسية الكشف عن المقدمة. قيم أعلى تتجاهل التغييرات الصغيرة وتركز على الحركة الأقوى.
* `MaxValue` يحدد مقدار الإضافة التي يضيفها كل حدث حركة إلى خريطة الحرارة المتراكمة. قيم أكبر تزيد من مساهمة كل حدث.
* `Alpha` يضبط وزن الإطار الأول الأصلي عند مزجه مع خريطة الحرارة الملونة. قيم أقل تجعل التراكب الملون أقوى.
* `Beta` يضبط وزن خريطة الحركة الملونة المتراكمة عند المزج. قيم أعلى تجعل خريطة الحرارة أكثر بروزاً.

## ⚙️ آلية العمل <a href="#running-mechanism" id="running-mechanism"></a>

* عند التشغيل الأول، يقوم البلوك بالتقاط الإطار الأول واحتفاظه كمرجع للخلفية.
* للإطارات اللاحقة، يتم حساب بكسلات المقدمة وتطبيق العتبة للكشف عن أحداث الحركة.
* بكسلات الحركة المكتشفة تتراكم في صورة داخلية واحدة بمرور الوقت.
* تُلوَّن الصورة المتراكمة وتُمزج مع الإطار الأول المحفوظ باستخدام ضوابط `Alpha` و `Beta` لإنتاج التراكب النهائي.
* يستمر التراكم حتى يتوقف التشغيل أو يتم إعادة تعيين البلوك.

## 🎯 المزايا <a href="#features" id="features"></a>

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

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

1. أدخل تدفق كاميرا مباشر أو إطارات فيديو إلى مدخل `Image Any`.
2. اضبط `Threshold` للتركيز على الحركة المهمة وتجاهل الضوضاء.
3. عدّل `MaxValue` لتحديد مدى مساهمة كل حدث في خريطة الحرارة.
4. استخدم `Alpha` و `Beta` لموازنة الرؤية بين المشهد الأصلي وخريطة الحرارة الملونة.
5. أوقف أو أعد تعيين التشغيل عندما تريد مسح الخريطة المتراكمة.

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

* لمصادر الكاميرا الحية، اقترن بهذا البلوك مع `Camera USB` أو `Camera IP (ONVIF)` أو `Stream Reader` لتغذية الإطارات المستمرة.
* إذا كانت الإطارات كبيرة وتحتاج فقط لمعاينة عامة، أضف `Image Resize` قبل هذا البلوك لتقليل المعالجة وتسريع التراكم.
* للتركيز على منطقة معينة، اقصّ باستخدام `Image ROI` أو `Image ROI Select` قبل تغذية الإطارات.
* إذا كنت تفضل قناع مقدمة منفصل أو نماذج خلفية إضافية، جرّب الجمع مع `Background Subtractor` للكشف عن المقدمة قبل التراكم.
* استخدم `Show Image` لمعاينة التراكب مباشرة في واجهة المستخدم.
* احفظ النتائج دورياً باستخدام `Image Logger` أو سجّل الجلسات مع `Record Video` لتحليل لاحق.

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

* إذا أظهرت خريطة الحرارة ضوضاء زائدة، زِد قيمة `Threshold` وفكّر في المعالجة المسبقة مثل `Blur` أو `Denoising`.
* إذا نمت مناطق الحركة بسرعة كبيرة، خفض `MaxValue` أو أعد تشغيل/إعادة تعيين التشغيل دورياً لمسح التراكم القديم.
* إذا كان التراكب باهتاً أو قوياً جداً، عدّل `Alpha` و `Beta` لتحقيق التوازن المرئي المطلوب.
* إذا لم يتم اكتشاف أي حركة، تأكد أن الإطارات المدخلة تتغير وليست متطابقة؛ جرّب تغذية كاميرا حية مثل `Camera USB` للتأكد من عمل البلوك.