vol_labels_to_meshes — VOLCOLOR `render` op

• Datenarten: labels → table

• Aufruf: import volcolor; volcolor.vol_labels_to_meshes(labels, ids=None, spacing=None, seed: 'int' = 0, level: 'float' = 0.5, axes: 'str' = 'xyz') (oder opsvolcolor.get("vol_labels_to_meshes"))

Verwendung

Führt Marching Cubes pro Komponente aus und liefert eine Menge eingefärbter Meshes.

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

返りは `list[dict]、各要素が `{"label", "vertices" (nv, 3) float64,

"faces" (nf, 3) int64, "color" (r, g, b)}``。色は

:func:vol_colorize_labels と同じパレットなので、**断面図と 3-D 表示で同じ

部品が同じ色**になる。

成分ごとに bbox を 1 ボクセル分パディングした部分体だけを切り出して

marching cubes を回す(全ボリュームを成分数だけ舐めない)。パディングは

ボリューム端に接する成分の面を閉じるためで、これをしないと端の成分だけ

穴の開いたメッシュになる。

`axes`:

• `"xyz"(既定)―― 頂点を (x, y, z) で返す。:mod:render3d` /

:mod:mesh の頂点順がこれで、`render3d.render_mesh` へ直接渡せる。

• `"zyx" ―― ボリュームの添字順のまま返す。:func:vol_label_shape_stats`

の `centroid` と同じ並びになる。

黙って取り違えると例外は出ない ―― 出るのは上下と前後が入れ替わった、

それらしい絵である。`tests/test_volcolor.py::test_mesh_axes_order_is_explicit` が

両方の重心を stats の重心と突き合わせて固定している。

*spacing* を渡すと頂点は物理座標(mm)になる。*ids* で成分を絞れる

(`None なら実在する全ラベル、ただし :data:MAX_MESHES` 件まで)。

Raises `ImportError (with the pip install scikit-image` message) when

marching cubes is unavailable, and `ValueError` for a bad *axes*, a *level*

outside `(0, 1)`, an *ids* naming an absent label, or more than

:data:MAX_MESHES components.

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)

• voxel_labels_color — py -3.11 examples/voxel_labels_color.py

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

—

Gleiche Kategorie (`render`)

vol_label_volume_render

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

vol_labels_to_meshes — VOLCOLOR render op