ultrametric_contour_map — SEGMENTATION graph op

• Datenarten: image2d → table

• Aufruf: import fullseye as fs; fs.ledger.ultrametric_contour_map(image, *, mask=None, connectivity: 'int' = 4, distance_matrix: 'bool' = False) -> 'Dict[str, object]' (die Implementierung direkt: import seggraph; seggraph.ultrametric_contour_map(image, *, mask=None, connectivity: 'int' = 4, distance_matrix: 'bool' = False) -> 'Dict[str, object]'; aus dem Register: opssegmentation.get("ultrametric_contour_map"))

Verwendung

Ultrametrische Konturkarte (UCM) der Dynamics-Hierarchie: der Wert zwischen benachbarten Pixeln p, q = die kleinste Schwelle, bei der p und q in dieselbe Region fallen (ultrametric_contour_map).

Kanten innerhalb eines Beckens sind 0; Kanten an der Grenze zwischen Becken erhalten die Höhe, bei der sich die 2 Becken in einem 2. Kruskal (Verschmelzen des Beckenbaums in aufsteigender saliency) treffen.

Rückgabe: ucm_h (H, W − 1: Pixel und sein rechter Nachbar), ucm_v (H − 1, W: Pixel und der darunter), ucm (je Pixel das größere von rechts und unten = Rand durch das linke obere Pixel vertreten, wie segeval), basins, levels, distance (bei distance_matrix=True und höchstens 2500 Becken die Matrix der ultrametrischen Abstände aller Beckenpaare). Komponenten nach Schneiden der Kanten mit ucm > θ bei Schwellwert θ = hierarchical_watershed(θ).

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 · hierarchical_watershed


*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.