blob_region — BLOB `extract` op

• Datenarten: labels2d → mask

• Aufruf: import fullseye as fs; fs.ledger.blob_region(labels: 'Any', index: 'int') -> 'np.ndarray' (die Implementierung direkt: import blob2d; blob2d.blob_region(labels: 'Any', index: 'int') -> 'np.ndarray'; aus dem Register: opsblob.get("blob_region"))

Verwendung

Extrahiert 1 Objekt als Binärregion (bool). index ist 1-basiert.

Ein Auswahl-op, das nur labels == index zurückgibt. Die Nummern sind die von blob_label vergebenen fortlaufenden 1..n, 0 ist der Hintergrund.

• labels: 2-D-Integer-Labelbild (Ausgabe von blob_label / blob_select / blob_split). bool-Masken werden abgewiesen (um den Unfall "mehrere Objekte als 1 messen" zu verhindern, wird dazu aufgefordert, zuerst blob_label anzuwenden). Auch float wird abgewiesen (es lässt sich nicht entscheiden, welches Objekt 0.999 ist). Negative Nummern ergeben ValueError.

• index: ein int mit 1 <= index <= labels.max(). 0 (Hintergrund) oder außerhalb des Bereichs ergibt ValueError. Dasselbe Nummernsystem wie die Spalte label von blob_features und das Ergebnis von blob_select_largest (ab 1 neu nummeriert).

• Rückgabewert: bool der Form (H, W). Es ist nie leer (die Nummer existiert immer -- hat jedoch ein selbst erstelltes Labelbild, das nicht mit blob_select neu nummeriert wurde, Lücken, kann komplett False zurückkommen).

Die extrahierte Region lässt sich direkt an blob_distance (Distanztransformation), an die Überlagerung von blob_overlay oder an die Konturzeichnung von annotate_outline übergeben.

Ausführlicher Anwendungsleitfaden

• Leitfaden zur Familie blob_analysis

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_gear_tooth_metrology — py -3.11 examples/poc_gear_tooth_metrology.py

• poc_particle_sizing — py -3.11 examples/poc_particle_sizing.py

Typkompatible Folge-Operatoren (nehmen `mask` als Eingabe)

blob_label · blob_distance

Gleiche Kategorie (`extract`)

blob_boundaries · blob_overlay

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

blob_region — BLOB extract op