FindSegment

Recherche une paire de Edge dans une région d’image et calcule leur distance. FindSegment forme une projection unidimensionnelle de la région de l’image en additionnant les valeurs de pixels dans le sens des abscisses de la région. Les transitions sont extraites à partir de l’image projetée. Le segment en arc de cercle, sur laquelle la distance de bord à bord est calculée, est dérivé de la région utilisée pour extraire les bords.

FindSegment – Entrées

Paramètre Description

Image

This parameter must reference a spreadsheet cell that contains an Image data structure; by default, this parameter references A0, the cell containing the data structure. This parameter can also reference other Image data structures, such as those returned by the Image Vision Data Access functions or Fonctions de conversion de coordonnées.

Repère

Définit la région d’intérêt (ROI) par rapport à l’entrée d’un Fixture ou à la sortie du système de coordonnées de l’image d’une fonction Outils de vision. En définissant la ROI par rapport à un Repère, toute rotation ou translation de ce dernier entraînera systématiquement une rotation/translation de la ROI, le cas échéant.

Le paramètre par défaut est (0,0,0), le coin supérieur gauche de l’image.

X

L’offset en X (coordonnées de l’image).

Y

L’offset en Y (coordonnées de l’image).

Thêta

La rotation par rapport à l’axe X de l’image, dans le système de coordonnées de l’image (+/-360 degrés dans le sens horaire).

Région

Aussi appelé région d’intérêt (ROI), spécifie la région de l’image qui fait l’objet d’une analyse. Effectuez un double-clic sur le paramètre Région pour créer un Mode Graphiques interactifs que vous pouvez transformer et faire pivoter. Sélectionnez ce paramètre et cliquez sur le bouton Agrandir la région dans la barre d’outils Modification du projet de la feuille de propriétés pour agrandir automatiquement la région pour qu’elle couvre l’intégralité de l’image.

X

L’offset en X de l’origine (coordonnées du repère).

Y

L’offset en Y de l’origine (coordonnées du repère).

Hauteur

La dimension le long de l’axe des x de la région.

Largeur

La dimension le long de l’axe des y de la région.

Angle

Orientation du repère.

Courbure

Écart angulaire entre l’axe X de la région et la ligne de la limite opposée.

Remarque :  Les paramètres Repère et Région doivent être ajustés en fonction des limites de l’image. S’ils sont hors limites, la fonction renvoie #ERR.

Couleur de la bande

Indique la couleur du segment à rechercher. FindSegment n’indique que les paires de bords de la polarité spécifiée.

0 = Noir (par défaut)

Indique noir ou la polarité blanc/noir suivie de noir/blanc.

1 = blanc

Indique blanc ou la polarité noir/blanc suivie de blanc/noir.

Chercher par

Détermine la technique de sélection des bords.

0 = la plus grande largeur (par défaut)

Recherche les deux bords les plus éloignés à partir desquels un segment de la couleur de segment spécifiée pourra être identifié.

1 = bords les plus marqués

Recherche les deux bords avec le score de réponse le plus élevé à partir desquels un segment de la couleur de segment spécifiée pourra être identifié.

2 = segment contigu le plus large

Recherche les deux bords à partir desquels un segment de la couleur de segment spécifiée pourra être identifié, sans que d’autres bords ne se trouvent entre eux.

3 = la plus petite largeur

Recherche les deux bords les plus proches à partir desquels un segment de la couleur de segment spécifiée pourra être identifié.

Score minimum

Indique le contraste minimum de bord acceptable (compris entre 0 et 100 ; par défaut = 25). La valeur de contraste est normalisée à partir de l’histogramme des niveaux de gris dans la région, sur une échelle de 0 à 100. La fonction rejette tous les bords dont le score de contraste est en dessous de cette valeur.

Normalisation du score

Indique si les scores des bords seront normalisés par rapport à l’histogramme des niveaux de gris de la région. Lorsque l’option Normalisation du score est activée, les scores bruts de bords sont normalisés par le contraste maximal trouvé dans la région de l’image à l’aide de la formule suivante :

Score = (score brut de bord) x (100/contraste maximum)

Le score brut du bord est la différence de niveau de gris au niveau du bord, tandis que le contraste maximum correspond à la différence entre le niveau de gris maximum et minimum (0 à 255) dans la région de l’image.

Lorsque l’option Normalisation du score est désactivée, les bords à faible contraste obtiennent un score inférieur à celui des bords à fort contraste. La formule suivante est utilisée :

Score = (score brut de bord) x (100/255)

0 = OFF

Ne normalise pas le score.

1 = ON (par défaut)

Normalise le score.

Astuce :  Ce paramètre permet de rechercher les bords dans des régions à faible contraste. Désactivez ce paramètre si vous êtes certains que les bords à détecter présentent un contraste élevé.

Gamme d’écart angulaire

Détermine la tolérance de la fonction par rapport à la rotation du bord (0 à 10 ; 0 par défaut). Cette fonction trouve les bords en dehors de la tolérance indiquée, mais sa précision peut être plus faible.

Remarque :  Définir une valeur supérieure à 0 pour ce paramètre réduit la vitesse de la fonction.

Largeur des bords

Détermine la distance de pixels (1 à 50 ; 3 par défaut) au delà de laquelle on est en présence d’une transition. La Largeur des transitions est utilisée pour filtrer l’image avant l’extraction des transitions.

Afficher

Détermine le mode d’affichage des graphiques superposés de FindSegment sur l’image.

0 = masquer tout (par défaut)

Tous les graphiques sont masqués, sauf si la cellule contenant la fonction FindSegment est la cellule active dans la feuille de calcul.

1 = graphiques de résultats uniquement

Les deux bords qui définissent le segment sont toujours affichées.

2 = graphiques d’entrées et de résultats

La région d’image d’entrée et les deux bords sont toujours affichés.

3 = afficher tout : entrée, résultat et graphique

La région d’image d’entrée, les deux bords et le graphique de résultat de bord sont toujours affichés.

Remarque :  Le graphique de résultat de bord est une fenêtre ancrable. Pour plus d’informations, consultez la rubrique Éditeur de feuille de calcul – Graphiques.

FindSegment – Sorties

Renvoie

Une structure de données Edges contenant une seule paire de bords rectiligne, ou #ERR si l’un des paramètres d’entrée est incorrect.

Résultats

Un tableau de résultats est créé dans la feuille de calcul lorsque la fonction FindSegment est insérée dans une cellule pour la première fois.

Les deux Vision Data Access functions Edges sont automatiquement insérées dans la feuille de calcul pour créer le tableau de résultats :

Label Fonction Description

Distance

PairDistance(Edges, 0, 1)

Distance de segment.

Score

GetScore(Edges, 0)

Score de contraste du segment.

Il est possible d’accéder à d’autres éléments avec les Vision Data Access functions Edges.