carve — 3D space_carving op

• Datenarten: images → voxel

• Aufruf: import fullseye as fs; fs.ledger.carve(silhouettes: 'Sequence[np.ndarray]', Ks: 'Sequence[np.ndarray]', Rs: 'Sequence[np.ndarray]', ts: 'Sequence[np.ndarray]', bounds: 'Bounds', res: 'int') -> 'np.ndarray' (die Implementierung direkt: import visualhull; visualhull.carve(silhouettes: 'Sequence[np.ndarray]', Ks: 'Sequence[np.ndarray]', Rs: 'Sequence[np.ndarray]', ts: 'Sequence[np.ndarray]', bounds: 'Bounds', res: 'int') -> 'np.ndarray'; aus dem Register: ops3d.get("carve"))

Verwendung

Diskretisiert bounds in res^3 Voxel und behält jene, die in jede Silhouette projizieren (Space Carving).

Projiziert jedes Voxelzentrum mit X_cam = R_m X + t_m in alle Kameras m und behält nur die Voxel, die depth>0, innerhalb des Bildes und Vordergrund in silhouettes[m] allesamt erfüllen (Schnitt der Sichtkegel). Silhouetten/Kameras sind Listen der Länge M.

Parameters

silhouettes : list of (H, W) bool array Vordergrundmaske jeder Kamera (M Stück).

Ks, Rs, ts : list intrinsische Parameter, Rotation und Translation jeder Kamera (je M Stück).

bounds : ((xmin,xmax),(ymin,ymax),(zmin,zmax)) zu schnitzender Quaderbereich.

res : int Anzahl der Voxelunterteilungen pro Achse (Voxel insgesamt = res^3).

Returns

(res, res, res) bool ndarray belegte Voxel. Mit indexing='ij' sind die Achsen (x, y, z).

Das Zentrum von vox[i,j,k] ist (xmin+(i+.5)dx, ymin+(j+.5)dy, zmin+(k+.5)dz).

Hintergrundwissen (Physik und Konventionen hinter diesem Operator)

• blender_interop — Zusammen mit Blender — Form bauen, mit fullseye messen (Fallstricke: Achsen, Einheiten, Referenzdaten)

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)

• space_carving — py -3.11 examples_3d/space_carving.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 (space_carving)

visual_hull · synthesize_silhouette · carve_look_at


*Provenance: visualhull.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.