Traffic Intersection Analysis

Esta función cuenta y registra los movimientos de vehículos a través de áreas definidas de una intersección. Convierte detecciones rastreadas y áreas poligonales en estadísticas de rutas (por ejemplo, "1-2" significa que un vehículo se movió del área 1 al área 2). Diseñada para integrarse fácilmente en un escenario de inspección, entrega datos de seguimiento resumidos listos para exportar o mostrar.

📥 Inputs (sockets)

• Rectangle - ID List — Proporciona detecciones rastreadas (rectángulos delimitadores con tracking IDs).

• Polygon Areas — Proporciona uno o más polígonos que definen las zonas de la intersección a monitorear.

• Reset Tracking Log — Entrada booleana para borrar todo el historial de seguimiento y los conteos almacenados.

📤 Outputs (sockets)

• Tracking Data — Conteos agregados por ruta (formato tipo JSON) que muestran cuántos vehículos de cada tipo pasaron entre pares de áreas (por ejemplo, "1-2": {"car": 3, "bus": 1}).

🕹️ Controls

• Reset Tracking Log — Activa esta entrada (por ejemplo con un interruptor manual) para reiniciar todos los contadores e historial interno.

• (Las áreas poligonales se proporcionan a través del socket Polygon Areas; usa un bloque de selección de polígonos para definirlas.)

🎯 Características clave

• Usa cajas delimitadoras rastreadas y tracking IDs para asociar detecciones entre fotogramas y detectar transiciones entre áreas.

• Mantiene un historial corto de posiciones recientes por cada objeto rastreado para estabilizar posiciones ruidosas antes de decidir en qué polígono se encuentra el objeto.

• Produce estadísticas basadas en rutas (transiciones área-a-área) agrupadas por tipo de vehículo.

• Soporta múltiples áreas poligonales (cada área puede tener muchos vértices).

• Opción de reset para borrar historial y contadores bajo demanda.

⚙️ Mecanismo de funcionamiento (alto nivel)

• El bloque acepta una lista de rectángulos rastreados con IDs y (opcionalmente) nombres/clases de vehículo.

• Para cada elemento rastreado calcula un punto representativo (centro inferior del rectángulo) y mantiene un historial corto de puntos recientes para ese ID.

• El punto representativo (promediado sobre posiciones recientes) se prueba contra cada área poligonal suministrada para determinar el área actual del vehículo.

• Cuando el área de un vehículo cambia (por ejemplo, de área 1 a área 2), la transición se registra y se incrementa el contador de ruta correspondiente para ese tipo de vehículo.

• Los conteos agregados por ruta se emiten como datos estructurados a través del socket Tracking Data.

• Activar la entrada Reset Tracking Log borra todos los historiales y contadores almacenados.

📝 Instrucciones de uso

1. Proporciona las detecciones rastreadas al input Rectangle - ID List. Usa un tracker que entregue rectángulos con IDs estables.

2. Define las regiones de la intersección con polígonos y conéctalas a Polygon Areas.

3. Para limpiar contadores e historial en cualquier momento, envía una señal TRUE al input Reset Tracking Log.

4. Lee las estadísticas de rutas en vivo desde la salida Tracking Data y úsalas para mostrar, registrar o exportar.

💡 Consejos y recomendaciones

• Usa Object_Detection_Tracker para generar la entrada Rectangle - ID List. Este bloque entrega rectángulos rastreados y IDs ideales para el análisis de rutas.

• Dibuja y guarda las áreas poligonales con Image ROI Polygon Multi y conecta su salida Polygons al input Polygon Areas. Ese bloque facilita definir zonas de intersección visualmente.

• Usa Logic Input para proporcionar un disparador manual a Reset Tracking Log si quieres reiniciar el conteo en intervalos conocidos (cambios de turno, pruebas, etc.).

• Para verificación visual, conecta las detecciones a Draw Detections para superponer rectángulos/IDs en el video, y luego envía la imagen resultante a Show Image para previsualizar en vivo.

• Exporta resultados resumidos para reportes con Data to JSON o CSV Export usando la salida Tracking Data.

• Si las detecciones son ruidosas, considera aplicar un preprocesado ligero antes del tracker (por ejemplo, filtros de reducción de ruido) para mantener la estabilidad de los IDs.

🛠️ Solución de problemas

• No se registran transiciones: verifica que Rectangle - ID List contenga IDs de tracking estables entre fotogramas (IDs inestables impiden detectar cambios de área).

• Asignación de área incorrecta: confirma que las coordenadas del polígono estén alineadas con la vista de la cámara; usa Image ROI Polygon Multi para redibujar polígonos sobre la imagen real.

• Los contadores no se borran: asegúrate de que la entrada Reset Tracking Log reciba una señal TRUE (por ejemplo desde Logic Input u otro bloque de control).

• Faltan etiquetas de tipo de vehículo: los conteos por ruta se agrupan por tipo de vehículo cuando esa metadata está disponible; verifica que tu tracker entregue la clase/tipo junto con los IDs.