voxel_to_mesh — 3D `transform` op

• Datenarten: voxel → mesh

• Aufruf: import fullseye as fs; fs.ledger.voxel_to_mesh(vol, iso=0.5) (die Implementierung direkt: import match3d; match3d.voxel_to_mesh(vol, iso=0.5); aus dem Register: ops3d.get("voxel_to_mesh"))

• Rückgabewert über das Register: fullseye.ledger.voxel_to_mesh(...) liefert **nur den Wert des deklarierten Out-Typs mesh** (die zugrunde liegende Funktion gibt zusätzlich Hilfsinformationen zurück). Wird das Verworfene gebraucht, nutze fullseye.ledger.voxel_to_mesh.raw(...) oder rufe match3d.voxel_to_mesh direkt auf.

Verwendung

Voxel → Mesh (Marching Cubes, skimage). Liefert (verts, faces, normals). Die Voxel-→-Mesh-Umwandlung.

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

`skimage.measure.marching_cubes(vol, level=iso)` の薄い包み(spacing 指定なし = 1 voxel

単位)。`verts (V,3) float は **voxel index 座標**で、列は入力の軸順(vol` が (D,H,W)

なら (z,y,x))。`faces (F,3) int は verts への index、normals` (V,3) は skimage が

勾配から与える頂点法線。4 番目の返り値(values)は捨てる。

• `iso`: 等値面のレベル。入力の値域の外だと skimage が ValueError を出す(全 0 の

volume で iso=0.5 など)。個数密度なら 0.5、SDF なら 0.0 を渡す。

• 境界に接する等値面は開いたまま(端で閉じない)。

• ★巻き順は内向き。そのまま `mesh_volume` に渡すと**普通の中身のある形でも

負**になる(実測: 1000 voxel の立方体で -985.67)。体積が欲しいだけなら

`abs()、向きを揃えたいなら faces[:, ::-1]` で巻き直す。

• skimage は呼び出し時 import(未導入なら ImportError)。

後段: `mesh_to_points で点群化、mesh_area / face_areas / mesh_volume` /

`boundary_vertices / mesh_edge_stats` で計測。

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)

• mesh_smooth — py -3.11 examples_3d/mesh_smooth.py

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

mesh_to_voxel · mesh_to_points · to_points · fuse_to_voxel · ambient_occlusion · cast_shadow · supersample_mesh · render_beauty

Gleiche Kategorie (`transform`)

points_to_voxel · gaussians_to_voxel · mesh_to_voxel · mesh_to_points · depth_to_points · voxel_to_mips · tsdf_from_depth · signed_distance_field

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

voxel_to_mesh — 3D transform op