hierarchical_watershed — SEGMENTATION graph op

• Datenarten: image2d → table

• Aufruf: import fullseye as fs; fs.ledger.hierarchical_watershed(image, *, threshold: 'float' = 0.0, n_regions: 'Optional[int]' = None, mask=None, connectivity: 'int' = 4) -> 'Dict[str, object]' (die Implementierung direkt: import seggraph; seggraph.hierarchical_watershed(image, *, threshold: 'float' = 0.0, n_regions: 'Optional[int]' = None, mask=None, connectivity: 'int' = 4) -> 'Dict[str, object]'; aus dem Register: opssegmentation.get("hierarchical_watershed"))

Verwendung

Hierarchische Wasserscheide über Dynamics: versieht die Kanten des minimalen Spannwaldes des Reliefs image (niedrige Stellen sind Becken) mit der Dynamics-Salienz und gibt die über Kanten mit Salienz ≤ threshold verbundenen Komponenten zurück (ist n_regions gegeben, wird die kleinste Schwelle verwendet, die so viele Regionen ergibt) (hierarchical_watershed).

Mit mask nur innerhalb davon (außen 0). Rückgabe: labels (1..k), n_regions, basins (Partition bei Schwellwert 0 = die Becken der Wasserscheide), n_basins, dynamics (je Becken; das tiefste Becken jeder Zusammenhangskomponente ist inf), levels (Höhen, bei denen Becken verschwinden, aufsteigend), threshold (tatsächlich verwendeter Wert). Anzahl der Becken = Anzahl der Becken mit dynamics > Schwellwert (n_expected, von dieser Funktion gezählt und zurückgegeben).

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie halcon_segmentation

Hintergrundwissen (Physik und Konventionen hinter diesem Operator)

• graph_hierarchy_and_thresholds — Segmentierung aus Graph-, Hierarchie- und Schwellwertsätzen — was exakt ist und wo die Zerlegung kippt

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

• poc_graph_hierarchy_segmentation — py -3.11 examples/poc_graph_hierarchy_segmentation.py

Typkompatible Folge-Operatoren (nehmen table als Eingabe)

class_ndim_norm

Gleiche Kategorie (graph)

graph_cut_binary · alpha_expansion · statistical_region_merging · max_tree · area_opening_attr · quasi_flat_zones · alpha_tree · ultrametric_contour_map


*Provenance: seggraph.py — SEGMENTATION Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.