# InspectEdge

La fonction InspectEdge est utilisée pour effectuer une analyse avancée des bords. Dans la région d’intérêt (ROI) référencée par la fonction, un ensemble de sous-régions indexées de détection des bords (appelées calipers) génère des informations détaillées sur l’emplacement précis des caractéristiques, en localisant les bords ou les paires de bords dans une image. Ces informations sont utilisées pour déterminer l’emplacement des bords ou des caractéristiques, l’emplacement et l’espacement des paires de bords, et pour mesurer la largeur des objets dans les images.

## InspectEdge – Présentation

Après avoir inséré la fonction InspectEdge, la ROI est établie, soit en utilisant la région interne de la fonction, soit en faisant référence à une ROI externe, comme EditMaskedRegion ou EditPolylinePath : cette opération permet de déterminer, dans l’image, où l’outil doit détecter le bord ou les paires de bords. La ROI référencée est segmentée en caliper distincts, où chaque caliper projette les pixels qu’il contient dans une convolution unique pour l’analyse des bords.

Une fois la ROI configurée, les étapes suivantes sont nécessaires pour appliquer correctement la fonction :

- – spécifier les valeurs des paramètres Caliper, Contraste minimum et Largeur des bords qui isolent les bords d’intérêt ;
- – définir un modèle de bord qui décrit le bord ou la paire de bords d’intérêt à l’aide des fonctions InspectEdgeForDefect, InspectEdgePosition, InspectEdgeTrainBeadPath et/ou InspectEdgeWidth.

Si la fonction InspectEdge est utilisée, plusieurs inspections peuvent être réalisées avec une seule fonction InspectEdge comme entrée. Par exemple, au sein d’une ROI InspectEdge : la fonction InspectEdgeForDefect peut référencer la fonction permettant de déterminer les défauts de position, la fonction InspectEdgeWidth peut mesurer les largeurs, et la fonction InspectEdgePosition peut déterminer une ligne ajustée pour un autre bord.

Remarque : InspectEdge nécessite une durée d’exécution plus longue que les autres outils de vision. L’augmentation du nombre de calipers dans la ROI augmente le temps de calcul de la fonction.

## InspectEdge – 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 (par défaut = 0) | L’offset en X (coordonnées de l’image).
Y (par défaut = 0) | L’offset en Y (coordonnées de l’image).
Thêta (par défaut = 0) | 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 ; crée un Mode Graphiques interactifs – Régions rectangulaires qui peut être transformé et pivoté. 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. La ligne jaune, en pointillées, indique le sens de détection du bord.
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).
Largeur | Dimension de l’axe X de la région.
Hauteur | Dimension de l’axe 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.
Chemin ou région externe | Détermine les Références à des cellules pour une cellule de feuille de calcul qui contient un Annulus, une Region ou une fonction EditAnnulus, EditMaskedRegion, EditPolylinePath, EditRegion. Lorsque ce paramètre est utilisé, la fonction ignore les paramètres Région et de Repère et inspecte la zone d’image spécifiée par la région référencée. Remarque : Si ce paramètre a été défini comme une référence à une région externe, pour utiliser la région interne de la fonction, ce paramètre doit être manuellement mis à zéro en remplaçant la référence de la cellule par la valeur 0. Dans le cas contraire, la fonction continue de faire référence à la région externe. Si ce paramètre fait référence à une fonction EditPolylinePath, celle-ci ne peut pas être utilisée comme référence pour les fonctions InspectEdgeForDefectou InspectEdgePosition : #ERR est alors renvoyé.
Caliper | Indique les groupes Caliper, dans la ROI, utilisés pour définir la taille des défauts et/ou des écarts détectables. La taille du défaut ou de l’écart détectable est déterminée par le nombre de bords qui peuvent être détectés. La valeur est déterminée par le nombre de calipers placés le long du bord. Les calipers sont visibles dans la ROI sous forme de rectangles rouges, et les bords détectés s’affichent en vert, lorsque la cellule InspectEdge est en surbrillance ou que le paramètre Afficher est défini sur Afficher tout. Remarque : Selon le type de défaut examiné, les calipers peuvent être positionnés de manière à se chevaucher. Toutefois, plus le nombre de calipers utilisés dans la ROI est élevé, plus le temps d’exécution de la fonction augmente.
Hauteur | Indique le nombre de pixels, par Caliper, qui doit être analysé dans le sens de l’inspection. La plage valide est comprise entre 1 et la largeur d’image du système de vision In-Sight ; valeur par défaut : 5.
Offset répété | Indique le nombre de pixels entre le début de chaque caliper. La plage valide est comprise entre 0 et la largeur d’image du système de vision In-Sight ; valeur par défaut : 5. Le dernier caliper peut chevaucher la fin de la région, sauf si l’option Ajuster tous les calipers est activée.
Offset initial | Indique un offset pour le premier caliper de la région. La plage valide est comprise entre 0 et la largeur d’image du système de vision In-Sight ; valeur par défaut : 0.
Contraste minimum | Détermine la transition minimale du contraste en niveaux de gris (0 à 255 ; par défaut = 5) pour être considérée comme un bord. Pour chaque caliper indexé, un graphique de résultat de bord est affiché avec l’image. Les valeurs du graphique sont automatiquement mises à l’échelle, avec une valeur comprise entre 0 et 100. Utilisez ce graphique lorsque vous appliquez ce paramètre pour ajuster correctement la valeur. Paramètre de contraste minimum avec graphique – Exemple Remarque : Le graphique de résultat de bord est une fenêtre ancrable. Pour plus d’informations, consultez la rubrique Éditeur de feuilles de calcul – Graphiques.
Largeur des bords | Détermine la distance de pixels (1 à la valeur Largeur de région ; par défaut : 3) au-delà de laquelle on est en présence d’une transition. Ce paramètre représente la taille approximative de l’opérateur de pixels utilisé pour filtrer les projections de niveaux de gris avant l’extraction des bords : utilisez-le pour filtrer les parasites de l’image.
Ajuster tous les calipers | Indique si tous les calipers sont placés ou non à l’intérieur de la ROI.
0 = OFF (par défaut) | Indique que la fonction suit strictement les paramètres Offset répété et Offset initial du caliper, et que les calipers peuvent chevaucher la ROI.
1 = ON | Indique que la fonction recalcule automatiquement les paramètres Offset répété et Offset initial du caliper pour s’assurer que tous les calipers sont placés dans la ROI.
Index du graphique du caliper | Indique le caliper à afficher sur l’image (en vert) ; caliper affiché par défaut : 0.
Largeur de la polyligne | Détermine la hauteur d’une fonction EditPolylinePath (1 à la valeur de hauteur de la région ; par défaut = 20, maximum = 1920). Ce paramètre est utilisé conjointement avec la fonction InspectEdgeTrainBeadPath pour inspecter un chemin polylinéaire.
Afficher | Détermine le mode d’affichage des graphiques superposés de InspectEdge sur l’image.
0 = masquer tout (par défaut) | Tous les graphiques sont masqués, sauf lorsque la cellule contenant la fonction InspectEdge est mise en évidence dans la feuille de calcul.
1 = graphiques de résultats uniquement | Le graphique caliper et le caliper spécifié sont affichés continuellement.
2 = graphiques d’entrées et de résultats | La région de l’image d’entrée, le graphique caliper et le caliper spécifié sont affichés continuellement.
3 = afficher tout : entrée, résultat et calipers | La région de l’image d’entrée, le graphique caliper et tous les calipers dans la ROI sont affichés continuellement.

## InspectEdge – Sorties

Renvoie | Une structure de données Inspect contenant les bords détectés dans l’image et le nombre de calipers, ou #ERR si l’un des paramètres d’entrée est incorrect.
Résultats | Le nombre de calipers dans la ROI.