> 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/german/function-blocks/image-transformations/analysis/histogram-on-line.md).

# Histogram On Line

Dieser Funktionsblock analysiert Pixelwerte entlang einer einzigen definierten Linie in einem Graustufen- oder Binärbild. Er erkennt zusammenhängende Segmente, in denen die Pixelwerte einen Schwellwert überschreiten, und visualisiert die Linie sowie die gefundenen Segmente im Ausgabe-Bild.

## 📥 Eingänge <a href="#inputs" id="inputs"></a>

`Input Image (Binary Image)` Ein Binär- oder Graustufenbild, das für die Linienanalyse verwendet wird.

## 📤 Ausgänge <a href="#outputs" id="outputs"></a>

`Output Image` Das Quellbild, annotiert mit der gezeichneten Linie und Markierungen für erkannte Peak-Segmente.

`Peak Count` Anzahl der entlang der Linie erkannten Schwellenwert-Segmente.

`Peak Start Locations` Liste der Start-Koordinaten jedes erkannten Segments.

`Peak End Locations` Liste der End-Koordinaten jedes erkannten Segments.

`Peak Mean Locations` Liste der Mittel- (Zentrum-)Koordinaten jedes erkannten Segments.

## 🕹️ Steuerungen <a href="#controls" id="controls"></a>

`Relation` Dropdown zur Auswahl der Linienorientierung (vertical oder horizontal).

`Line Location` Schieberegler / Eingabefeld zur Auswahl der Pixelposition der Linie (in Pixeln). Akzeptiert einen einzelnen Wert; wird gegen die Bildgröße validiert.

`Pixel Threshold` Schieberegler / Eingabefeld für den Pixelwert-Schwellwert (0–255), der aktive Segmente bestimmt.

## 🎨 Funktionen <a href="#features" id="features"></a>

* Visuelles Feedback: rote Linie und farbige Marker für Segmentstart, -ende und -mittel.
* Unterstützt vertikale oder horizontale Linien und validiert die Linienposition gegenüber den Bilddimensionen.
* Ignoriert Segmente, die die Bildränder berühren (konfigurierbares internes Verhalten), um Randartefakte zu vermeiden.
* Liefert sowohl visuelle als auch strukturierte Ausgaben zur Weiterverarbeitung.

## 📝 Nutzungshinweise <a href="#usage" id="usage"></a>

1. Geben Sie ein Graustufen- oder Binärbild an den Eingang `Input Image (Binary Image)`.
2. Wählen Sie die Linienorientierung über `Relation`.
3. Setzen Sie die `Line Location` (Pixelindex) innerhalb der Bildgrenzen.
4. Stellen Sie den `Pixel Threshold` zwischen 0 und 255 ein, um die Empfindlichkeit zu steuern.
5. Führen Sie den Block aus, um ein annotiertes Bild und Listen der erkannten Segment-Koordinaten zu erhalten.

## 📊 Bewertung <a href="#evaluation" id="evaluation"></a>

Bei Ausführung sampelt der Block die Pixelwerte entlang der gewählten Linie, findet zusammenhängende Segmente, deren Werte den Schwellwert erreichen oder überschreiten, markiert diese im Ausgabe-Bild und gibt die Anzahl sowie die Koordinatenlisten zurück.

## 💡 Tipps und Tricks <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Vorverarbeitung: Verwenden Sie `Blur`, um Rauschen zu reduzieren, und `Image Threshold`, um ein sauberes Binärbild zu erzeugen.
* ROI nutzen: Schneiden Sie mit `Image ROI Select` oder `Image ROI` den Bereich des Interesses aus, damit Linienkoordinaten einfacher und aussagekräftiger sind.
* Interaktive Platzierung: Kombinieren Sie mit `Draw Line`, um die Linie interaktiv zu platzieren, und übertragen Sie dann die Pixelposition in `Line Location`.
* Farbselektion: Nutzen Sie `HSV Filter`, um Farbkanäle oder Merkmale zu isolieren, bevor Sie in Graustufen konvertieren, das kann die Peak-Erkennung verbessern.
* Visuelle Kontrolle: Verbinden Sie das Ausgabe-Bild mit `Show Image`, um eine größere Ansicht zu öffnen und erkannte Segmente zu überprüfen.
* Fehlende Bilder abfangen: Falls Flows leere Bilder produzieren können, nutzen Sie `Is None`, um nachfolgende Logik zu schützen.

## 🛠️ Fehlersuche <a href="#troubleshooting" id="troubleshooting"></a>

* Keine Peaks gefunden: Versuchen Sie, den `Pixel Threshold` zu senken oder Vorverarbeitung mit `Image Threshold` / `Blur` durchzuführen.
* Fehler durch Linienposition: Stellen Sie sicher, dass die `Line Location` innerhalb der Bildbreite (für vertical) bzw. Bildhöhe (für horizontal) liegt. Der Block meldet und klemmt außerhalb liegende Werte gegebenenfalls.
* Viele kleine Segmente: Erhöhen Sie den Schwellwert oder glätten Sie das Bild zuerst mit `Blur`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.augelab.com/german/function-blocks/image-transformations/analysis/histogram-on-line.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.