For the complete documentation index, see llms.txt. This page is also available as Markdown.

Line Detector

Ce bloc de fonction détecte et met en évidence les lignes droites dans une image d'entrée. Il propose des contrôles simples pour orienter la détection vers une orientation souhaitée, ajuster la sensibilité et choisir une seule ligne « sélectionnée » selon différents modes de sélection. Le bloc produit également une visualisation d'histogramme des valeurs d'intensité le long de la ligne choisie pour aider à l'analyse.

📥 Entrées

Image Any Image à analyser pour détecter des structures linéaires (couleur ou niveaux de gris).

📤 Sorties

Lined Image Image avec les lignes détectées visualisées.

Histogram Image Image de l'histogramme d'intensité avec une superposition optionnelle montrant les statistiques pour la ligne sélectionnée.

Number of Lines Nombre de lignes détectées après filtrage éventuel.

Selected Line Une seule ligne sélectionnée (forme) choisie selon le mode de sélection choisi.

Lines Toutes les lignes détectées (formes), renvoyées sous forme de liste lorsque pertinent.

🕹️ Contrôles

Preferred Angle Orientation souhaitée (degrés, 0–180) vers laquelle la détection est favorisée.

Tolerance (deg) Tolérance en degrés autour de l'orientation préférée. Des valeurs plus faibles limitent la détection aux lignes proches de l'angle préféré.

Line Selection Mode pour choisir la ligne représentative parmi plusieurs détections : First Position, Last Position, Longest, Shortest, Middle Position, Median Length.

Hough Threshold (Votes) Sensibilité de détection (votes). Une valeur plus élevée rend la détection plus stricte (moins de lignes).

Min. Line Length (pixels) Longueur minimale en pixels pour ignorer les segments très courts.

Max. Line Gap (pixels) Pour la détection par segments, distance maximale entre segments séparés pour qu'ils soient joints en une seule ligne.

📊 Mécanisme d'exécution

  • L'image d'entrée est préparée pour l'analyse de lignes (conversion et amélioration si nécessaire).

  • Les bords et segments proéminents sont localisés sur l'image.

  • Les segments détectés sont collectés et (optionnellement) filtrés pour garder ceux proches de Preferred Angle selon la Tolerance (deg).

  • Une ligne est sélectionnée selon le contrôle Line Selection.

  • L'image résultat est rendue avec toutes les lignes trouvées affichées et la ligne sélectionnée mise en évidence.

  • Un histogramme des valeurs d'intensité est produit ; si une ligne est sélectionnée, l'histogramme affiche aussi des statistiques de base (moyenne, éventuellement écart-type) pour les pixels échantillonnés le long de cette ligne.

✨ Fonctionnalités

  • Sortie visuelle qui dessine toutes les lignes détectées et met en évidence une ligne choisie pour inspection.

  • Modes de sélection flexibles pour choisir la ligne la mieux adaptée à votre tâche.

  • Filtrage par angle pour se concentrer sur une orientation donnée.

  • Histogramme simple lié à la ligne choisie pour une analyse rapide des intensités.

  • Paramètres ajustables pour gérer le compromis sensibilité / tolérance au bruit.

📝 Instructions d'utilisation

  1. Connectez un bloc produisant une image à l'entrée Image Any (par exemple une caméra ou un chargeur d'images).

  2. Réglez Preferred Angle sur l'orientation attendue dans la scène.

  3. Diminuez Tolerance (deg) pour vous concentrer strictement sur cette orientation, ou augmentez-la pour accepter plus d'angles variés.

  4. Ajustez Hough Threshold (Votes), Min. Line Length et Max. Line Gap pour trouver un compromis entre manquer des lignes faibles et inclure du bruit.

  5. Utilisez Line Selection pour choisir la ligne unique qui a du sens pour votre objectif.

  6. Inspectez les sorties Lined Image et Histogram Image ; utilisez les formes de ligne pour un traitement en aval.

💡 Conseils et astuces

  • Pour des images bruyantes, ajoutez un bloc Blur avant afin de lisser le bruit et améliorer la stabilité de la détection.

  • Si vos images sont très grandes, utilisez Image Resize pour réduire la résolution et accélérer la détection tout en conservant les structures importantes.

  • Pour vous concentrer sur une zone particulière, recadrez d'abord avec Image ROI Select ou Get ROI puis exécutez ce bloc sur l'image recadrée.

  • Après détection, combinez Selected Line ou Lines avec Line Geometry pour mesurer angles, distances, intersections ou extraire des coordonnées.

  • Pour un débogage visuel, alimentez Lined Image dans Show Image pour voir les résultats dans un visualiseur plus grand, ou enregistrez des exemples avec Image Logger ou Image Write.

  • Utilisez Histogram On Line pour une analyse de pics plus spécialisée le long d'une seule ligne de scan ; cela complète l'histogramme fourni ici.

  • Pour dessiner ou annoter des lignes de mesure interactives, combinez avec Draw Line puis analysez la ligne dessinée avec ce bloc.

(hints above use only blocks from the provided list)

🛠️ Dépannage

  • Aucune ligne détectée : Réduisez Hough Threshold (Votes), diminuez Min. Line Length ou augmentez Tolerance (deg) pour accepter plus de candidats.

  • Trop de lignes parasites : Augmentez Hough Threshold (Votes) ou augmentez Min. Line Length pour ignorer les petits segments bruyants.

  • La ligne sélectionnée est inattendue : Essayez d'autres modes Line Selection (par exemple Longest ou Middle Position) ou ajustez l'angle préféré et la tolérance.

  • L'histogramme semble sans rapport avec la ligne sélectionnée : Vérifiez que la ligne sélectionnée est entièrement à l'intérieur de la zone image ; recadrez avec Image ROI Select si nécessaire.

Pour des résultats plus stables en production, prétraitez les images (éclairage, contraste) et testez les plages de paramètres sur des échantillons représentatifs avant déploiement.

Mis à jour