# FindPatMaxPatterns

Recherche des objets dans une image en fonction d’un modèle appris. (Une description géométrique interne apprise d’un objet que vous recherchez.) FindPatMaxPatterns recherche des modèles dans une image en fonction d’un modèle appris depuis une structure Pattern.

## FindPatMaxPatterns – entrées

Paramètre | Description
Image | This parameter must reference a spreadsheet cell that contains an Image data structure; by default, this parameter references A0, the cell containing the data structure. This parameter can also reference other Image data structures, such as those returned by the Image Vision Data Access functions or Fonctions de conversion de coordonnées.
Repère | Définit la Région de recherche 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 de recherche | 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 | La dimension le long de l’axe des x de la région.
Hauteur | La dimension le long de l’axe des 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.
Région externe | Ce paramètre utilise les Références à des cellules pour un Annulus, un Circle, une Region, EditAnnulus EditCircle, EditCompositeRegion, EditPolygon et 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. Si un contrôle EditCompositeRegion est référencé, la zone d’inspection peut être un mélange de formes. Chaque forme de la région composite peut être affectée, ajoutée ou soustraite (masquage), à la zone d’inspection. 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.
Modèle | Cet argument doit faire référence à une cellule de feuille de calcul contenant une structure de données Patterns valide, renvoyée par la fonction TrainPatMaxPattern.
Nombre à chercher | Détermine le nombre maximum de formes reconnues à renvoyer (1 à 1024 ; 1 par défaut).
Accepter | Détermine le seuil d’acceptation, qui est le score le plus bas pour une instance valide. Le score d’une correspondance potentielle doit être supérieur à la valeur du seuil d’acceptation, sinon cette correspondance ne sera pas renvoyée (0 à 100 ; par défaut = 50).
Contraste | Détermine le contraste le plus faible d’une instance valide. Le contraste d’une correspondance potentielle doit être supérieur à la valeur seuil du contraste, sinon cette instance n’est pas prise en compte (0 à 255 ; par défaut = 10). Une faible valeur de seuil de contraste est utilisée pour des images peu contrastées, alors qu’une valeur élevée est utilisée pour des images extrêmement contrastées.
Score d’encombrement | Indique si des caractéristiques manquantes ou obstruées du modèle réduisent les scores de réponse.
0 = OFF | N’inclut pas l’effet d’encombrement dans le score.
1 = ON (par défaut) | Intègre l’effet d’encombrement dans le score.
Hors région | Définit le pourcentage des contours de modèle pouvant être trouvés en dehors de la région de recherche sans nuire au score de correspondance (0 à 100 ; par défaut = 0).
Recherche de tolérances | Définit les paramètres de recherche des modèles, dont l’orientation et l’échelle diffèrent du modèle appris.
Angle de départ | Indique l’angle auquel commencer la recherche de correspondances, en degrés, dans le sens inverse des aiguilles d’une montre (-180 à 180 ; par défaut = -15).
Angle de fin | Indique l’angle auquel arrêter la recherche de correspondances, en degrés, dans le sens inverse des aiguilles d’une montre (-180 à 180 ; par défaut = 15).
Echelle de départ | Indique l’échelle à laquelle commencer la recherche de correspondances (1 à 10000 ; par défaut = 100).
Echelle de fin | Indique l’échelle à laquelle arrêter la recherche de correspondances (1 à 10000 ; par défaut = 100).
Rapport H/L | Limite la recherche de correspondance à l’échelle uniforme uniquement ou permet de modifier le rapport hauteur/largeur en X ou Y, en plus d’une échelle uniforme. Remarque : Les paramètres Rapport H/L de départ et Rapport H/L de fin sont désactivés si le changement d’échelle uniforme est sélectionné.
0 = Changement d’échelle uniforme
1 = Uniforme et changement d’échelle en X
2 = Uniforme et changement d’échelle en Y
Rapport H/L de départ | Indique le changement d’échelle minimum à partir duquel la recherche de correspondances peut commencer, sous forme de pourcentage du modèle appris (1 à 10000 ; par défaut = 100).
Rapport H/L de fin | Indique le changement d’échelle maximum à partir duquel la recherche de correspondances peut s’arrêter, sous forme de pourcentage du modèle appris (1 à 10000 ; par défaut = 100).
Recherche de superposition | Détermine les paramètres de recherche des modèles qui se chevauchent/superposent en matière de position, de rotation et d’échelle.
Superposition des axes XY | Indique le décalage de position attendu entre plusieurs modèles superposés ayant sensiblement la même position X,Y, exprimé en pourcentage de la taille du modèle appris (0 à 100 ; par défaut = 80). Remarque : Augmenter cette valeur permet de trouver plusieurs correspondances se superposant pour le même modèle.
Superposition d’angle | Indique l’angle attendu entre plusieurs modèles superposés en rotation ayant sensiblement la même position X,Y. A (0 à 360 ; par défaut = 360). Remarque : Le paramètre Superposition d’angle est désactivé si les valeurs des paramètres Angle de départ et Angle de fin sont identiques. Augmenter cette valeur permet de trouver plusieurs correspondances se superposant pour le même modèle.
Superposition d’échelle | Définit la variation d’échelle uniforme attendue entre plusieurs modèles superposés ayant sensiblement la même position X,Y, exprimée en pourcentage de la taille du modèle appris (1 à 10000 ; par défaut = 140). Remarque : Le paramètre Superposition d’échelle est désactivé si les valeurs des paramètres Echelle de départ et Echelle de fin sont identiques. Augmenter cette valeur permet de trouver plusieurs correspondances se superposant pour le même modèle.
Superposition de rapport H/L | Définit la variation de rapport d’échelle H/L attendue entre plusieurs modèles superposés ayant sensiblement la même position X,Y, exprimée en pourcentage de la taille du modèle appris (1 à 10000 ; par défaut = 140). Remarque : Le paramètre Superposition de rapport H/L est désactivé si le changement d’échelle uniforme est sélectionné pour le Rapport H/L ou si les valeurs des paramètres Rapport H/L de départ et Rapport H/L de fin sont identiques. Augmenter cette valeur permet de trouver plusieurs correspondances se superposant pour le même modèle.
Délai d’attente | Indique la durée, en millisecondes, (0 à 30000 ), pendant laquelle la fonction recherche des modèles avant que son exécution ne soit interrompue et que #ERR ne soit renvoyé. le réglage de la valeur sur 0 désactive le réglage et aucun délai n’est appliqué.
Algorithme | Spécifie l’algorithme qui sera utilisé pour traiter l’image du modèle appris.
0 = PatMax | L’algorithme PatMax est plus précis que PatQuick, mais son exécution nécessite plus de temps.
1 = PatQuick | L’algorithme PatQuick est moins précis que PatMax, mais son exécution nécessite moins de temps.
2 = Modèle appris (par défaut) | La fonction FindPatMaxPatterns utilise l’algorithme (PatMax ou PatQuick) spécifié dans le paramètre Algorithme de la fonction TrainPatMaxPattern référencée dans le paramètre Modèle.
Afficher | Détermine le mode d’affichage des graphiques superposés sur l’image.
0 = masquer tout (par défaut) | Tous les graphiques sont masqués, sauf si la cellule contenant la fonction FindPatMaxPatterns est la cellule active dans la feuille de calcul.
1 = graphiques de résultats uniquement | Une croix sera affichée à tout moment pour chaque modèle trouvé.
2 = graphiques d’entrées et de résultats | La région de l’image d’entrée et une croix pour chaque modèle trouvé sont systématiquement affichées.
3 = afficher tout : entrée, résultat et caractéristiques de correspondance | La région de l’image d’entrée, une croix pour chaque modèle trouvé, et les caractéristiques de correspondance PatMax® sont toujours affichées. Remarque : Les caractéristiques de correspondance ne sont pas affichées lorsque PatQuick est sélectionné pour le paramètre Algorithme de TrainPatMaxPattern. Caractéristiques de correspondance en vert = correspondance de 67 à 100 %. Caractéristiques de correspondance en jaune = correspondance de 20 à 66 %. Caractéristiques de correspondance en rouge = correspondance inférieure à 20 %.

## FindPatMaxPatterns – Sorties

Renvoie | Une structure de données Patterns contenant les blobs extraits de l’image ou #ERR si l’un des paramètres d’entrée est incorrect ou qu’aucun modèle correspondant n’a été trouvé.
Résultats | Un tableau de résultats est créé dans la feuille de calcul lorsque FindPatMaxPatterns est insérée dans une cellule pour la première fois. Remarque : Dans la feuille de propriétés de la fonction, des chaînes de caractères informatives supplémentaires sont proposées pour vous aider à trouver des modèles. Pour obtenir une liste des chaînes de caractères informatives possibles : [Valeur] résultat(s) rejeté(s) en raison de faibles contrastes. [Valeur] résultat(s) rejeté(s) en raison de similitudes avec des résultats plus fiables. [Valeur] résultat(s) rejeté(s) en raison d’un encombrement excessif. Le modèle appris comporte trop peu de caractéristiques compte tenu des paramètres actuels. Pour insérer des chaînes d’informations dans la feuille de calcul, utilisez la fonction Vision Data Access GetInfoString.

## FindPatMaxPatterns Vision Data Access functions

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

Label | Fonction | Description
X | GetX(Patterns, Index) | Abscisse du centre de la position du modèle.
Y | GetY(Patterns, Index) | Ordonnée du centre de la position du modèle.
Angle | GetAngle(Patterns, Index) | Orientation de la position du modèle.
Échelle | GetScale(Patterns, Index) | Taille du modèle trouvé comparé au modèle appris, indiquée en pourcentage de la taille du modèle.
Score | GetScore(Patterns, Index) | Score de réponse de modèles.