# InspectEdgeTrainBeadPath

La fonction InspectEdgeTrainBeadPath permet de trouver le centre d’un cordon basé sur des bords, et crée une polyligne qui trace le chemin du de cordon détecté. Le chemin polylinéaire créé par l’outil peut être utilisé comme entrée par d’autres Fonctions InspectEdge, notamment la fonction InspectEdgeWidth, pour déterminer s’il existe des défauts de position, des défauts de largeur ou des écarts dans le cordon.

## InspectEdgeTrainBeadPath – Présentation

Un chemin de cordon est une paire de bords continue qui fait office de frontière entre deux régions de valeurs de pixels différentes (le chemin n’a pas toujours l’apparence d’une boucle). En général, un chemin de cordon désigne un trait d’encre ou de colle, ou une soudure, qui est défini par sa largeur/épaisseur et son emplacement. La fonction InspectEdgeTrainBeadPath, en complément des autres fonctions InspectEdge, peut être appliquée dans les applications de suivi de cordon. Le chemin de cordon varie alors d’une image à l’autre, et la fonction permet également de vérifier si le chemin de cordon se trouve toujours au même endroit.

Dans l’application de suivi de cordon, la fonction InspectEdgeTrainBeadPath, en complément d’une fonction InspectEdge et d’une fonction InspectEdgeWidth, peut s’assurer que le chemin de cordon est disposé de manière cohérente, avec un motif uniforme, d’épaisseur intermédiaire. Les fonctions créent une ligne avec plusieurs segments qui définit un chemin le long du cordon, puis déterminent s’il y a des zones de ce chemin qui sont trop épaisses, trop fines, ou totalement absentes.

Dans l’application de suivi de cordon basé sur l’emplacement, ces mêmes fonctions sont capables de s’assurer que le chemin de cordon se trouve toujours au même endroit, avec la même épaisseur, et qu’il n’y a pas de variations de position le long du chemin.

Remarque : Pour qu’elle soit utilisée dans l’une des deux applications, la fonction InspectEdgeTrainBeadPath doit servir d’entrée de paramètre Région externe ou Chemin de la fonction InspectEdge, et la fonction InspectEdgeWidth doit faire référence à la structure de données Inspect générée par la fonction InspectEdge dans son paramètre InspectEdge.

## InspectEdgeTrainBeadPath – 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.
Détection du sens du bord | Indique le sens dans lequel la fonction va tenter de détecter les bords. Des flèches (couleur vert foncé) sont ajoutées pour illustrer le sens de détection du bord. Les lignes d’ajustement seront étiquetées graphiquement sur l’image : la première ligne avec 0 et la deuxième avec 1.
0 = Gauche/droite | La fonction tente de détecter les bords de la gauche de la ROI vers la droite. Exemple
1 = Droite/gauche | La fonction tente de détecter les bords de la droite de la ROI vers la gauche. Exemple
3 = Centre/extérieur (par défaut) | La fonction tente de détecter les bords depuis le centre de la ROI jusqu’aux limites supérieure et inférieure de la ROI (l’ordre des bords trouvés sera dans le sens opposé à la flèche « X » sur la ROI). Exemple
2 = Extérieur/intérieur | La fonction tente de détecter les bords depuis les limites supérieure et inférieure de la ROI vers le centre de celle-ci (l’ordre des bords trouvés sera dans le sens opposé à la flèche « X » sur la ROI). Exemple
Bord : Premier | Indique la transition de contraste du premier bord à détecter, tel que déterminé par le paramètre Détection du sens du bord.
1 = noir/blanc | Le bord présente une transition de type pixels noirs vers pixels blancs.
2 = blanc/noir (par défaut) | Le bord présente une transition de type pixels blancs vers pixels noirs.
3 = indifférent | Le bord peut présenter deux types de transition (noirs/blancs ou blancs/noirs), et la fonction déterminera celui approprié. Spécifier le bord améliore les performances de la fonction.
Bord : Deuxième | Indique la transition de contraste du second bord à détecter, tel que déterminé par le paramètre Détection du sens du bord.
1 = noir/blanc (par défaut) | Le bord présente une transition de type pixels noirs vers pixels blancs.
2 = blanc/noir | Le bord présente une transition de type pixels blancs vers pixels noirs.
3 = indifférent | Le bord peut présenter deux types de transition (noirs/blancs ou blancs/noirs), et la fonction déterminera celui approprié. Spécifier le bord améliore les performances de la fonction.
Score du bord | Spécifie le mode de notation des bords utilisé pour déterminer si un bord répond ou non aux critères établis.
Seuil de score | Indique un seuil de notation pour filtrer les bords dont les scores (compris entre 1 et 100 ; par défaut = 10) sont inférieurs à cette valeur.
Règles des bords | Indique le type de bord qui est le plus important lors du calcul du score.
1 = Premier | Le premier bord détecté est priorisé.
2 = Le plus marqué | Le bord avec la transition de contraste la plus marquée est priorisé.
3 = Premier le plus marqué | Le premier bord détecté, avec transition la plus marquée, est priorisé.
4 = Taille de la paire de bords | La paire de bords détectée, dont la taille est la plus proche du paramètre Taille de la paire, est priorisée.
5 = Taille de la première paire de bords | La première paire de bords détectée, dont la taille est la plus proche du paramètre Taille de la paire, est priorisée.
6 = Taille de la paire de bords la plus marquée | La paire de bords détectée avec la transition la plus marquée, dont la taille est la plus proche du paramètre Taille de la paire, est priorisée.
7 = Taille de la première paire de bords la plus marquée (par défaut) | La première paire de bords, avec la transition la plus marquée, dont la taille est la plus proche du paramètre Taille de la paire, est priorisée.
Limite de contraste supérieure | Détermine la limite supérieure de la transition de contraste du bord (2 à 255 ; par défaut = 255) pour être considérée comme un bord. Les bords dont la transition de contraste est supérieure à cette valeur auront le même score le plus élevé. Remarque : Pour activer ce paramètre, le paramètre Règles de bord doit être défini sur Le plus marqué, Premier le plus marqué, Taille de la paire de bords la plus marquée ou Taille de la première paire de bords la plus marquée.
Taille des paires | Détermine la taille de la paire de bords pour laquelle le score le plus élevé est obtenu (la plage valide est 1 à 3 fois supérieure à la largeur d’image du système de vision In-Sight ; par défaut = 5). Lorsque ce paramètre est activé, les paires de bords détectées au-dessus ou au-dessous de cette valeur sont notées proportionnellement à cette valeur. Par exemple, si Taille de la paire est définie sur 10 et que deux paires de bords candidats sont détectées, une avec une valeur de 8 et l’autre avec une valeur de 14, la paire de bords avec une valeur de 8 est sélectionnée car elle est plus proche de la limite. Remarque : Le paramètre Inspecter les paires de bords doit être activé et le paramètre Règles de bords doit être défini sur Taille de la paire de bords, Taille de la première paire de bords, Taille de la paire de bords la plus marquée ou Taille de la première paire de bords la plus marquée pour qu’il soit activé.
Apprendre | Définit le mode d’apprentissage de l’outil.
0 = OFF | Indique que la fonction ne va pas effectuer d’apprentissage.
1 = ON (par défaut) | Indique que la fonction va effectuer un apprentissage.
Index du graphique du caliper | Indique le caliper à afficher sur l’image (en vert) ; caliper affiché par défaut : 0.
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 InspectEdgeTrainBeadPath est mise en évidence dans la feuille de calcul.
1 = graphiques de résultats uniquement | La fonction EditPolylinePath entraînée et le graphique à points de la paire de bords trouvée sont toujours affichés.
2 = Afficher les graphiques de résultats et détails du caliper | La fonction EditPolylinePath entraînée et un seul Caliper, avec ses bords candidats, et le graphique caliper sont toujours affichés.
3 = Afficher les graphiques de résultats, détails du caliper et bords candidats | La fonction EditPolylinePath entraînée et un seul Caliper, avec ses bords candidats, le graphique caliper et tous les bords candidats de tous les calipers sont toujours affichés.
4= Afficher les graphiques de résultats, tous les bords candidats et les calipers | La fonction EditPolylinePath entraînée et un seul Caliper, avec ses bords candidats, le graphique caliper, tous les bords candidats de tous les calipers, et tous les calipers sont toujours affichés.
5 = afficher tout : entrée, résultat et calipers | Les graphiques d’entrée, la fonction EditPolylinePath entraînée et un seul caliper, avec ses bords candidats, le graphique caliper, tous les bords candidats de tous les calipers, et tous les calipers sont toujours affichés.

## InspectEdgeTrainBeadPath – 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.