> 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/ai-blocks/traffic-intersection-analysis.md).

# Traffic Intersection Analysis

Bu fonksiyon bloğu, bir kavşağın belirlenen alanları içinden geçen araç hareketlerini saymanıza ve kaydetmenize yardımcı olur. İzlenen tespitleri ve çokgen alanları rota istatistiklerine dönüştürür (örneğin "1-2", bir aracın alan 1'den alan 2'ye geçtiğini belirtir). İnceleme senaryolarına kolay entegrasyon için tasarlanmış olup, dışa aktarım veya görüntüleme için özetlenmiş takip verisini çıkış verir.

## 📥 Girdiler (soketler)

* `Rectangle - ID List` — İzlenen tespitleri sağlayın (izleme ID'li sınırlayıcı dikdörtgenler).
* `Polygon Areas` — İzlenecek kavşak bölgelerini tanımlayan bir veya daha fazla çokgen alan sağlayın.
* `Reset Tracking Log` — Tüm saklanan izleme geçmişini ve sayıcıları temizlemek için Boolean giriş.

## 📤 Çıktılar (soketler)

* `Tracking Data` — Alan çiftleri arasından geçen her araç türü için sayıları gösteren (örneğin "1-2": {"car": 3, "bus": 1}) toplu rota sayımlarını içeren yapılandırılmış veri.

## 🕹️ Kontroller

* `Reset Tracking Log` — Tüm sayaçları ve dahili geçmişi sıfırlamak için bu girişi tetikleyin (ör. manuel bir anahtar ile).
* (Çokgen alanlar `Polygon Areas` soketi üzerinden sağlanır; alanları tanımlamak için bir polygon selection bloğu kullanın.)

## 🎯 Temel Özellikler

* İzlenen sınırlayıcı kutuları ve takip ID'lerini kullanarak tespitleri kareler arası ilişkilendirir ve alan geçişlerini tespit eder.
* Her izlenen nesne için kısa bir pozisyon geçmişi tutarak gürültülü pozisyonları dengeleyip, nesnenin hangi çokgen alanda olduğunu karara bağlamadan önce stabil bilgi kullanır.
* Araç türüne göre gruplandırılmış rota bazlı istatistikler üretir (alan→alan geçişler).
* Birden çok çokgen alanı destekler (her alan birçok köşe noktasına sahip olabilir).
* Talep üzerine geçmişi ve sayıcıları temizlemek için sıfırlama seçeneği sunar.

## ⚙️ Çalışma Mantığı (yüksek seviye)

* Blok, ID'leri olan izlenmiş dikdörtgenler listesini ve isteğe bağlı olarak araç sınıf isimlerini kabul eder.
* Her izlenen öge için temsilci bir nokta (sınırlayıcı kutunun alt-orta noktası) hesaplanır ve o ID için kısa bir nokta geçmişi tutulur.
* Temsilci nokta (son pozisyonların ortalaması) her sağlanan çokgen alanına karşı test edilerek o aracın güncel alanı belirlenir.
* Bir aracın alanı değiştiğinde (örneğin alan 1'den alan 2'ye), geçiş kaydedilir ve ilgili araç türü için rota sayacı arttırılır.
* Toplu rota sayımları `Tracking Data` soketi üzerinden yapılandırılmış veri olarak çıkarılır.
* `Reset Tracking Log` girişi etkinleştirildiğinde tüm saklanan geçmişler ve sayıcılar silinir.

## 📝 Kullanım Talimatları

1. İzlenen tespitleri `Rectangle - ID List` girişine verin. Kararlı ID'ler üreten bir tracker kullanın.
2. Kavşak bölgelerini çokgenlerle tanımlayın ve bunları `Polygon Areas` girişine bağlayın.
3. Sayaçları ve geçmişi herhangi bir zamanda temizlemek için `Reset Tracking Log` girişine TRUE sinyali gönderin.
4. Canlı rota istatistiklerini `Tracking Data` çıkışından okuyun; bunları görüntüleme, kayıt veya dışa aktarma için kullanın.

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

* `Object_Detection_Tracker` kullanarak `Rectangle - ID List` girişini üretin. Bu blok, rota analizleri için ideal olan izlenmiş dikdörtgenleri ve ID'leri sağlar.
* Çokgen alanları çizip kaydetmek için `Image ROI Polygon Multi` kullanın ve onun `Polygons` çıktısını bloğun `Polygon Areas` girişine bağlayın. Bu blok, birden fazla kavşak bölgesini görsel olarak tanımlamayı kolaylaştırır.
* Sayaçları yeniden başlatmak istediğinizde (vardiya değişimleri, test denemeleri vb.) `Logic Input` ile manuel bir tetik sağlamak için `Reset Tracking Log` kullanın.
* Görsel doğrulama için tespitleri `Draw Detections` ile üst üste bindirip sonucu `Show Image`e göndererek canlı önizleme yapın.
* Özetlenen sonuçları raporlama için `Tracking Data` çıkışını `Data to JSON` veya `CSV Export` ile dışa aktarın.
* Eğer tespitler gürültülü ise, izleyiciye girmeden önce kısa bir yumuşatma hattı uygulamayı (örn. hafif gürültü giderme filtreleri) düşünün; böylece izleme ID'leri daha stabil kalır.

## 🛠️ Sorun Giderme

* Geçiş kaydı yok: `Rectangle - ID List` içinde kareler arasında kararlı takip ID'lerinin bulunduğunu doğrulayın (kararsız ID'ler alan değişikliklerini algılamayı engeller).
* Yanlış alan atanması: Çokgen koordinatlarının kamera görünümüyle hizalı olduğundan emin olun; çokgenleri gerçek görüntü üzerinde yeniden çizmek için `Image ROI Polygon Multi` kullanın.
* Sayaçlar temizlenmiyor: `Reset Tracking Log` girişinin TRUE sinyali aldığını doğrulayın (örn. bir `Logic Input` veya başka bir kontrol bloğundan).
* Araç türü etiketleri eksik: Rota sayımları, bu meta veri sağlandığında araç türüne göre gruplanır; tracker'ınızın ID ile birlikte sınıf/tür bilgisini çıkardığından emin olun.