deform op• 数据种类:points × points → deformation
• 调用: import fullseye as fs; fs.ledger.tps_fit(src_ctrl, dst_ctrl, lam=0.0)(要直接调用实现,import deform3d; deform3d.tps_fit(src_ctrl, dst_ctrl, lam=0.0);从台账取用则 ops3d.get("tps_fit"))
由控制点对应拟合 3D Thin-Plate-Spline。
> 以下的详细说明为原文 —— 摘要与标题已翻译。
移動側の制御点 `src_ctrl を固定側 dst_ctrl` へ写す TPS 係数を、鞍点系
を最小二乗(`numpy.linalg.lstsq`)で解いて求める。λ=0 なら制御点上で厳密に
内挿(`tps_warp(model, src_ctrl) == dst_ctrl`)、λ>0 で平滑化する。
引数:
src_ctrl: (K,3) 制御点(変形の始点、TPS のカーネル中心 p_i)。
dst_ctrl: (K,3) 対応する目標点(変形の終点 v_i)。
lam: 正則化係数 λ≥0。カーネル行列 K の対角へ λ を加える。大きいほど
変形は滑らか(制御点への当てはめは緩む)。
返り値:
model: dict。キーは
"ctrl" (K,3) カーネル中心 p_i、
"w" (K,3) 非線形(曲げ)係数、
"a" (4,3) アフィン係数([平行移動; 線形部]、a[0]=c, a[1:4]=Aᵀ)、
"lam" 使用した λ。
例外:
ValueError: 形状不一致、制御点数不足、非有限値、または制御点数が
`TPS_MAX_CTRL`(10,000)超(密な (K+4)² 系は O(K³) のため。
対応点を間引いてから渡す — TPS は疎な制御点で滑らかな変形を
表現するのが本来の使い方)。
• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。
• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。
• nonrigid_deform — py -3.11 examples_3d/nonrigid_deform.py
deformation 作为输入)deform)tps_warp · register_nonrigid · register_cpd_rigid
*Provenance: deform3d.py — 3D 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.