# InspectEdgeWidth

La fonction InspectEdgeWidth est utilisée pour concevoir un modèle de bord permettant d’effectuer une analyse avancée des paires de bords, renvoyées par la fonction InspectEdge. Ces données sont utilisées pour détecter les paires de bords et analyser la distance qui les sépare.

## InspectEdgeWidth – Présentation

Après avoir inséré la fonction dans la feuille de calcul, une sortie de structure de données Inspect doit être référencée à l’aide d’une fonction InspectEdge. Une fois la référence à la fonction InspectEdge établie, le modèle de bords est créé en configurant les paramètres de la fonction InspectEdgeWidth. Lorsqu’un modèle de bords est utilisé, les éléments suivants doivent être définis :

- Le sens de détection des bords.
- Le type de transition des bords (blanc/noir ou noir/blanc).
- Les critères de notation des bords, utilisés pour filtrer les bords indésirables.
- Les critères d’ajustement de la ligne qui seront utilisés pour filtrer les bords indésirables de l’ajustement de la ligne.
- Les tolérances pour les écarts de largeur, les défauts et/ou les écarts à rencontrer.
- Les tolérances pour les écarts de position, en cas de détection d’un chemin de cordon.

Une fois le modèle de bords établi, la fonction compare les bords candidats au modèle de bords et indique les écarts entre les deux.

Remarque : La fonction InspectEdgeWidth peut être utilisée conjointement à une fonction InspectEdgeTrainBeadPath et une fonction InspectEdge pour déterminer les erreurs de largeur et de position liées à un chemin de cordon. Le paramètre InspectEdge de la fonction InspectEdgeWidth doit faire référence à la structure de données Inspect, générée par la fonction InspectEdge, qui fait elle-même référence à la fonction InspectEdgeTrainBeadPath.

## InspectEdgeWidth – Entrées

Paramètre | Description
InspectEdge | Détermine une référence à une cellule de feuille de calcul qui contient une structure de données Inspect valide, renvoyée par une fonction InspectEdge.
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. Remarque : Si la région d’intérêt (ROI) de la fonction référencée InspectEdge forme une courbe, l’inspection est relative au centre de la courbe. Lorsque le paramètre Détection du sens du bord est défini sur Gauche/droite, l’inspection est réalisée vers le centre de la courbe. À l’inverse, lorsqu’il est défini sur Droite/gauche, l’inspection s’éloigne du centre de la courbe.
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 : 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.
Filtre avancé | Indique comment la fonction doit concevoir l’ajustement de la ligne.
Nouveau score | Indique que les bords font l’objet d’une réévaluation pour repérer ceux qui sont plus proches de l’ajustement de ligne.
0 = OFF (par défaut) | La fonction n’effectue pas de réévaluation des bords pour tenir compte de ceux qui sont aberrants.
1 = ON | La fonction effectue une réévaluation des bords pour tenir compte des bords aberrants dans son calcul.
Ajustement de la ligne | Définit le type d’ajustement de ligne à concevoir à partir des bords détectés.
1 = Ajustement de la ligne droite | La fonction va créer un ajustement de ligne droite à partir des bords détectés.
2 = Ajustement du cercle | La fonction va créer un ajustement de ligne circulaire à partir des bords détectés.
3 = Ajustement automatique (par défaut) | La fonction crée automatiquement un ajustement de ligne droite ou circulaire, en fonction de la région référencée.
Observations aberrantes du filtre | Spécifie que la fonction supprimera les points de la ligne d’ajustement dont l’éloignement est supérieur à la distance spécifiée dans le paramètre Ajuster le filtre de distance.
0 = OFF (par défaut) | La fonction ne tient pas compte des bords aberrants.
1 = ON | La fonction tient compte des bords aberrants dans son calcul.
Ajuster le filtre de distance | Indique la distance, en pixels (les plages valides sont 1 à 3 fois supérieures à la largeur d’image du système de vision In-Sight ; par défaut = 2), qui doit séparer un bord de la ligne d’ajustement originale pour être utilisé dans un calcul de réajustement. Ce paramètre est utile pour éviter que les défauts n’affectent l’ajustement de ligne. Filtrer les bords aberrants doit être activée pour modifier ce paramètre.
Nombre maximal de défauts/d’écarts | Indique le nombre maximum de défauts et/ou d’écarts que la fonction doit s’attendre à détecter (1 à 4096 ; par défaut = 5). Cette valeur est appliquée aux défauts et aux écarts individuellement : par exemple, si le paramètre est 5, la fonction s’attend à rencontrer un maximum de 5 défauts et 5 écarts. Ce paramètre est utilisé pour créer le tableau de Résultats de vision dans la feuille de calcul.
Défauts | Indique les paramètres permettant de déterminer les défauts du bord à partir de l’ajustement de la ligne.
Largeur min. | Indique que les distances (largeur en pixels) inférieures à cette valeur, entre les paires de bords détectés, sont des défauts. Les plages valides sont comprises entre 0,001 et 3 fois la largeur d’image du système de vision In-Sight, par défaut 3 pixels.
Largeur max. | Indique que les distances (largeur en pixels) supérieures à cette valeur, entre les paires de bords détectés, sont des défauts. Les plages valides sont comprises entre 0,001 et 3 fois la largeur d’image du système de vision In-Sight, par défaut 3 fois la largeur d’image du système de vision. Remarque : Si cette valeur est inférieure au paramètre Largeur min., la fonction renvoie #ERR.
Taille activée | Indique si la fonction tient compte ou non des défauts de taille. Les défauts de taille correspondent aux écarts de largeur sur la longueur des paires de bords détectées. Remarque : Lorsque Taille activée et Surface activée sont toutes les deux activées, seuls les défauts qui ne remplissent pas les deux conditions sont affichés.
0 = OFF | La fonction ne tient pas compte des défauts de taille.
1 = ON (par défaut) | La fonction tient compte des défauts de taille, en fonction des paramètres Taille min. et Taille max.
Taille min. | Définit la taille minimale du défaut, en pixels. Les écarts continus par rapport à l’ajustement de la ligne qui sont inférieurs à cette valeur ne sont pas considérés comme des défauts. Les plages valides sont comprises entre 0,001 et 3 fois la largeur d’image du système de vision In-Sight, par défaut 3 pixels.
Taille max. | Définit la taille maximale du défaut, en pixels. Les écarts continus par rapport à l’ajustement de la ligne qui sont supérieurs à cette valeur ne sont pas considérés comme des défauts. Les plages valides sont comprises entre 0,001 et 3 fois la largeur d’image du système de vision In-Sight, par défaut 3 fois la largeur d’image du système de vision.
Surface activée | Indique si la fonction tient compte ou non des défauts de surface. Les défauts de surface tiennent compte de la longueur d’ajustement de la ligne et de la distance entre le bord avec défaut et l’ajustement de la ligne. Remarque : Lorsque Taille activée et Surface activée sont toutes les deux activées, seuls les défauts qui ne remplissent pas les deux conditions sont affichés.
0 = OFF | La fonction ne tient pas compte des défauts de surface.
1 = ON (par défaut) | La fonction tient compte des défauts de surface, en fonction des paramètres Surface min. et Surface max.
Surface min. | Indique la surface minimale de défaut, en pixels (plage valide comprise entre 0,001 et 100000 ; par défaut = 10). Une surface inférieure à cette valeur n’est pas considérée comme un défaut.
Surface max. | Indique la surface maximale de défaut, en pixels (plage valide comprise entre 0,001 et 1000000 ; par défaut = 1000000). Une surface supérieure à cette valeur n’est pas considérée comme un défaut.
Critères de tri | Définit comment les défauts détectés sont triés.
Par taille (par défaut) | La fonction trie les défauts détectés en fonction de leur taille, de la plus grande à la plus petite.
Par surface | La fonction trie les défauts détectés en fonction de leur surface, de la plus grande à la plus petite.
Par position | La fonction trie les défauts détectés en fonction de leur index de caliper.
En fonction de la largeur | La fonction trie les défauts détectés en fonction de leur largeur, de la plus grande à la plus petite.
Écarts | Indique les paramètres permettant de déterminer les écarts des paires de bords.
Activé | Indique si la fonction tient compte ou non des écarts des paires de bords trouvées.
0 = OFF | La fonction ne tient pas compte des écarts.
1 = ON (par défaut) | La fonction tient compte des écarts, selon les autres paramètres Écarts définis.
Écart minimal | Définit la taille minimale de l’écart, en pixels. Les écarts inférieurs à cette valeur ne sont pas considérés comme des écarts. Les plages valides sont comprises entre 0,001 et 3 fois la largeur d’image du système de vision In-Sight, par défaut 3 pixels.
Écart maximal | Définit la taille maximale de l’écart, en pixels. Les écarts supérieurs à cette valeur ne sont pas considérés comme des écarts. Les plages valides sont comprises entre 0,001 et 3 fois la largeur d’image du système de vision In-Sight, par défaut 3 fois la largeur d’image du système de vision.
Déplacement max. | Définit le déplacement maximal, en pixels, du centre de la région au centre de la paire de bords, pour que l’élément soit considéré comme un écart. Les plages valides sont comprises entre 1 et 3 fois la largeur d’image du système de vision In-Sight, par défaut 3 fois la largeur d’image du système de vision.
Ignorer les écarts au niveau des extrémités | Indique si la fonction tient compte ou non des écarts détectés au début et à la fin de la ROI.
0 = OFF | La fonction ne tient pas compte des écarts détectés au début et à la fin de la ROI.
1 = ON (par défaut) | La fonction tient compte des écarts détectés au début et à la fin de la ROI.
Critères de tri | Définit comment les écarts détectés sont triés.
Par taille (par défaut) | La fonction trie les écarts détectés en fonction de leur taille, du plus grand au plus petit.
Par position | La fonction trie les écarts détectés en fonction de leur index de caliper.
Position | Indique les paramètres permettant de déterminer les défauts de position des paires de bords. Les paramètres définissent un défaut comme un écart par rapport au centre d’un chemin de modèle, produit par une fonction InspectEdgeTrainBeadPath. Ces paramètres ne doivent être utilisés qu’en cas de référence à une fonction InspectEdge qui fait elle-même référence à une fonction InspectEdgeTrainBeadPath.
Activé | Indique si la fonction tient compte ou non des défauts de position des paires de bords trouvées.
0 = OFF (par défaut) | La fonction ne tient pas compte des défauts de position.
1 = ON | La fonction tient compte des défauts de position, selon les autres paramètres Position définis.
Distance min. | Définit le déplacement de position minimum, en pixels, par rapport au centre du chemin de cordon détecté. Les variations de position inférieures à cette valeur ne sont pas considérées comme des défauts de position. Les plages valides sont comprises entre 0,001 et 3 fois la largeur d’image du système de vision In-Sight, par défaut 3 pixels.
Distance max. | Définit le déplacement de position maximum, en pixels, par rapport au centre du chemin de cordon détecté. Les variations de position supérieures à cette valeur ne sont pas considérées comme des défauts de position. Les plages valides sont comprises entre 0,001 et 3 fois la largeur d’image du système de vision In-Sight, par défaut 3 fois la largeur d’image du système de vision.
Taille activée | Indique si la fonction tient compte ou non des défauts de taille. Les défauts de taille correspondent aux écarts de largeur sur la longueur des paires de bords détectées. Remarque : Lorsque Taille activée et Surface activée sont toutes les deux activées, seuls les défauts qui ne remplissent pas les deux conditions sont affichés.
0 = OFF | La fonction ne tient pas compte des défauts de taille.
1 = ON (par défaut) | La fonction tient compte des défauts de taille, en fonction des paramètres Taille min. et Taille max.
Taille min. | Définit la taille minimale du défaut, en pixels. Les écarts continus par rapport à l’ajustement de la ligne qui sont inférieurs à cette valeur ne sont pas considérés comme des défauts. Les plages valides sont comprises entre 0,001 et 3 fois la largeur d’image du système de vision In-Sight, par défaut 3 pixels.
Taille max. | Définit la taille maximale du défaut, en pixels. Les écarts continus par rapport à l’ajustement de la ligne qui sont supérieurs à cette valeur ne sont pas considérés comme des défauts. Les plages valides sont comprises entre 0,001 et 3 fois la largeur d’image du système de vision In-Sight, par défaut 3 fois la largeur d’image du système de vision.
Surface activée | Indique si la fonction tient compte ou non des défauts de surface. Les défauts de surface tiennent compte de la longueur d’ajustement de la ligne et de la distance entre le bord avec défaut et l’ajustement de la ligne. Remarque : Lorsque Taille activée et Surface activée sont toutes les deux activées, seuls les défauts qui ne remplissent pas les deux conditions sont affichés.
0 = OFF | La fonction ne tient pas compte des défauts de surface.
1 = ON (par défaut) | La fonction tient compte des défauts de surface, en fonction des paramètres Surface min. et Surface max.
Surface min. | Indique la surface minimale de défaut, en pixels. Une surface inférieure à cette valeur n’est pas considérée comme un défaut. La plage valide est comprise entre 0,001 et 100000, par défaut 10.
Surface max. | Indique la surface maximale de défaut, en pixels. Une surface supérieure à cette valeur n’est pas considérée comme un défaut. La plage valide est comprise entre 0,001 et 1000000, par défaut 1000000.
Critères de tri | Définit comment les défauts détectés sont triés.
Par taille (par défaut) | La fonction trie les défauts détectés en fonction de leur taille, de la plus grande à la plus petite.
Par surface | La fonction trie les défauts détectés en fonction de leur surface, de la plus grande à la plus petite.
Par position | La fonction trie les défauts détectés en fonction de leur index de caliper.
En fonction de la largeur | La fonction trie les défauts détectés en fonction de leur largeur, de la plus grande à la plus petite.
Index 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 InspectEdgeWidth sur l’image.
0 = masquer tout (par défaut) | Tous les graphiques sont masqués, sauf lorsque la cellule contenant la fonction InspectEdgeWidth est mise en évidence dans la feuille de calcul.
1 = graphiques de résultats uniquement | L’ajustement de la ligne, les défauts détectés, les points et/ou les écarts aberrants sont toujours affichés.
2 = graphiques de résultats et bord reperé | L’ajustement de la ligne, les défauts détectés, les points et/ou les écarts aberrants, et les points de bords détectés sont toujours affichés.
3 = graphiques de résultats et détails du caliper | L’ajustement de la ligne, les défauts détectés, les points et/ou les écarts aberrants, les points de bords détectés et la fenêtre caliper indexée sont toujours affichés.
4 = afficher tout : entrées et graphiques de résultats | La région d’entrée, l’ajustement de la ligne, les défauts détectés, les points et/ou les écarts aberrants, et les points de bords détectés sont toujours affichés.

## InspectEdgeWidth – Sorties

Renvoie | Une structure de données Inspect contenant les défauts, les extrêmes et les écarts détectés, 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 InspectEdgeWidth est insérée dans une cellule pour la première fois. Remarque : Si la valeur du paramètre Nombre maximal de défauts/d’écarts est supérieure à zéro, InspectEdgeWidth insère automatiquement un tableau de résultats contenant maximum 10 entrées, correspondant aux 10 premiers défauts/écarts/bords/paires de bords de la structure de données. Pour afficher davantage d’entrées, vous pouvez agrandir le tableau en copiant la dernière ligne et en collant des lignes supplémentaires à la fin.

## InspectEdgeWidth Vision Data Access functions

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

Label | Fonction | Description
Nombre total | GetTotalCount(Inspect) | Renvoie le nombre total de résultats.
Défauts/Écarts/Position | GetWidthCount(Inspect, Défauts/Écarts/Position) | Renvoie le nombre total de défauts ou d’écarts spécifiés (Défauts = 0, Écarts = 1, Position = 2).
Défauts/Écarts/Position
Taille/Surface/Largeur/Position | GetDefectGapValue(Inspect, Index Défaut/Écart, Défaut/Écart/Position, Index Paire de bords, Taille/Surface/Largeur) | Renvoie la taille, la surface ou la largeur du défaut ou de l’écart (Défaut = 0, Écart = 1, Position = 2 ; Taille = 0, Surface = 1, Largeur = 2).
X | GetDefectGapBoundsX(Inspect, Index Défaut/Écart, Défaut/Écart/Position, Index Paire de bords) | Renvoie l’abscisse du rectangle englobant du défaut.
Y | GetDefectGapBoundsY(Inspect, Index Défaut/Écart, Défaut/Écart/Position, Index Paire de bords) | Renvoie l’ordonnée du rectangle englobant du défaut.
Hauteur | GetDefectGapBoundsHeight(Inspect, Index Défaut/Écart, Défaut/Écart/Position, Index Paire de bords) | Renvoie la hauteur du rectangle englobant du défaut.
Largeur | GetDefectGapBoundsWidth(Inspect, Index Défaut/Écart, Défaut/Écart/Position, Index Paire de bords) | Renvoie la largeur du rectangle englobant du défaut.
Angle | GetDefectGapBoundsAngle(Inspect, Index Défaut/Écart, Défaut/Écart/Position, Index Paire de bords) | Renvoie l’angle du rectangle englobant du défaut.
Courbure | GetDefectGapBoundsCurve(Inspect, Index Défaut/Écart, Défaut/Écart/Position, Index Paire de bords) | Renvoie la courbure du rectangle englobant du défaut.
Début/Fin | GetDefectGapCaliperIndex(Inspect, Index Défaut/Écart, Défaut/Écart/Position, Index Paire de bords, Début/Fin Défaut) | Renvoie le caliper dans lequel le défaut commence ou se termine (Début = 0, Fin = 1).
Extrêmes – Point le plus éloigné 1/2
Caliper | GetExtremeWidth(Inspect, Le plus fin/Le plus épais) | Renvoie l’index de caliper contenant la largeur extrême spécifiée (Le plus fin = 0 et Le plus épais = 1).
Largeur | GetWidth(Inspect, Index de caliper) | Renvoie la valeur de la largeur du bord dans le caliper indexé ; renvoie 0 si aucun bord n’est trouvé dans le caliper indexé.
X (Début et Fin) | GetEdgeX(Inspect, Index de caliper, Index Paire de bords ou Index de bord) | Renvoie l’abscisse du bord référencé.
Y (Début et Fin) | GetEdgeY(Inspect, Index de caliper, Index Paire de bords ou Index de bord) | Renvoie l’ordonnée du bord référencé.

Remarque :

- Toutes les formules de la fonction InspectEdgeWidth sont conformes à ce qui suit :

> - Inspect = Une structure de données Inspect, générée par une fonction InspectEdgeWidth
> - Index de caliper = 0 à N (le nombre total de calipers est égal au nombre de calipers émis par la fonction InspectEdge, référencée par InspectEdgeForDefect)
> - Index de la paire de bords = 0 ou 1
> - Index des bords = 0 à N
> - Index des points = 0 à 1

- Si le paramètre Position activée est activé, une section supplémentaire de InspectEdge Vision Data Access functions est insérée dans la feuille de calcul des erreurs de position.