# TrainPatMaxRedLine

Extrait et apprend un modèle d’une image pour l’utiliser avec la fonction FindPatMaxRedLine.

Remarque : Un modèle entraîné utilise environ 1 Mo avec la région de modèle par défaut (320 x 440), bien que la taille du modèle varie considérablement en fonction de la taille du modèle entraîné.

## TrainPatMaxRedLine – 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 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 du modèle | 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 (par défaut = 440) | La dimension le long de l’axe des x de la région.
Hauteur (par défaut = 320) | La dimension le long de l’axe des y de la région.
Angle (par défaut = 0) | Orientation du repère.
Courbure (par défaut = 0) | É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.
Région externe | Ce paramètre utilise des Références à des cellules dans une cellule de feuille de calcul contenant un des éléments suivants : Annulus, Circle, Region, EditAnnulus, EditCircle, EditCompositeRegion, EditPolygon, ou 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.
Origine du modèle | Détermine l’abscisse X et l’ordonnée Y de l’origine du modèle d’apprentissage, en tant que valeurs de décalage du centre de la région d’apprentissage.
Abscisse X (par défaut = 0) | Indique le décalage en abscisse par rapport au centre du modèle appris.
Ordonnée Y (par défaut = 0) | Indique le décalage en ordonnée par rapport au centre du modèle appris.
Sélection automatique grossière | Lorsqu’elle est activée, sélectionne automatiquement la taille de la granularité du modèle à utiliser pendant la phase de recherche grossière. La granularité grossière est utilisée pour repérer des caractéristiques de grande dimension, afin de trouver rapidement une correspondance de modèle approximative dans une image en production.
0 = OFF | Une granularité grossière est utilisée.
1 = ON (par défaut) | La taille de granularité du modèle est automatiquement sélectionnée.
Sélection automatique fine | Lorsqu’elle est activée, sélectionne automatiquement la taille de la granularité du modèle à utiliser pendant la phase de recherche fine. La granularité fine est utilisée pour repérer les caractéristiques de faible dimension et de déterminer avec précision l’emplacement du modèle.
0 = OFF | Une granularité fine est utilisée.
1 = ON (par défaut) | La taille de granularité du modèle est automatiquement sélectionnée.
Granularité grossière | Indique une granularité grossière, sous forme de valeur de pixel. La granularité grossière est utilisée pour repérer des caractéristiques de grande dimension, afin de trouver rapidement une correspondance de modèle approximative dans une image en production (1 à 30 ; 4 = par défaut). Remarque : Le paramètre Sélection automatique grossière est activé par défaut. Il doit être désactivé pour utiliser ce paramètre.
Granularité fine | Indique une granularité fine, sous forme de valeur de pixel. La granularité fine est utilisée pour repérer les caractéristiques de faible dimension et de déterminer avec précision l’emplacement du modèle (1 à 10 ; 1 = par défaut). Remarque : Le paramètre Sélection automatique fine est activé par défaut. Il doit être désactivé pour utiliser ce paramètre. La valeur de la granularité fine ne peut pas être supérieure à la valeur de la granularité grossière.
Seuil de caractéristique | Indique le contraste minimum des caractéristiques apprises ; réduire la valeur pour apprendre d’autres caractéristiques à contraste faible ou l’augmenter pour les ignorer (1 à 100 ; 20 = par défaut).
Apprendre l’événement | Indique des Références à des cellules dans une cellule contenant un déclencheur d’événement d’entraînement de modèle. Remarque : L’entraînement, ou apprentissage, a lieu lorsque la feuille de propriétés est ouverte ou lorsqu’un événement déclenchant, tel qu’un bouton ou une autre cellule activée par une condition, est d’une valeur différente de zéro.
Réutiliser l’image d’apprentissage | Indique si l’image d’apprentissage du modèle est enregistrée et utilisée lors de la modification des paramètres du modèle (Origine du modèle, Sélection automatique grossière, Sélection automatique fine, Granularité grossière, Granularité fine ou Seuil de bruit).
0 = OFF (par défaut) | L’image actuelle (c’est-à-dire l’image spécifiée dans le paramètre Image) sera utilisée pour entraîner/réentraîner le modèle.
1 = ON | L’image qui a été initialement utilisée pour entraîner le modèle est utilisée pour un nouvel apprentissage du modèle si un ou plusieurs paramètres suivants du modèle sont modifiés : Origine du modèle, Sélection automatique grossière, Sélection automatique fine, Granularité grossière, Granularité fine et/ou Seuil de bruit. Lors de la première activation, l’image identifiée par le paramètre Image est utilisée pour entraîner le modèle et une copie de l’image est enregistrée dans le projet. Toute modification ultérieure des paramètres Origine du modèle, Sélection automatique grossière, Sélection automatique fine, Granularité grossière, Granularité fine ou Seuil de bruit du modèle sera appliquée avec l’image enregistrée. Remarque : Lorsque ce paramètre est activé, si l’entrée Repère est modifiée, la région du modèle (ou la région externe) est déplacée ou modifiée, la fonction ajuste la région de référence dans l’image d’entrée, enregistre la nouvelle image et réentraîne le modèle. Si le paramètre Réutiliser l’image d’apprentissage est activé, mais qu’un modèle n’a pas déjà été appris, la fonction renvoie #ERR jusqu’à ce que le paramètre soit désactivé et qu’un nouveau modèle soit appris.
Délai d’attente | Indique la durée, en millisecondes, (0 à 30000 ; 0 = par défaut), pendant laquelle la fonction recherche un modèle valide avant que son exécution ne soit interrompue et que #ERR ne soit renvoyé. Si la valeur est 0, le paramètre est désactivé et aucun délai d’attente n’est appliqué.
Afficher | Détermine le mode d’affichage des graphiques TrainPatMaxRedLine superposés à l’image.
0 = masquer tout (par défaut) | Tous les graphiques sont masqués, sauf lorsque la cellule contenant la fonction TrainPatMaxRedLine est mise en évidence dans la feuille de calcul.
1 = graphiques de résultats uniquement | Les caractéristiques apprises du modèle sont toujours affichées.
2 = graphiques d’entrées et de résultats | La région de l’image d’entrée, l’origine du modèle et les caractéristiques apprises sont toujours affichées.
3 = afficher tout : entrée, résultat et image d’apprentissage | La région de l’image d’entrée, l’origine du modèle, les caractéristiques entraînées et l’image d’apprentissage sont toujours affichées.

## TrainPatMaxRedLine – Sorties

Renvoie | Une structure de données Patterns contenant un modèle appris, ou #ERR si l’un des paramètres d’entrée est incorrect.
Résultats | Lorsque la fonction TrainPatMaxRedLine est insérée dans une cellule pour la première fois, l’état de l’apprentissage s’affiche automatiquement dans la cellule adjacente, à droite. Si un modèle ne peut pas être appris, #ERR est inséré. Une fonction Vision Data Access functions Patterns est insérée automatiquement dans la feuille de calcul :
Label | Fonction | Description
--- | --- | ---
Trained | GetTrained(Pattern) | Renvoie 1 si un modèle a été appris avec succès, et 0 si un modèle ne peut pas être entraîné.