vol_rle_decode — 3D `rle_region` op

• Datenarten: rle_region → voxel

• Aufruf: import fullseye as fs; fs.ledger.vol_rle_decode(region) -> 'np.ndarray' (die Implementierung direkt: import volregion; volregion.vol_rle_decode(region) -> 'np.ndarray'; aus dem Register: ops3d.get("vol_rle_decode"))

Verwendung

Decodiert ein VolRLE zurück in ein dichtes (D, H, W) float64 {0, 1} Volumen.

Exakte Umkehrung von vol_rle_encode (bitidentischer Round Trip). Die region wird zuerst geprüft, daher löst ein beschädigtes RLE ValueError aus, statt außerhalb der Grenzen zu schreiben.

Ablauf: In einem int8-Kumulativpuffer der Form (D*H, W+1) wird am start jedes runs +1 und am end -1 addiert (np.add.at); Positionen, an denen die kumulative Summe entlang x > 0 ist, werden Vordergrund. Auch wenn überlappende runs übergeben werden, heben sie sich bei der Addition nicht auf (count > 0 bedeutet Vordergrund).

Rückgabewert: float64 der Form (D, H, W), nur mit den Werten 0.0 / 1.0. shape wird aus region.shape genommen, daher wird das ursprüngliche Volume nicht benötigt.

Prüfung (ValueError): kein VolRLE / shape nicht der Länge 3, leer oder über MAX_VOXELS / Längen von rows, starts, ends passen nicht zusammen / kein ganzzahliger dtype / row id außerhalb 0..D*H-1 / ein run mit start < 0, end > W oder end <= start. Auch handgemachte oder von außen gelesene RLEs werden vor der Allokation vollständig geprüft.

Einsatz: Nur unmittelbar vor einer Verarbeitung dekodieren, die auf runs nicht möglich ist (Filter, Morphologie, vol_label usw.), und das Ergebnis mit vol_rle_encode zurückwandeln.

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.

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

• rle_region_efficiency — py -3.11 examples_3d/rle_region_efficiency.py

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

voxel_to_mips · voxel_to_mesh · signed_distance_field · to_points · sobel3d · hessian3d · curvature_maps · edt_jfa

Gleiche Kategorie (`rle_region`)

vol_rle_encode · vol_rle_volume · vol_rle_bbox · vol_rle_centroid · vol_rle_union · vol_rle_intersect · vol_rle_difference · vol_rle_components

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

vol_rle_decode — 3D rle_region op