> 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/turkish/fonksiyon-bloklari/blocks-reference/image-transformations/transformation-filters/heatmap.md).

# HeatMap

Bu fonksiyon bloğu, sabit bir görüş alanında zaman içinde biriken hareketleri görselleştirir. Sık hareket eden alanları gösteren renkli bir kaplama oluşturur; gözetim, trafik analizi veya etkinlik ısı haritalaması için kullanışlıdır.

## 📥 Girdiler

`Image Any` Gri tonlu veya renkli, hareket analizine tabi tutulacak görüntü akışı.

## 📤 Çıktılar

`Image Any` Sık hareket eden bölgeleri vurgulayan ısı haritası kaplamalı renkli görüntü.

## 🕹️ Kontroller

`Threshold` Ön plan tespiti hassasiyetini ayarlar. Daha yüksek değerler küçük değişiklikleri görmezden gelerek daha güçlü hareketlere odaklanır.

`MaxValue` Her tespit edilen hareket olayının birikmiş ısı haritasına ne kadar katkıda bulunacağını kontrol eder. Daha büyük değerler her olayın etkisini artırır.

`Alpha` Renkli ısı haritası kaplaması uygulanırken orijinal ilk karenin ağırlığını kontrol eder. Daha düşük değerler kaplamayı daha belirgin yapar.

`Beta` Birikmiş hareket haritasının renkli hâlinin kaplama üzerindeki ağırlığını kontrol eder. Daha yüksek değerler ısı haritasını daha görünür yapar.

## ⚙️ Çalışma mekanizması

* İlk çalıştırmada blok, arka plan referansı olarak ilk kareyi yakalar ve saklar.
* Sonraki karelerde ön plan pikselleri hesaplanır ve hareket olaylarını tespit etmek için eşiklenir.
* Tespit edilen hareket pikselleri zaman içinde tek bir dahili görüntüde biriktirilir.
* Birikmiş görüntü renklendirilir ve `Alpha` ile `Beta` kontrolleri kullanılarak saklanan ilk kareyle harmanlanarak nihai kaplama oluşturulur.
* Blok, çalıştırma durdurulana veya blok sıfırlanana kadar birikime devam eder.

## 🎯 Özellikler

* Uzun vadeli hareket ısı haritaları için sürekli birikim.
* Hassasiyet ve görselleştirme güçlülüğünü dengemlemek için basit kontrol seti.
* Sahnedeki en yoğun etkinlik alanlarını gerçek zamanlı olarak gösteren kaplama.
* Çalıştırmalar arasında birikimi temizlemek için dahili hard reset desteği.

## 📝 Kullanım talimatları

1. Canlı bir kamerayı veya video kare akışını `Image Any` girişine besleyin.
2. Gürültüyü görmezden gelmek ve anlamlı hareketlere odaklanmak için `Threshold` değerini ayarlayın.
3. Her olayın ısı haritasına ne kadar katkıda bulunacağını belirlemek için `MaxValue`'yi ayarlayın.
4. Orijinal sahne ile renklendirilmiş ısı haritası arasındaki görünürlüğü ayarlamak için `Alpha` ve `Beta` değerlerini kullanın.
5. Birikmiş ısı haritasını temizlemek istediğinizde çalıştırmayı durdurun veya sıfırlayın.

## 💡 İpuçları ve Püf Noktaları

* Canlı kamera kaynakları için bu bloğu `Camera USB`, `Camera IP (ONVIF)` veya `Stream Reader` ile birlikte kullanın.
* Girdi kareleriniz büyükse ve yalnızca genel bir görünüm istiyorsanız, işlem yükünü azaltmak ve birikimi hızlandırmak için bloğun öncesine `Image Resize` ekleyin.
* Belirli bir bölgeye odaklanmak isterseniz, kareleri bu bloğa göndermeden önce `Image ROI` veya `Image ROI Select` ile kırpın.
* Ayrı bir ön plan maskesi veya ek arka plan modelleri isterseniz, birikim öncesi alternatif ön plan tespiti için `Background Subtractor` ile kombinasyon deneyin.
* Canlı önizleme için UI'da `Show Image` kullanın.
* Sonuçları periyodik olarak kaydetmek için `Image Logger` veya oturumları kaydetmek için `Record Video` kullanın.

## 🛠️ Sorun Giderme

* Isı haritası çok fazla gürültü gösteriyorsa, `Threshold` değerini artırın ve mümkünse `Blur` veya `Denoising` ile ön işleme yapın.
* Hareket alanları çok hızlı büyüyorsa, `MaxValue` değerini düşürün veya eski birikimi temizlemek için çalıştırmayı periyodik olarak sıfırlayın.
* Kaplama çok zayıf ya da çok yoğun görünüyorsa, istenen görsel dengeyi elde etmek için `Alpha` ve `Beta` değerlerini ayarlayın.
* Hiç hareket tespit edilmiyorsa, girdi karelerinin değişip değişmediğini doğrulayın; kareler aynıysa çalışmaz. Doğrulamak için `Camera USB` gibi canlı bir kaynak beslemeyi deneyin.