Background Subtractor

Este bloque de función detecta regiones en movimiento / primer plano comparando los fotogramas actuales con un modelo de fondo aprendido. Úsalo para separar objetos en primer plano (personas, vehículos, piezas en movimiento) de un fondo estable y producir una máscara de primer plano en binario / escala de grises para análisis posteriores.

📥 Entradas (sockets)

Input Image Acepta la imagen o fotograma de vídeo a analizar (a color o en escala de grises).

📤 Salidas (sockets)

Foreground Mask Devuelve una máscara en escala de grises/binaria donde se resaltan los píxeles del primer plano.

🕹️ Controles

Method Elige el algoritmo de sustracción de fondo (por ejemplo MOG2 o KNN) desde el menú desplegable.

History Controla cuántos fotogramas anteriores se usan para construir el modelo de fondo. Valores altos hacen que el modelo se adapte más despacio.

VarThreshold Controla la sensibilidad a cambios de píxeles. Valores bajos hacen el sustractor más sensible a pequeños cambios; valores altos lo hacen menos sensible.

⚙️ Mecanismo de ejecución

Cada vez que se ejecuta el bloque:

• Usa el Method seleccionado y los ajustes actuales de History / VarThreshold.

• Si cambian los ajustes, el modelo interno de fondo se reinicializa para reflejar los nuevos parámetros.

• Procesa la Input Image entrante y genera la Foreground Mask mostrando las regiones de primer plano detectadas.

Esta máscara se actualiza fotograma a fotograma y puede ser usada por otros bloques para recuento, seguimiento o guardado.

🎯 Características

• Cambio rápido entre algoritmos mediante Method.

• Ajuste en tiempo real de parámetros con los deslizadores de History y VarThreshold para equilibrar velocidad de adaptación y estabilidad.

• Genera una máscara de primer plano lista para usar que puede conectarse a bloques de detección o análisis.

📝 Uso

1. Conecta un bloque que produzca imágenes (cámara, vídeo, o load image) a Input Image.

2. Selecciona el Method deseado y ajusta History y VarThreshold observando los resultados.

3. Usa la Foreground Mask con bloques posteriores para detección, conteo o registro.

💡 Consejos y trucos

• Para resultados ruidosos, intenta suavizar la entrada primero con Blur o reduce el ruido de alta frecuencia usando Denoising antes de enviar la imagen a este bloque.

• Para eliminar pequeñas salpicaduras en la máscara, añade Morphological Transformations después de este bloque (operaciones de opening/closing).

• Si te interesa solo un área específica, recorta la entrada con Image ROI Select o Image ROI antes de sustracción de fondo para acelerar el procesamiento.

• Usa Show Image para previsualizar la Foreground Mask en un visor más grande mientras ajustas parámetros.

• Para análisis a nivel de objeto, alimenta la máscara a Blob Detector o usa Find Contour para extraer y medir los componentes detectados.

• Para anotar o resaltar detecciones en el fotograma original, combina con Draw Detections o Draw Rectangle usando las coordenadas derivadas del análisis de contornos/blobs.

• Si los fotogramas de entrada son muy grandes, inserta Image Resizer para reducir el tamaño antes y así acelerar el procesamiento.

• Guarda fotogramas o máscaras importantes con Image Logger o Image Write cuando ocurra una condición disparadora (por ejemplo, el recuento de detecciones supera un umbral).

• Usa Image Memory para congelar un fotograma y revisarlo mientras el procesamiento en vivo continúa.

(las pistas anteriores hacen referencia únicamente a la lista de bloques de función disponibles)

🛠️ Solución de problemas

• Si la máscara de primer plano es demasiado sensible (muchos píxeles parpadeantes), aumenta VarThreshold o incrementa History para que el modelo se adapte más despacio.

• Si los objetos en movimiento no se detectan de forma fiable, disminuye VarThreshold o reduce el suavizado previo.

• Si la máscara contiene ruido aislado, añade Morphological Transformations (opening) o aplica Blur en la entrada.

• Si el fondo cambia frecuentemente (iluminación, fondo en movimiento), reduce History para que el modelo se adapte más rápido, o limita el procesamiento a una ROI estable con Image ROI Select.

• Si no ves la máscara con claridad, usa Show Image para abrir la máscara en el visor de imágenes y revisarla mejor.

🔗 Combinaciones recomendadas de bloques

• Preprocesado: Blur → Background Subtractor → Morphological Transformations

• Detección focalizada: Image ROI Select → Background Subtractor → Blob Detector → Draw Detections

• Registro y revisión: Background Subtractor → Show Image (vista previa) y Image Logger o Image Write (guardar máscaras/fotogramas)

• Post-análisis: Background Subtractor → Find Contour / Measure Object Distance → Data to JSON o CSV Export

Estas combinaciones ayudan a construir canalizaciones de análisis de vídeo fiables usando los bloques disponibles.