alpha_shape_boundary — 3D reconstruct op

• 数据种类:points → indices

• 调用: import fullseye as fs; fs.ledger.alpha_shape_boundary(points, alpha)(要直接调用实现,import recon3d; recon3d.alpha_shape_boundary(points, alpha);从台账取用则 ops3d.get("alpha_shape_boundary"))

用法

用 alpha shapes 给出边界点索引(点群 → 边界点)。

收集 Delaunay 四面体剖分中外接球半径 < 1/alpha 的四面体的表面三角形(边界面),将其顶点集合作为边界点。适用于从实心(表面 + 内部)点云中只提取表面壳的点。alpha 越大,允许的半径 1/alpha 越小,边界越贴合(能捕捉细节)。

Parameters

points : array_like (N,3)

alpha : float

正实数。半径阈值为 1/alpha。可用 estimate_alpha 获得参考值。

Returns

boundary_point_indices : numpy.ndarray (K,) int64

边界点在 points 中的 index(升序、无重复)。没有边界时为空数组。

背景知识指南(该算子背后的物理与约定)

• blender_interop — 与 Blender 配合使用 —— 在 Blender 中建形、用 fullseye 测量(坐标轴、单位、真值数据的陷阱)

参考(示例数据、文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。

• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。

可运行的示例(实际调用该算子并已验证的样例)

• sfm_recon — py -3.11 examples_3d/sfm_recon.py

类型可衔接的下一个算子(可接受 indices 作为输入)

fuse_to_voxel

同类别(reconstruct)

poisson_lite · alpha_shape_mesh · estimate_alpha


*Provenance: recon3d.py — 3D 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.