Minimum Circle

Esta función encuentra y dibuja el círculo mínimo que encierra una forma dada (contorno) y devuelve el centro y el radio del círculo junto con una imagen de resultado visual. Es útil para estimar el tamaño o la posición de un objeto, o para mediciones simples basadas en la forma.

📥 Entradas

Image Any La imagen que se usará como superficie de dibujo y referencia visual para el resultado. Se devolverá una copia de esta imagen con el círculo detectado superpuesto.

Contour Una forma (contorno) que define el objeto a encerrar. Normalmente proviene de un bloque de detección de contornos o extracción de formas.

📤 Salidas

Image Una copia de la imagen de entrada con el círculo mínimo dibujado.

Center La posición del centro del círculo envolvente (x, y). Úsalo para alineación, mediciones o operaciones geométricas posteriores.

Radius El radio del círculo envolvente. Útil para estimar tamaño, establecer umbrales o activar lógica a continuación.

🕹️ Controles

Este bloque no tiene controles interactivos—solo conecta las entradas requeridas y generará las salidas cuando se ejecute.

⚙️ Mecanismo de ejecución

Al ejecutarse, el bloque recibe un contorno y una imagen. Calcula el círculo más pequeño que encierra completamente el contorno, dibuja ese círculo sobre una copia de la imagen proporcionada y devuelve la imagen anotada junto con el Center y el Radius. El bloque espera una entrada de contorno válida; si no se proporciona contorno, el resultado estará vacío o sin cambios.

🎯 Características

• Produce una imagen de resultado con el círculo envolvente dibujado para verificación visual.

• Devuelve salidas geométricas numéricas (Center, Radius) que pueden usarse en bloques posteriores para medición o lógica.

• Ligero y rápido—apto para pipelines en tiempo real cuando hay contornos disponibles.

• Funciona con cualquier bloque que produzca contornos; no requiere parámetros adicionales.

📝 Uso

1. Proporciona un contorno a la entrada Contour — normalmente el resultado de un Find Contour o un extractor de formas.

2. Proporciona una imagen a la entrada Image Any para visualización.

3. Ejecuta el escenario; el bloque devolverá la imagen anotada y las propiedades del círculo.

💡 Consejos y trucos

• Para obtener contornos, usa Find Contour o Find Object antes de este bloque.

• Si el contorno es irregular o demasiado detallado, utiliza Approximate Contour para simplificar la forma antes de alimentar este bloque; esto puede producir un círculo envolvente más significativo para contornos ruidosos.

• Recorta a una región de interés con Image ROI Select o Image ROI para acelerar el procesamiento y evitar contornos no relacionados.

• Preprocesa la imagen con Blur o Image Threshold para mejorar la calidad de la detección de contornos corriente arriba.

• Visualiza o anota los resultados finales usando Draw Rectangle, Draw Result On Image, o envía el resultado a Show Image para una vista más grande.

• Usa las salidas numéricas (Center, Radius) con bloques de medición o lógica (por ejemplo, para comparar tamaños, activar alertas o almacenar valores).

🛠️ Resolución de problemas

• No aparece ningún círculo: asegúrate de proporcionar un contorno válido. Usa un bloque productor de contornos como Find Contour y verifica que el contorno no esté vacío.

• El círculo parece demasiado grande o pequeño: intenta simplificar el contorno con Approximate Contour o refina la detección de contornos ajustando el preprocesado upstream (por ejemplo con Image Threshold, Blur).

• Resultados inesperados en imágenes con ruido: recorta el área de interés con Image ROI Select y filtra el ruido antes de detectar contornos.