# Filter

Produit une image de sortie dont chaque pixel résulte d’une technique d’amélioration de l’image, dans l’image d’entrée ou dans la région d’intérêt (ROI) spécifiée.

## Filter – Présentation

Une fonction polyvalente. Filter génère une image utilisée pour améliorer les images à faible contraste et/ou pour exposer les caractéristiques d’une image. Cette fonction aide à accentuer les caractéristiques voulues et minimise celles qui ne sont pas souhaitées pour la plupart des pièces. Lorsqu’elle est utilisée efficacement, cette fonction rend les applications d’inspection plus fiables et plus reproductibles.

La fonction Filter propose toute une gamme de techniques d’amélioration d’image locales et globales. La technique d’amélioration d’image est définie en sélectionnant un type de filtre.

### Utilisation de la fonction Filter

La configuration de la fonction Filtre implique d’identifier la technique d’amélioration de l’image en sélectionnant un Type de filtre à utiliser pour améliorer l’image.

1. Pour commencer, chargez une image. Insérez la fonction Filter dans la feuille de calcul, et modifiez sa Région afin qu’elle englobe la surface de l’image à améliorer. Lorsque vous configurez la région, assurez-vous de n’englober que les surfaces de l’image qui doivent être améliorées. Englober des zones n’ayant pas besoin d’améliorations impacte la durée d’exécution de la fonction et la technique d’amélioration d’image utilisée.
2. Ensuite, sélectionnez le type de filtre approprié. En fonction du type de filtre sélectionné, des paramètres supplémentaires peuvent être modifiés affiner l’application de la technique d’amélioration. Réglez les paramètres disponibles pour obtenir l’effet d’amélioration d’image souhaité.

Remarque :

- Si la zone de l’image qui doit être améliorée présente des effets de mouvement, utilisez un repère pour que la région se déplace en fonction de la zone.
- Après avoir configuré la fonction, chargez des images supplémentaires. Ajustez alors les paramètres, si nécessaire, pour vous assurer que la technique d’amélioration de l’image est appliquée correctement sur toute la série d’images.

## Filter – Entrées

Paramètre | Description
Image | Ce paramètre doit utiliser les Références à des cellules de la 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 Image renvoyée par la fonction. Ce paramètre peut également faire référence à d’autres structures de données Image, telles que celles renvoyées par les Fonctions Image de l’outil de vision.
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).
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. Effectuez un double-clic sur le paramètre Région pour créer un Mode Graphiques interactifs que vous pouvez transformer et faire pivoter. Sélectionnez ce paramètre et cliquez sur le bouton Agrandir la région dans la barre d’outils Modification du projet de la feuille de propriétés pour agrandir automatiquement la région pour qu’elle couvre l’intégralité de 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).
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.
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.
Région externe | Détermine les Références à des cellules pour une cellule de feuille de calcul qui contient une structure de données Fonctions de contrôle. 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.
Type de filtre | Indique le type de technique d’amélioration d’image à effectuer. Le résultat obtenu est une image de sortie en niveaux de gris.
0 = Binariser (par défaut) | Détermine une opération de seuil noir/blanc (« binaire ») qui compare chaque pixel d’entrée avec le niveau de seuil pour déterminer si le pixel de sortie est blanc ou noir. Ceux avec une valeur égale ou supérieure au paramètre Seuil sont blancs, tandis que ceux inférieurs au seuil sont noirs. Remarque : Si l’image d’entrée est en couleur, l’image de sortie est en niveaux de gris.
1 =Bas de forme | Définit une opération de filtrage de bas de forme qui permet de tout filtrer à l’exception des caractéristiques sombres dont la taille est inférieure à celle du voisinage du noyau. Le résultat est une image de sortie qui affiche ces caractéristiques sombres sous forme de pixels clairs, sur un arrière-plan autre que sombre. Remarque : Cette opération active les paramètres Lignes du noyau et Colonnes du noyau. Le noyau doit être constitué de valeurs entières impaires.
2 = Couper | Définit une opération de type « coupure » qui supprime les extrémités du spectre de niveaux de gris, de sorte que les caractéristiques de l’image de sortie soient plus uniformes. Cette opération compare la valeur de niveaux de gris de chaque pixel d’entrée avec les valeurs des paramètres Min./Max. : Si la valeur du pixel d’entrée est égale/dépasse la valeur Min./Max., la valeur minimale, ou maximale selon le cas, est attribuée au pixel de sortie après coupure. Si la valeur du pixel d’entrée est comprise entre les valeurs Min. et Max., le pixel de sortie conserve sa valeur.
3 = Fermer | Définit une opération de type « fermeture" qui réalise une dilatation suivie d’une érosion pour filtrer les caractéristiques sombres qui sont plus petites que la taille du voisinage du noyau. La fermeture d’une image réduit ou supprime complètement les zones sombres de l’image. Remarque : Cette opération active les paramètres Lignes du noyau et Colonnes du noyau. Le noyau doit être constitué de valeurs entières impaires.
4 = Dilatation | Définit une opération de type « dilatation » qui met en valeur les caractéristiques claires de l’image tout en supprimant celles qui sont plus sombres. Le résultat est une image qui présente des zones de pixels clairs plus importantes. Utile pour supprimer les taches sombres. Remarque : Cette opération active les paramètres Lignes du noyau et Colonnes du noyau. Le noyau doit être constitué de valeurs entières impaires.
5 = Amplitude des bords | Spécifie une opération qui affiche la différence entre la dilatation et l’érosion de l’image d’entrée. Le résultat est une image de sortie dont les bords sont représentés par des pixels clairs. Malgré sa ressemblance avec un autre composant, cette opération est plus complexe (et plus lente), permettant ainsi de représenter des bords en diagonale. Remarque : Cette opération active les paramètres Lignes du noyau et Colonnes du noyau. Le noyau doit être constitué de valeurs entières impaires.
6 = Répartir | Spécifie une opération d’égalisation d’histogramme qui extrait l’histogramme de l’image d’entrée et égalise les valeurs de niveaux de gris les plus fréquentes pour créer une distribution plus homogène. Le résultat est une image de sortie avec un contraste accru. Ce type de filtre est utile dans les environnements où l’éclairage présente de légères variations d’une image à l’autre, ou lorsque certains aspects de l’objet inspecté peuvent varier.
7 = Érosion | Définit une opération de type « érosion » qui réduit les caractéristiques claires de l’image. Le résultat est une image qui présente des zones de pixels sombres plus importantes. Utile pour supprimer les taches claires, les pixels parasites et/ou les petits défauts. Remarque : Cette opération active les paramètres Lignes du noyau et Colonnes du noyau. Le noyau doit être constitué de valeurs entières impaires.
8 = Remplir les trous sombres | Définit une opération de type « remplissage », où les pixels sombres entourés de pixels clairs sont convertis en pixels clairs. Le résultat est une image de sortie dans laquelle les trous foncés sont remplis.
9 = Remplir les trous clairs | Définit une opération de type « remplissage », où les pixels clairs entourés de pixels sombres sont convertis en pixels sombres. Le résultat est une image de sortie dans laquelle les trous clairs sont remplis.
10 = Gradient complet | Définit une opération de type « gradient vertical et horizontal » qui génère une image de sortie où les bords orientés verticalement et horizontalement sont représentés par des pixels clairs. Bien que similaire à l’opération Magnitude des bords, cette opération est plus simple (et plus rapide) et ne représente pas les bords orientés en diagonale.
11 = Gradient horizontal | Définit une opération de type « gradient horizontal » qui génère une image de sortie où les bords orientés horizontalement sont représentés par des pixels clairs.
12 = Gradient vertical | Définit une opération de type « gradient vertical » qui génère une image de sortie où les bords orientés verticalement sont représentés par des pixels clairs.
13 = Distance en niveaux de gris | Indique la valeur de niveaux de gris de chaque pixel de sortie, sous forme de différence entre la valeur de niveaux de gris de chaque pixel d’entrée et le niveau seuil (par exemple, la valeur du pixel de sortie est 75 si la valeur du pixel d’entrée est 100 et celle du seuil 25), déterminé par le paramètre Seuil.
14 = Passe haut | Définit une opération de type « passe-haut » qui génère une image de sortie où les bords sont améliorés par rapport aux zones présentant un gradient de niveaux de gris plus cohérent. Ce type de filtre est utile pour accentuer les caractéristiques fines. Remarque : Cette opération active les paramètres Lignes du noyau et Colonnes du noyau. Le noyau doit être constitué de valeurs entières impaires.
15 = Inverser | Définit une inversion des valeurs des pixels, basée sur les niveaux de gris (256 nuances). L’image de sortie est un « négatif » de l’image d’entrée (par exemple, l’inversion d’une valeur de pixel d’entrée, de valeur 10, donne une valeur de pixel de sortie de 245).
17 = Médian local | Spécifie une opération qui calcule la valeur de pixel médiane des valeurs de pixels au voisinage du noyau, puis utilise ce résultat comme valeur de pixel de l’image de sortie. Remarque : Cette opération active les paramètres Lignes du noyau et Colonnes du noyau. Le noyau doit être constitué de valeurs entières impaires.
18 = Normalisation du médian local | Spécifie un moyen de soustraire l’arrière-plan d’une image. Cette opération soustrait le médian local de l’image d’entrée de cette dernière, décale le résultat d’une unité, puis ajoute 128 pour produire la valeur du pixel de sortie. Remarque : Cette opération active les paramètres Lignes du noyau et Colonnes du noyau. Le noyau doit être constitué de valeurs entières impaires.
19 = Passe-bas | Définit une opération de type « passe-bas » qui génère une image de sortie dans laquelle les bords sont lissés ou flous. Remarque : Cette opération active les paramètres Lignes du noyau et Colonnes du noyau. Le noyau doit être constitué de valeurs entières impaires.
20 = Max (haut de forme/bas de forme) | Spécifie une opération qui utilise le maximum des opérations Haut de forme et Bas de forme. Remarque : Cette opération active les paramètres Lignes du noyau et Colonnes du noyau. Le noyau doit être constitué de valeurs entières impaires.
21 = Ouverture | Définit une opération de type « ouverture » qui réalise une érosion suivie d’une dilatation pour filtrer les caractéristiques claires plus petites que la taille du voisinage du noyau. Le résultat est une image de sortie dont la luminosité globale est légèrement diminuée, après suppression d’une partie des pixels clairs et amélioration de ceux restants. Remarque : Cette opération active les paramètres Lignes du noyau et Colonnes du noyau. Le noyau doit être constitué de valeurs entières impaires.
22 = Densité optique | Définit une inversion des valeurs de pixel basée sur une échelle logarithmique. Valeur du pixel de sortie = 100 × log (255) - 100 × log (valeur du pixel d’entrée) Le résultat est une image de sortie qui révèle la densité des objets et des caractéristiques de l’image d’entrée par la mesure de la quantité de lumière qui les traverse. Les objets et caractéristiques plus denses sont représentés par des pixels plus clairs dans l’image de sortie.
23 = Accentuer | Spécifie une opération de « netteté » utilisée pour étendre les bords. L’opération évalue le contraste entre les pixels adjacents et augmente le contraste quand il est élevé. Une différence de contraste importante entre des pixels adjacents représente habituellement un bord. Cependant, cette opération ne doit pas être utilisée pour localiser les bords. Les effets produits par cette opération dépendant du contenu et de la résolution de l’image. Les paramètres Lissé faible et Lissé élevé sont utilisés pour identifier les bords en créant des noyaux gaussiens. La plage définie par les deux paramètres doit englober les dimensions de l’élément à améliorer. Par défaut, le paramètre Lissé faible a pour valeur 0 : ainsi, les bords des caractéristiques de toute taille sont améliorés de façon égale. Le paramètre Lissé est utilisé pour identifier les bords en créant un noyau gaussien. Le paramètre Gain détermine l’intensité de l’accentuation, et le paramètre Seuil est utilisé pour réduire le bruit. Il indique au filtre d’ignorer une certaine différence entre les pixels lors de l’accentuation, afin que les zones légèrement texturées ne soient pas trop accentuées.
24 = Etendre | Définit une opération d’extension des niveaux de gris qui « augmente » ou « étire », de façon linéaire, les valeurs de niveaux de gris (en fonction des paramètres Min./Max.) de l’image d’entrée. L’image de sortie, en niveaux de gris (256 nuances), présente un contraste accru. Si la valeur du pixel d’entrée est égale/dépasse la valeur Min./Max., la valeur minimale, ou maximale selon le cas, la valeur 0 ou 255 est assignée au pixel de sortie. Pour les valeurs de pixels d’entrée comprises entre le minimum et le maximum, elles seront étirées linéairement dans la plage de 0 à 255. Par exemple, si la valeur Min. est 50 et la valeur Max. 180, l’opération soustrait 50 unités de l’intensité de chaque pixel, soit une plage comprise entre 0 et 130. Ensuite, l’intensité de chaque pixel est multipliée par 255/130, créant ainsi une plage de 0 à 255.
25 = Plage de seuil | Détermine une opération de seuil noir/blanc (« binaire ») qui compare chaque pixel d’entrée avec les valeurs de niveaux de gris Seuil (Min. et Max.) pour déterminer si le pixel de sortie est de premier plan ou d’arrière-plan. Si la valeur du pixel d’entrée est comprise entre les valeurs Min. et Max., le pixel de sortie conserve sa valeur. Dans le cas contraire, le pixel de sortie se base sur le niveau d’arrière-plan. Remarque : Si la valeur minimale est supérieure à la valeur maximale, l’arrière-plan est inversé.
26 = Haut-de-forme | Définit une opération de filtrage de type « haut de forme », qui permet de tout filtrer à l’exception des caractéristiques claires dont la taille est inférieure au voisinage du noyau. Le résultat est une image de sortie qui affiche ces caractéristiques claires sous forme de pixels clairs, sur un arrière-plan autre que sombre. Remarque : Cette opération active les paramètres Lignes du noyau et Colonnes du noyau. Le noyau doit être constitué de valeurs entières impaires.
Lignes du noyau | Spécifie le nombre de lignes (1 à 25 ; valeur par défaut = 3) du noyau. Un noyau est un tableau rectangulaire de nombres qui définit le voisinage de traitement pour les opérations effectuées sur chaque emplacement de pixel d’une image. Les valeurs de niveaux de gris des voisins d’un pixel définissent la valeur de niveaux de gris de cet emplacement de pixel dans l’image de sortie. Remarque : Le noyau est non pondéré. Le noyau doit être constitué de valeurs entières impaires. Un noyau est habituellement de 3 x 3, mais sa taille est arbitraire. Ce paramètre est activé quand le Type de filtre est défini sur un des éléments suivants : Bas de forme Fermer Dilatation Amplitude des bords Érosion Érosion moins dilatation Passe-haut Normalisation du médian local Médian local Normalisation du médian local Passe-bas Max (haut de forme/bas de forme) Ouvrir Haut-de-forme
Colonnes du noyau | Spécifie le nombre de colonnes (1 à 25 ; valeur par défaut = 3) du noyau. Un noyau est un tableau rectangulaire de nombres qui définit le voisinage de traitement pour les opérations effectuées sur chaque emplacement de pixel d’une image. Les valeurs de niveaux de gris des voisins d’un pixel définissent la valeur de niveaux de gris de cet emplacement de pixel dans l’image de sortie. Remarque : Le noyau est non pondéré. Le noyau doit être constitué de valeurs entières impaires. Un noyau est habituellement de 3 x 3, mais sa taille est arbitraire. Ce paramètre est activé quand le Type de filtre est défini sur un des éléments suivants : Bas de forme Fermer Dilatation Amplitude des bords Érosion Érosion moins dilatation Passe-haut Normalisation du médian local Médian local Normalisation du médian local Passe-bas Max (haut de forme/bas de forme) Ouvrir Haut-de-forme
Seuil auto | Spécifie si la fonction détermine automatiquement un niveau de seuil lorsque le Type de filtre est défini sur Binariser, Distance en niveaux de gris ou Plage de seuil. Remarque : Ce paramètre est activé par défaut. Pour utiliser le paramètre Seuil , désactivez ce paramètre. Lorsqu’elle est activée, et que Filter est réglée sur Binariser, la fonction calcule automatiquement un niveau de seuil basé sur les valeurs de niveaux de gris dans la région spécifiée. S’il est activé et le Type de filtre est défini sur Distance en niveaux de gris, la fonction calcule automatiquement un niveau de seuil d’après la valeur de niveaux de gris moyenne dans la région indiquée. S’il est activé et le Type de filtre est défini sur Plage de seuil, ce qui suit s’applique automatiquement : Les valeurs de pixel seront définies selon l’arrière-plan si elles sont inférieures à la définition du paramètre Min ou si elles sont supérieures à la définition du paramètre Max. Les valeurs de pixel seront définies selon le premier plan si elles se situent entre les définitions des paramètres Min et Max.
Seuil | Définit les niveaux de seuil (0 à 255 ; valeur par défaut = 128) lorsque le Type de filtre est défini sur Binariser, Distance en niveaux de gris, Accentuer ou Plage de seuil. Remarque : Le paramètre Seuil automatique est activé par défaut. Il doit être désactivé pour utiliser ce paramètre. Si le Type de filtre est défini sur Accentuer, ce paramètre permet de réduire du bruit et indique à la fonction d’ignorer une certaine quantité de différences entre les pixels lors de l’accentuation, de sorte que les zones légèrement texturées ne soient pas trop accentuées.
Min | Définit la valeur de niveaux de gris minimale (0 à 255 ; valeur par défaut = 128) lorsque le Type de filtre est défini sur Couper, Étirer ou Plage de seuil.
Max | Définit la valeur de niveaux de gris maximale (0 à 255 ; valeur par défaut = 128) lorsque le Type de filtre est défini sur Couper, Étirer ou Plage de seuil.
Gain | Définit la valeur du gain (0 à 10 ; valeur par défaut = 1) lorsque le Type de filtre est défini sur Accentuer. Ce paramètre impose l’intensité de l’accentuation qui sera appliquée en contrôlant le niveau d’amélioration du contraste des bords. Les pixels autour d’un bord sont amenés à leur valeur minimale ou maximale afin d’accentuer l’apparence du bord.
Lissé | Définit la valeur du lissé (1 à 4 ; valeur par défaut = 1) lorsque le Type de filtre est défini sur Accentuer. Le lissé contrôle l’écart standard du noyau gaussien. Des valeurs de lissé plus élevées entraînent une ouverture plus large de l’opération de lissé, ce qui favorise l’accentuation des caractéristiques. Remarque : Gaussien fait référence à une courbe en forme de cloche appliquée sous forme de moyenne pondérée aux pixels situés dans la région d’intérêt.
Afficher | Indique les graphiques superposés visibles sur l’image.
0 = masquer tout (par défaut) | La région d’image d’entrée est masquée, sauf si la cellule contenant la fonction Filter est en surbrillance dans la feuille de calcul.
1 = graphiques de résultats uniquement | L’image traitée est affichée à tout moment.
2 = graphiques d’entrée uniquement | La région d’image d’entrée est toujours affichée.

## Filter – Sorties

Renvoie | Une structure de données Image contenant l’image traitée, ou #ERR si un paramètre d’entrée est incorrect. Remarque : Le contenu de la région de l’image traitée dans la structure de données Image n’est pas enregistré avec le projet. Des informations supplémentaires concernant les valeurs renvoyées par la fonction sont accessibles via les fonctions Image Fonctions Vision Data Access (VDA).