Find Object

Este bloque de función te ayuda a localizar una imagen plantilla más pequeña dentro de una imagen mayor usando métodos de coincidencia seleccionables y un control deslizante de sensibilidad ajustable. Proporciona retroalimentación visual y salidas detalladas de ubicación para ayudar en inspección, conteo y procesamiento posterior.

📥 Entradas

Este bloque acepta las siguientes entradas:

• Main Image Acepta la imagen donde se realizará la búsqueda del objeto.

• Object Image Acepta la imagen plantilla (única o lista) del objeto a encontrar.

📤 Salidas

Este bloque proporciona las siguientes salidas:

• Image Any Resultado visual donde se pueden resaltar las coincidencias detectadas.

• Object Positions Coordenadas de los centros de los objetos detectados (múltiples).

• Object Count Número de objetos detectados.

• Rectangle Coordinates Rectángulos delimitadores para cada objeto detectado (múltiples).

🕹️ Controles

• Method Elige el algoritmo de template matching a utilizar de una lista de métodos disponibles.

• Match Threshold % Ajusta el deslizador para controlar qué tan estricta debe ser la coincidencia. Valores más altos reducen falsos positivos pero pueden omitir coincidencias débiles.

• Result Muestra la cuenta de objetos detectados para una retroalimentación rápida.

🎯 Características clave

• Superposición visual de las detecciones sobre la imagen de entrada para verificación rápida.

• Múltiples conexiones de salida que ofrecen resultados tanto visuales como numéricos para procesamiento posterior.

• Funciona con una única plantilla o con una lista de plantillas para encontrar la mejor coincidencia disponible.

📝 Cómo usar

1. Proporciona una imagen fuente en la entrada Main Image.

2. Proporciona una plantilla o lista de plantillas en la entrada Object Image.

3. Selecciona un Method que se adapte a las características de tu escena y plantilla.

4. Ajusta el deslizador Match Threshold % hasta que la precisión de detección sea aceptable.

5. Inspecciona los resultados usando la salida visual y los sockets numéricos.

⚙️ Qué sucede al ejecutarlo

Al ejecutarse, el bloque busca en la Main Image regiones que coincidan con la Object Image según el método y el umbral seleccionados. Devuelve una visualización, las posiciones centrales de las detecciones, su conteo y los rectángulos delimitadores.

💡 Consejos y trucos

• Para reducir falsas coincidencias en imágenes ruidosas, pasa la imagen por Blur o Denoising antes de este bloque.

• Si las plantillas y la imagen principal difieren en tamaño, usa Image Resize para estandarizar tamaños y obtener coincidencias más fiables.

• Para enfocar la búsqueda solo en un área específica, recorta la imagen primero con Image ROI Select y alimenta la imagen recortada a este bloque.

• Después de la detección, usa Rectangles in Rectangle para filtrar detecciones fuera de una región de interés.

• Visualiza e inspecciona las detecciones con el bloque Show Image para confirmar resultados de forma interactiva.

• Guarda fotogramas interesantes o fallos usando Image Logger o Image Write para auditoría y ajuste.

• Para escenas complejas o muchas clases de objetos, considera combinar con los bloques Object Detection o Object Detection - Custom cuando el template matching se vuelva poco fiable.

🛠️ Solución de problemas

• Si no se encuentran objetos, intenta bajar el Match Threshold % o mejorar el contraste de la plantilla con preprocesos como Contrast Optimization o Adjust Colors.

• Si aparecen muchos falsos positivos, aumenta el Match Threshold % y considera filtrar la imagen con HSV Filter o Image Threshold para resaltar el objeto.

• Si los resultados varían entre imágenes, asegúrate de que las plantillas sean consistentes con la apariencia esperada (escala, rotación, iluminación) o usa múltiples plantillas mediante la lista de entrada Object Image.