FindCircleMinMax

Vérifie la circularité d’un bord continu en recherchant les écarts minimum et maximum du bord et l’écart-type des rayons de tous les points du bord.

Remarque : FindCircleMinMax ne doit pas être utilisée pour repérer des bords circulaires : FindCircle est plus adaptée.

FindCircleMinMax – 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 à rechercher en procédant de l’intérieur vers l’extérieur du cercle, par rapport au sens de balayage de la fonction. Cette fonction n’indique que les bords de la polarité spécifiée.

0 = noir/blanc (par défaut)

1 = blanc/noir

Contraste minimum

Détermine le contraste minimal de niveaux de gris (0 à 255 ; 10 par défaut) à chaque point le long du cercle.

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

0 = masquer tout (par défaut)	Tous les graphiques sont masqués, sauf si la cellule contenant la fonction FindCircleMinMax est la cellule active dans la feuille de calcul.
1 = graphiques de résultats uniquement	Le bord circulaire et les points d’écart minimal et maximal sont affichés continuellement.
2 = graphiques d’entrées et de résultats	La région de l’image d’entrée, le bord circulaire et les points d’écart minimal et maximal sont toujours affichés.

FindCircleMinMax – 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 FindCircleMinMax est insérée dans une cellule pour la première fois.

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

Label	Fonction	Description
CentX	GetX(Edges)	Abscisse centrale du bord circulaire.
CentY	GetY(Edges)	Ordonnée centrale du bord circulaire.
Rayon	GetRadius(Edges)	Rayon du bord circulaire.
Min	GetMin(Edges)	Écart minimal par rapport au bord circulaire.
Max	GetMax(Edges)	Écart maximal par rapport au bord circulaire.
SDev	GetSDev(Edges)	Écart-type par rapport au rayon de tous les points d’un bord continu.
Score	GetScore(Edges)	Mesure de circularité d’un bord continu en fonction du rayon du bord circulaire et de l’écart-type. Le score est plus élevé pour un petit écart-type et moins élevé pour un écart-type important. Le score est calculé à l’aide de la formule suivante : Score = 100×(1 - 2×Écart-type/Rayon)

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