Line Detector

Este bloque de función detecta y resalta líneas rectas en una imagen de entrada. Ofrece controles sencillos para orientar la detección hacia una orientación preferida, ajustar la sensibilidad y elegir una única línea "seleccionada" según diferentes modos de selección. El bloque también genera una visualización de histograma de los valores de intensidad a lo largo de la línea elegida para ayudar en análisis posteriores.

📥 Entradas

Image Any Imagen a analizar en busca de estructuras lineales (color o escala de grises).

📤 Salidas

Lined Image Imagen con las líneas detectadas visualizadas.

Histogram Image Imagen del histograma de intensidades con opción de superponer estadísticas para la línea seleccionada.

Number of Lines Recuento de líneas detectadas tras el filtrado aplicado.

Selected Line Una única línea seleccionada (shape) elegida según el modo de selección seleccionado.

Lines Todas las líneas detectadas (shapes), devueltas como lista cuando procede.

🕹️ Controles

Preferred Angle Selecciona la orientación (en grados) que más te interesa (0–180). Esto sesga la detección hacia líneas con esa orientación.

Tolerance (deg) Define cuánto puede desviarse una línea del ángulo preferido. Valores pequeños limitan la detección a líneas cercanas a la orientación preferida.

Line Selection Elige cómo seleccionar una única línea representativa entre varias detecciones. Opciones: First Position, Last Position, Longest, Shortest, Middle Position y Median Length.

Hough Threshold (Votes) Ajusta la sensibilidad de la detección de líneas. Valores altos hacen la detección más estricta (menos líneas); valores bajos detectan líneas más débiles.

Min. Line Length (pixels) Ignora segmentos muy cortos estableciendo una longitud mínima para las líneas detectadas.

Max. Line Gap (pixels) En detección basada en segmentos, controla qué tan separados pueden estar segmentos rotos para que se unan como una sola línea.

📊 Mecanismo de ejecución

• La imagen de entrada se prepara para el análisis de líneas (conversión y mejora según sea necesario).

• Se localizan bordes y segmentos prominentes en la imagen.

• Los segmentos detectados se recopilan y (opcionalmente) se filtran para mantener los cercanos a Preferred Angle dentro de la Tolerance (deg).

• Se selecciona una línea según el control Line Selection.

• Se renderiza la imagen de resultado con todas las líneas encontradas y la línea seleccionada resaltada.

• Se produce una imagen de histograma de los valores de intensidad; si hay una línea seleccionada, el histograma también mostrará estadísticas básicas (media y opcionalmente desviación estándar) para los píxeles muestreados a lo largo de esa línea.

✨ Características

• Salida visual que dibuja todas las líneas detectadas y resalta una línea elegida para inspección rápida.

• Modos de selección flexibles para elegir la línea única que mejor se ajuste a tu tarea.

• Filtrado por ángulo para centrarse en una orientación deseada.

• Salida de histograma vinculada a la línea seleccionada para un análisis rápido de intensidad.

• Parámetros ajustables para equilibrar sensibilidad y tolerancia al ruido.

📝 Instrucciones de uso

1. Conecta un bloque que provea imagen al input Image Any (por ejemplo, una cámara o un cargador de imágenes).

2. Ajusta Preferred Angle a la orientación esperada en la escena.

3. Reduce Tolerance (deg) para enfocarte en esa orientación, o incrementa para aceptar ángulos más variados.

4. Ajusta Hough Threshold (Votes), Min. Line Length y Max. Line Gap para encontrar un equilibrio entre perder líneas débiles e incluir ruido.

5. Usa Line Selection para elegir la línea única que tenga sentido para tu tarea.

6. Inspecciona las salidas Lined Image y Histogram Image; emplea los shapes de línea en procesos posteriores.

💡 Consejos y trucos

• Para imágenes con ruido, añade un bloque Blur antes de este para suavizar y mejorar la estabilidad de la detección.

• Si las imágenes son muy grandes, usa Image Resize para bajar resolución y acelerar la detección manteniendo estructuras relevantes.

• Para centrar el procesamiento en una región concreta, recorta primero con Image ROI Select o Get ROI y ejecuta este bloque sobre la imagen recortada.

• Tras la detección, combina Selected Line o Lines con Line Geometry para medir ángulos, distancias, intersecciones o extraer coordenadas.

• Para depuración visual, conecta Lined Image a Show Image para ver resultados en un visor más grande, o guarda ejemplos con Image Logger o Image Write.

• Usa Histogram On Line cuando necesites análisis de picos más especializado a lo largo de una única línea de escaneo; complementa el histograma que produce este bloque.

• Para dibujar o anotar líneas de medición interactivamente, combínalo con Draw Line y luego analiza la línea dibujada con este bloque.

(hints above use only blocks from the provided list)

🛠️ Solución de problemas

• No se detectan líneas: baja Hough Threshold (Votes), disminuye Min. Line Length o aumenta Tolerance (deg) para aceptar más candidatos.

• Demasiadas líneas espurias: incrementa Hough Threshold (Votes) o sube Min. Line Length para ignorar segmentos ruidosos pequeños.

• La línea seleccionada no es la esperada: prueba otros modos en Line Selection (por ejemplo, Longest o Middle Position) o ajusta el ángulo preferido y la tolerancia.

• El histograma parece no corresponder con la línea seleccionada: confirma que la línea seleccionada esté completamente dentro del área de la imagen; recorta con Image ROI Select si es necesario.

Si necesitas resultados más estables en producción, preprocesa las imágenes (iluminación, contraste) y prueba los rangos de parámetros con muestras representativas antes de desplegar.