# 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 | Ce paramètre doit faire référence à une cellule de feuille de calcul contenant une structure de données Image. Par défaut, le paramètre fait référence à A0, la cellule contenant la structure de données. Ce paramètre peut également faire référence à d’autres structures de données Image, telles que celles renvoyées par les Image Fonctions Vision Data Access (VDA) ou 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).
Anneau | 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’un bord. La Largeur des bords est utilisée pour filtrer l’image avant l’extraction des bords.
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 Fonctions Vision Data Access (VDA) 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 Fonctions Vision Data Access (VDA) Edges.