vol_region_props — 3D regionprops op

Datenarten: labelstable

Aufruf: import fullseye as fs; fs.ledger.vol_region_props(labels, spacing=None, surface='auto') (die Implementierung direkt: import volops; volops.vol_region_props(labels, spacing=None, surface='auto'); aus dem Register: ops3d.get("vol_region_props"))

Verwendung

Quantitative Deskriptoren je Komponente aus einem Labelvolumen.

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

*labels* is the `int volume returned by :func:vol_label` (or any integer

labelling; voxels `<= 0 are background). Pass *spacing* (sz, sy, sx)` (or

a :class:volio.VolumeMeta) to report physical volume in mm**3 and physical

surface area in mm**2. *surface* selects the surface-area estimator:

`"auto" (marching cubes when scikit-image` is importable, else exposed

faces), `"marching" (require marching cubes), or "faces"` (always the

face count).

Returns a `list[dict] (one per label 1..n`, in ascending label order),

each with:

`label id · voxel_count · volume` (voxels, or mm**3 with spacing) ·

`centroid (z, y, x) in voxel-index coordinates · bbox`

`(z0, z1, y0, y1, x0, x1) with **exclusive** upper bounds (slice stop`) ·

`surface_area (voxel-face units, or mm**2 with spacing) · sphericity`

(Wadell, ~1 for a sphere, lower for a slab; approximate — see module note).

Hintergrundwissen (Physik und Konventionen hinter diesem Operator)

measurement_uncertainty — 計測の不確かさと校正の知識 — 「測れている」を主張するために

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)

vessel_metrologypy -3.11 examples_3d/vessel_metrology.py

Typkompatible Folge-Operatoren (nehmen table als Eingabe)

fuse_to_voxel · mesh_select_lod

Gleiche Kategorie (regionprops)

label_components · region_props · largest_component · filter_by_volume · inner_box3 · vol_label


*Provenance: volops.py — 3D 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.