tps_fit — 3D 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 は疎な制御点で滑らかな変形を

表現するのが本来の使い方)。

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

• nonrigid_deform — py -3.11 examples_3d/nonrigid_deform.py

타입이 이어지는 다음 연산자(deformation 를 입력으로 받는 것)

fuse_to_voxel · tps_warp

같은 카테고리(deform)

tps_warp · register_nonrigid · register_cpd_rigid

*Provenance: deform3d.py — 3D 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

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