> 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/match-shapes.md).

# Match Shapes

Este bloque de función compara dos formas (contornos) y devuelve una puntuación de similitud entre 0 y 1. Es útil cuando quieres una medida numérica única de cuán parecidos son dos contornos: los valores más cercanos a 1 indican mayor similitud.

## 📥 Entradas

`Contour` — Primer contorno a comparar (referencia).

`Contour` — Segundo contorno a comparar (consulta).

## 📤 Salidas

`Resemblence` — Un número entre 0 y 1 que expresa cuán similares son los dos contornos (mayor = más similar).

## 🕹️ Controles

`Resemblence` — Etiqueta de solo lectura que muestra el valor actual de similitud para una retroalimentación rápida en la UI.

## ⚙️ Mecanismo de ejecución

Cuando el bloque se ejecuta, acepta dos entradas de contorno, las convierte en representaciones comparables y calcula una única puntuación de similitud. La puntuación se presenta tanto como valor de salida como en la etiqueta `Resemblence` del bloque para que veas los resultados de inmediato.

## 🎯 Features

* Puntuación numérica rápida de similitud entre dos contornos.
* Retroalimentación en la UI mediante una etiqueta `Resemblence` en vivo.
* Funciona con contornos producidos por otros bloques de análisis y detección de formas.

## 📝 How to use

1. Proporciona dos contornos en las entradas. Los contornos pueden provenir de bloques detector o de procesamiento de contornos.
2. Ejecuta el flujo; el bloque devolverá `Resemblence` y actualizará la etiqueta para inspección instantánea.
3. Usa la salida numérica para tomar decisiones, registrar resultados o procesar más a fondo.

## 💡 Tips and Tricks

* Si solo tienes una imagen, extrae contornos primero usando el bloque `Find Contour`, y luego alimenta los contornos resultantes a este bloque.
* Para simplificar contornos complejos (reducir ruido o número de puntos) prueba `Approximate Contour` antes de la comparación; los contornos más simples suelen dar valores de similitud más estables.
* Si necesitas el contorno recortado en una imagen para comparación visual, usa `Contour to Image` y prévisualiza el resultado con `Show Image`.
* Para comparar múltiples contornos candidatos contra una referencia, combina este bloque con `Most Similar Shape` para seleccionar automáticamente la mejor coincidencia.
* Al comparar formas en regiones específicas, recorta la imagen primero usando `Image ROI Select` para que los contornos provengan del área esperada.
* Si los contornos provienen de imágenes con escalas diferentes, normaliza tamaños con `Image Resize` o convierte contornos en imágenes recortadas de las mismas dimensiones usando `Contour to Image`.

## 🛠️ Troubleshooting

* Si la `Resemblence` parece inesperadamente baja: asegúrate de que ambos contornos estén en escalas y orientaciones similares. Prueba simplificar los contornos con `Approximate Contour` o normalizar el tamaño de las imágenes.
* Si la salida es inestable entre frames, revisa el paso de extracción de contornos (por ejemplo `Find Contour`) por detecciones ruidosas y considera preprocesar con `Blur` o `Image Threshold`.
* Sin salida o entrada de contorno inválida: verifica que el bloque que produce contornos realmente devuelva datos de contorno (usa `Debug Input` o prévisualiza imágenes intermedias con `Show Image`).