> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/french/function-blocks/blocks-reference/image-transformations/analysis/histogram-on-line.md).

# Histogram On Line

Ce bloc fonction analyse les valeurs de pixels le long d'une ligne définie dans une image en niveaux de gris ou binaire. Il détecte les segments où les valeurs de pixels dépassent un seuil et affiche la ligne ainsi que les segments trouvés sur une image de sortie.

## 📥 Entrées <a href="#inputs" id="inputs"></a>

`Input Image (Binary Image)` Une image binaire ou en niveaux de gris utilisée pour l'analyse sur la ligne.

## 📤 Sorties <a href="#outputs" id="outputs"></a>

`Output Image` L'image source annotée avec la ligne tracée et des marqueurs pour les segments de pic détectés.

`Peak Count` Nombre de segments dépassant le seuil détectés le long de la ligne.

`Peak Start Locations` Liste des coordonnées de début pour chaque segment détecté.

`Peak End Locations` Liste des coordonnées de fin pour chaque segment détecté.

`Peak Mean Locations` Liste des coordonnées moyennes (centre) pour chaque segment détecté.

## 🕹️ Contrôles <a href="#controls" id="controls"></a>

`Relation` Menu déroulant pour choisir l'orientation de la ligne (verticale ou horizontale).

`Line Location` Curseur / saisie pour choisir la position en pixels de la ligne. Accepte une valeur unique ; validée par rapport à la taille de l'image.

`Pixel Threshold` Curseur / saisie pour le seuil de valeur de pixel (0–255) utilisé pour déterminer les segments actifs.

## 🎨 Fonctionnalités <a href="#features" id="features"></a>

* Retour visuel avec une ligne rouge et des marqueurs colorés indiquant le début, la fin et la position moyenne des segments.
* Accepte des lignes verticales ou horizontales et valide la position de la ligne selon les dimensions de l'image.
* Ignore les segments qui touchent les bords de l'image (comportement configurable) pour éviter les artefacts de bord.
* Fournit des sorties visuelles et structurées pour un traitement ultérieur.

## 📝 Mode d'emploi <a href="#usage" id="usage"></a>

1. Fournissez une image en niveaux de gris ou binaire à l'entrée `Input Image (Binary Image)`.
2. Choisissez l'orientation de la ligne avec `Relation`.
3. Réglez la `Line Location` (indice pixel) à l'intérieur des limites de l'image.
4. Définissez le `Pixel Threshold` entre 0 et 255 pour contrôler la sensibilité.
5. Exécutez le bloc pour obtenir une image annotée et des listes de coordonnées des segments détectés.

## 📊 Évaluation <a href="#evaluation" id="evaluation"></a>

Lors de l'exécution, le bloc échantillonne les valeurs de pixels le long de la ligne choisie, trouve les segments contigus où les valeurs atteignent ou dépassent le seuil, les marque sur l'image de sortie et renvoie le nombre ainsi que les listes de coordonnées.

## 💡 Astuces <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Prétraitez les entrées bruyantes avec `Blur` pour réduire les détections parasites, ou utilisez `Image Threshold` pour obtenir une image binaire propre avant l'analyse.
* Utilisez `Image ROI Select` ou `Image ROI` pour recadrer la zone d'intérêt afin que les coordonnées de la ligne soient plus simples et pertinentes.
* Combinez avec `Draw Line` si vous souhaitez placer la ligne de façon interactive sur l'image affichée, puis copiez la position en pixels dans `Line Location`.
* Utilisez `HSV Filter` pour isoler des canaux de couleur ou des caractéristiques avant la conversion en niveaux de gris pour une détection de pics plus fiable.
* Inspectez visuellement les résultats en connectant la sortie image à `Show Image` pour ouvrir un affichage plus large et vérifier les segments détectés.
* Si votre flux peut produire des images vides, pensez à `Is None` pour protéger la logique en aval contre les résultats manquants.

## 🛠️ Dépannage <a href="#troubleshooting" id="troubleshooting"></a>

* Si aucun pic n'est détecté, essayez d'abaisser le `Pixel Threshold` ou prétraitez l'image avec `Image Threshold` / `Blur`.
* Si la position de la ligne cause des erreurs, assurez-vous que la `Line Location` est comprise dans la largeur (pour vertical) ou la hauteur (pour horizontal) de l'image. Le bloc signalera et ajustera les valeurs hors plage.
* Si de nombreux petits segments apparaissent, augmentez le seuil ou lissez d'abord l'image avec `Blur`.