> 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/spanish/function-blocks/blocks-reference/detections-shapes/detectors/detect-reference.md). # 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.