cylinder_unwrap — 3D curvilinear op

• 数据种类:voxel → voxel

• 调用: import fullseye as fs; fs.ledger.cylinder_unwrap(vol, center=None, r_in=0.0, r_out=None, ntheta=180, nr=32, device='cpu')(要直接调用实现,import match3d; match3d.cylinder_unwrap(vol, center=None, r_in=0.0, r_out=None, ntheta=180, nr=32, device='cpu');从台账取用则 ops3d.get("cylinder_unwrap"))

• GPU:无(仅 CPU 参考实现)

用法

把体素的圆柱面展开为 (height×θ×r)(圆柱零件/管道的内外壁检测)。轴 = z(D 轴)。

θ轴是一个没有端点的周期性网格（与polar_unwrap相同，修改于2026-08-30）。

引发 ValueError：如果输入有 NaN/Inf/float32 溢出。

参数：vol 是(D,H,W)，center=(cy, cx) 是 (row, column) （默认为切片中心）。 r_in ~ r_out （体素，默认 min(H,W)/2 − 1）被分成 nr 等份，角度为 ntheta 等份。输出(D, ntheta, nr) float32：轴0是z（高度，与输入相同），第k行的角度 θ = k·2π/ntheta，柱 j 的半径。采样点为(z, cy + r sinθ, cx + r cosθ)，体积外为0。D、H、W为1的轴也作为像素坐标进行插值，不会发生被0除的情况。

第二部分：如果取[:,:,j]，半径为j的圆柱面就变成(D×θ)的二维图像，二维探伤/ 可以使用ncc_locate。

空输入（带有 0 个元素的“vol”）会导致 ValueError。

参考(示例数据、文献)

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

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

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

• curvilinear_proj — py -3.11 examples_3d/curvilinear_proj.py

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

voxel_to_mips · voxel_to_mesh · signed_distance_field · to_points · sobel3d · hessian3d · curvature_maps · edt_jfa

同类别(curvilinear)

polar_unwrap · fit_zernike

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

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