# ExtractHistogram

Extrait les valeurs d’un ensemble Histogram d’une région d’image.

## ExtractHistogram – Présentation

La fonction Histogram renvoie une représentation unidimensionnelle des valeurs des pixels dans une région d’intérêt. Un histogramme est représenté par un ensemble de nombres entiers, où chaque élément de l’ensemble, appelé classe, stocke le décompte du nombre de pixels dans la région : la valeur d’une classe « n » correspond au nombre de pixels dans la région de la valeur de pixel « n ». Le total des décomptes de classes, dans l’ensemble, est égal au nombre de pixels dans la région.

## ExtractHistogram – 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.
Courbure | Écart angulaire entre l’axe X de la région et la ligne de la limite opposée.
Remarque : Pour qu’un pixel soit compté dans l’histogramme, il est impératif que ses limites soient dans la région de l’image. À l’inverse, les pixels partiellement inclus dans la région ne sont pas pris en compte. 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 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.
Afficher | Détermine le mode d’affichage des graphiques superposés de ExtractHistogram sur l’image.
0 = masquer tout (par défaut) | Tous les graphiques sont masqués, sauf si la cellule contenant la fonction ExtractHistogram est la cellule active dans la feuille de calcul.
2 = graphiques d’entrée uniquement | La région d’image d’entrée est toujours affichée.
3 = afficher tout : entrée et graphique | La région d’image d’entrée et le diagramme de l’histogramme sont toujours affichés. Remarque : Le graphique de l’histogramme est une fenêtre ancrable. Pour plus d’informations, consultez la rubrique Éditeur de feuilles de calcul – Graphiques.

## ExtractHistogram – Sorties

Renvoie | Une structure de données Hist contenant la répartition des fréquences RVB ou TSI, 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 ExtractHistogram est insérée dans une cellule pour la première fois. Les Fonctions Vision Data Access (VDA) Hist suivantes sont automatiquement insérées dans la feuille de calcul pour créer le tableau de résultats :
Label | Fonction | Description
Seuil | HistThresh(Hist, 0, 255) | Seuil binaire.
Contraste | HistContrast(Hist, 0, 255) | Contraste des niveaux de gris de l’image.
Sombres | HistCount(Hist, 0, Seuil-1) | Nombre de pixels au-dessous du seuil.
Clairs | HistCount(Hist, Seuil, 255) | Nombre de pixels au-dessus du seuil.
Moyenne | HistMean(Hist, 0, 255) | Valeur moyenne de niveaux de gris.