FindCircle

Recherche un bord circulaire unique dans une région circulaire (anneau ou cercle). FindCircle forme des projections unidimensionnelles de la région de l’image en additionnant les valeurs de pixels en cercles concentriques balayés en procédant du centre vers l’extérieur. Les transitions sont extraites à partir de l’image projetée.

FindCircle – 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).

Annulus

Aussi appelé région d’intérêt (ROI), spécifie la région de l’image qui fait l’objet d’une analyse ; crée une région d’image circulaire qui peut être translatée et pivotée. Lorsque ce paramètre est activé à l’aide du bouton Agrandir la région dans la barre d’outils de la feuille de propriétés, la région est automatiquement agrandie pour couvrir toute 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).
Rayon intérieur	La taille du rayon intérieur.
Rayon extérieur	La taille du rayon extérieur.

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

Polarité

Détermine la polarité du bord à repérer, par rapport au sens de balayage de la région Edge. La fonction ne signale que les bords de la polarité spécifiée.

0 = noir/blanc	Indique que la polarité des bords est noir/blanc.
1 = blanc/noir	Indique que la polarité des bords est blanc/noir.
2 = indifférent (par défaut)	Indique que la polarité des bords peut être soit noir/blanc, soit blanc/noir.

Chercher par

Indique la technique de sélection de bords utilisée par la fonction pour sélectionner un bord parmi plusieurs candidats.

0 = meilleur score (par défaut)	Indique que le bord avec le score le plus élevé est priorisé.
1 = plus petit cercle	Indique que le plus petit cercle détecté est priorisé.
2 = plus grand cercle	Indique que le plus grand cercle détecté est priorisé.

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.

Remarque : Conseil : 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é.

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 FindCircle sur l’image.

0 = masquer tout (par défaut)	Tous les graphiques sont masqués, sauf si la cellule contenant la fonction FindCircle est la cellule active dans la feuille de calcul.
1 = graphiques de résultats uniquement	Le bord circulaire est toujours affiché.
2 = graphiques d’entrées et de résultats	La région d’image d’entrée et le bord circulaire sont toujours affichés.
3 = afficher tout : entrée, résultat et graphique	La région d’image d’entrée, le bord circulaire 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.

FindCircle – Sorties

Renvoie

Une structure de données Edge contenant un seul bord circulaire, 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 FindCircle est insérée dans une cellule pour la première fois à l’aide des Vision Data Access functions Edges.

Label	Fonction	Description
CentX	GetX(Edges, 0, 0)	L’abscisse du centre.
CentY	GetY(Edges, 0, 0)	L’ordonnée du centre.
Rayon	GetRadius(Edges, 0)	Rayon.
Score	GetScore(Edges, 0)	Score du contraste de la transition. Le score est positif pour les transitions noir/blanc et négatif pour les transitions blanc/noir.