# SortPatterns

Trie les modèles en fonction de leur position dans l’image. Pour chaque modèle de la structure de données Patterns d’entrée, la fonction SortPatterns calcule la position de la réponse du modèle en fonction du système de coordonnées du repère spécifié. Les modèles sont triés selon l’un des critères suivants : abscisse, ordonnée, angle, distance angulaire, distance ou grille. Ils sont ensuite renvoyés sous la forme d’une nouvelle structure de données Patterns.

## SortPatterns – Entrées

Paramètre | Description
Modèles | 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.
Nombre à classer | Définit le nombre maximum de modèles à trier (1 à 255 ; par défaut = 1).
Trier par | Détermine la méthode de tri.
0 = Y (par défaut) | Trie par distance, en fonction des ordonnées du repère, du plus petit au plus grand.
1 = X | Trie par distance, en fonction des abscisses du repère, du plus petit au plus grand.
2 = Angle | Trie par angle (0 à 360 degrés), mesuré dans le sens antihoraire entre l’axe des ordonnées du système de coordonnées du repère et le segment défini par le point origine du modèle et l’origine du repère, du plus proche au plus éloigné, dans l’ordre décroissant.
3 = Distance angulaire | Trie par valeur absolue de l’angle (-180 à 180 degrés), mesuré entre l’axe des abscisses du système de coordonnées de repère et le segment défini par le point origine du modèle et l’origine du repère, du plus proche au plus éloigné, dans l’ordre décroissant.
4 = Distance | Trie selon la distance entre le repère de référence et le point origine du modèle, de la plus proche à la plus éloignée, par ordre décroissant.
5 = Grille Y | Trie d’abord par distance, en fonction des ordonnées du repère, puis par distance, en fonction des abscisses, du plus proche au plus éloigné, par ordre décroissant. Remarque : SortPatterns renvoie #ERR si la Grille Y est sélectionnée et la fonction fait référence à une image calibrée avec des valeurs de coordonnées réelles, comme la sortie d’une fonction CalibrateImage ou TransPatternsToWorld. Le tri de la Grille Y ne peut être appliqué qu’aux coordonnées de pixels.
6 = Grille X | Trie d’abord par distance, en fonction des abscisses du repère, puis par distance, en fonction des ordonnées, du plus proche au plus éloigné, par ordre décroissant. Remarque : SortPatterns renvoie #ERR si la Grille Y est sélectionnée et la fonction fait référence à une image calibrée avec des valeurs de coordonnées réelles, comme la sortie d’une fonction CalibrateImage ou TransPatternsToWorld. Le tri de la Grille Y ne peut être appliqué qu’aux coordonnées de pixels.
Repère | Définit le modèle référencé par rapport à une entrée de Fixture ou à la sortie du système de coordonnées d’image d’une fonction de l’Outils de vision. En définissant le modèle référencé par rapport à un Repère, toute rotation ou translation de ce dernier entraînera systématiquement une rotation/translation du modèle référencé, 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).
Tolérance de tri | Définit le pourcentage de taille (1% - 500% ; valeur par défaut = 50%) de la hauteur du modèle appris pour un modèle trouvé. Cette valeur sera incluse dans le groupe de modèles lorsqu’un tri (par Grille X ou Grille Y) sera effectué. Remarque : Ce paramètre n’est utilisé que lorsque le paramètre Trier par est défini sur Grille X ou Grille Y.
Afficher | Détermine le mode d’affichage des graphiques SortPatterns superposés à l’image.
0 = masquer tout (par défaut) | Tous les graphiques sont masqués, sauf si la cellule contenant la fonction SortPatterns est en surbrillance dans la feuille de calcul.
1 = graphiques de résultats uniquement | Une croix sera affichée à tout moment pour chaque modèle trouvé.
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 sont toujours affichées. Remarque : Les caractéristiques de correspondance ne sont affichées que pour les modèles entraînés par PatMax.

## SortPatterns – Sorties

Renvoie | Une structure de données Patterns contenant les réponses de modèles triés, ou #ERR si un paramètre d’entrée est incorrect.
Résultats | Un tableau de résultats est créé dans la feuille de calcul lorsque la fonction SortPatterns est insérée dans une cellule pour la première fois, à l’aide des Fonctions Vision Data Access (VDA) Patterns suivantes :
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 en pourcentage du modèle d’origine.
Score | GetScore(Patterns, Index) | Score de réponse de modèles.
Remarque : Si la valeur du paramètre Nombre à classer est supérieure à zéro, SortPatterns insère automatiquement un tableau de résultats contenant maximum 10 entrées, correspondant aux 10 premiers modèles de la structure de données Patterns. 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. N’oubliez pas d’incrémenter le numéro d’index des nouvelles lignes afin que le bon modèle soit indexé.