> 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/shape-analysis/minimum-ellipse.md).

# Minimum Ellipse

Esta función calcula y dibuja la elipse mínima que encierra una forma (contorno) proporcionada. Devuelve un resultado visual y parámetros numéricos de la forma útiles para medición, alineación o procesamiento posterior.

## 📥 Entradas (sockets)

`Image Any`\
La imagen sobre la que se dibujará la elipse (socket de entrada). Proporcione una imagen copiables para que la salida visual se preserve.

`Contour`\
El contorno (forma) que se desea encerrar con la elipse mínima (socket de entrada).

## 📤 Salidas (sockets)

`Image`\
La imagen con la elipse ajustada dibujada para inspección visual (socket de salida).

`Center`\
La posición central de la elipse ajustada como un punto (socket de salida).

`Radius1`\
Uno de los radios de la elipse (socket de salida).

`Radius2`\
El otro radio de la elipse (socket de salida).

`Angle`\
El ángulo de rotación de la elipse en grados (socket de salida).

## 🕹️ Controles

Este bloque no tiene controles interactivos. Se ejecuta tan pronto como se proporcionen entradas válidas.

## 🎯 Características

* Genera una superposición visual que muestra la elipse ajustada sobre la imagen de entrada para verificación sencilla.
* Devuelve parámetros geométricos (centro, dos radios, ángulo) útiles para mediciones, clasificación o lógica posterior.
* Funciona con cualquier contorno válido extraído en pasos de procesamiento anteriores.

## 📝 Cómo usar

1. Proporcione una imagen en `Image Any`.
2. Proporcione el contorno que desea analizar en `Contour`. Los formatos típicos de contorno provienen de bloques de búsqueda de contornos.
3. Lea el resultado visual en `Image` y los valores numéricos en `Center`, `Radius1`, `Radius2` y `Angle` para el procesamiento posterior.

## ⚙️ Qué hace al ejecutarse

El bloque ajusta una elipse que encierra de forma mínima el contorno proporcionado, dibuja la elipse en una copia de la imagen de entrada y entrega la imagen junto con los parámetros numéricos de la elipse.

## 💡 Tips and Tricks

* Si necesita contornos a partir de una imagen, use `Find Contour` o `Find Object` antes de este bloque para generar la entrada `Contour`.
* Use `Approximate Contour` para simplificar contornos complejos antes de ajustar la elipse; esto suele dar parámetros más estables y limpios.
* Aplique `Image Threshold`, `Image Adaptive Threshold` o `Blur` como preprocesado para mejorar la extracción de contornos en imágenes con ruido.
* Use `Fill Contour` para generar formas sólidas a partir de contornos basados en bordes cuando eso ayude en el procesamiento posterior.
* Compare formas usando `Minimum Circle` o `Minimum Rotated Rectangle` si desea alternativas de geometría de encuadre más simples.
* Visualice resultados con `Show Image` o guárdelos con `Image Write` / `Image Logger` para registros e informes.
* Combine con `Measure Position Distance` si necesita distancias entre centros de elipses u otros puntos de referencia.

## 🛠️ Solución de problemas

* Si la elipse parece incorrecta, asegúrese de que el `Contour` proporcionado sea válido (cerrado y con suficientes puntos). Pruebe a simplificar el contorno con `Approximate Contour`.
* Si no se genera ningún contorno en etapas anteriores, confirme que se aplicaron pasos de preprocesado como thresholding o blur para que los bloques de búsqueda de contornos puedan detectar formas.
* Si los radios o el ángulo devueltos fluctúan entre fotogramas, aplique suavizado o use bloques de memoria para estabilizar las mediciones en el tiempo.