Detect Reference

Este bloque de función busca una imagen de referencia dentro de una imagen más grande y devuelve resultados visuales y numéricos de la coincidencia. Es útil cuando quieres encontrar automáticamente dónde aparece un objeto conocido en una escena, incluso si está rotado, redimensionado o reflejado.

📥 Entradas

• Image La imagen de entrada donde se buscará la referencia (escena principal). Es un socket de entrada.

• Reference La imagen del objeto de referencia que se desea encontrar dentro de la imagen principal. Es un socket de entrada.

• Mask Máscara opcional para limitar el área de búsqueda o ignorar partes de la referencia. Es un socket de entrada.

📤 Salidas

• Image Any Imagen de salida con anotaciones visuales que muestran las coincidencias detectadas (si el dibujo está habilitado). Es un socket de salida.

• Object Positions Coordenadas del centro de cada instancia detectada. Es un socket de salida.

• Object Count Número total de instancias detectadas. Es un socket de salida.

• Rectangle Coordinates Coordenadas de los rectángulos delimitadores para cada detección. Es un socket de salida.

• Match Percentage Confianza o puntuación de coincidencia por detección. Es un socket de salida.

🕹️ Controles

• Match Threshold % Control deslizante para eliminar coincidencias de baja confianza. Valores más altos reducen falsos positivos.

• Down-size Control deslizante para reducir el tamaño de la imagen y acelerar el procesamiento. Imágenes más pequeñas son más rápidas pero pueden perder detalles finos.

• Rotations Control deslizante que determina cuántas divisiones angulares se prueban (más divisiones aumentan la tolerancia a rotación pero incrementan el tiempo).

• Sweep Angle Selector de rango que establece la barrida de rotación (ángulo inicial y final) que se probará durante la búsqueda.

• Include Flipped Casilla para incluir una versión reflejada horizontalmente de la referencia en la búsqueda (útil para objetos espejo).

• Method Menú desplegable para elegir el método de estimación de coincidencia; las opciones ofrecen intercambios entre precisión y comportamiento.

• Color Mode Menú desplegable para alternar entre comparación en escala de grises o en color completo (BGR). El modo BGR suele ser más preciso para referencias con textura o color.

🎨 Características

• Tolerancia a rotación: busca a través de un rango de ángulos para encontrar instancias rotadas.

• Control de escala/rendimiento: Down-size permite sacrificar exactitud por velocidad.

• Búsqueda reflejada opcional: encuentra apariencias espejadas activando Include Flipped.

• Soporte de máscara: usa Mask para ignorar partes de la referencia o de la escena.

• Modo consciente de color: elige entre coincidencia en escala de grises o BGR para mejorar resultados con referencias coloridas.

• Salidas visuales y numéricas: imagen anotada, puntos centrales, rectángulos delimitadores, conteos y porcentajes de coincidencia.

⚙️ Cómo funciona

• El bloque puede reducir opcionalmente el tamaño de las imágenes con Down-size para acelerar el procesamiento.

• La referencia se prueba en múltiples divisiones de rotación definidas por Rotations y Sweep Angle.

• Si Include Flipped está activado, también se prueba la referencia reflejada.

• El Method seleccionado y el Color Mode determinan cómo se puntúan las coincidencias candidatas.

• Las coincidencias que cumplen o superan Match Threshold % se reportan y, si está habilitado, se dibujan en la imagen de salida.

• Los resultados se devuelven como imagen anotada, lista de coordenadas centrales, conteo, coordenadas de rectángulos y porcentaje(s) de coincidencia.

📝 Instrucciones de uso

1. Conecta la imagen de la escena a Image y la muestra de referencia a Reference. Opcionalmente, conecta una Mask para restringir áreas de búsqueda.

2. Comienza con ajustes moderados: pon Match Threshold % entre 50–70 y mantén bajos Rotations y Down-size.

3. Revisa los resultados usando Image Any anotada y las salidas Object Positions / Object Count.

4. Ajusta controles según sea necesario: aumenta Rotations para objetos muy rotados, reduce Down-size para mayor precisión o cambia Color Mode a BGR para coincidencias sensibles al color.

5. Usa la máscara para reducir falsos positivos cuando la referencia tenga fondo o patrones repetitivos.

💡 Consejos y trucos

• Si tus imágenes son muy grandes, añade Image Resize o Image Resizer antes de este bloque para acelerar el procesamiento sin perder el detalle necesario.

• Recorta el área de interés con Image ROI Select para reducir el área de búsqueda y los falsos positivos.

• Preprocesa con Blur, Denoising o Contrast Optimization para reducir ruido y mejorar la estabilidad de la coincidencia.

• Utiliza Image Threshold o Background Removal (RMBG-1.4) cuando la referencia tenga una separación clara entre primer plano y fondo.

• Vista previa e inspecciona detecciones con Show Image para abrir un visor de imagen más grande.

• Superpone rectángulos o etiquetas con Draw Detections si necesitas una visualización personalizada para informes o procesamiento posterior.

• Registra ejemplos detectados con Image Logger para curación de datasets o depuración.

(pista: combinar estos bloques puede acelerar la coincidencia y reducir falsos positivos — por ejemplo, recorta con Image ROI Select, mejora contraste con Contrast Optimization, y luego ejecuta este bloque.)

🛠️ Solución de problemas

• No se encuentran coincidencias: prueba bajando Match Threshold %, aumenta Rotations si el objeto puede estar rotado, o cambia Color Mode a BGR.

• Demasiados falsos positivos: sube Match Threshold %, proporciona una Mask más ajustada o recorta la entrada con Image ROI Select.

• Rendimiento lento: reduce Rotations o aumenta Down-size. Activa Include Flipped solo cuando sea necesario.

• Coincidencias parciales o inconsistentes: usa una referencia de mayor calidad (clara, con alto contraste), preprocesa con Blur o Contrast Optimization, o prueba el modo BGR.

Si los problemas persisten, combina pequeños pasos de preprocesado (resize → denoise → crop) para hacer que la referencia destaque del fondo.