warp_tps_image — SHAPE2D morph op

• Data kinds: image2d × pairs × pairs → image2d

• Call: import fullseye as fs; fs.ledger.warp_tps_image(img, src_pts, dst_pts, lam=0.0, order=1) (to call the implementation directly, import imagemorph; imagemorph.warp_tps_image(img, src_pts, dst_pts, lam=0.0, order=1); from the registry, opsshape2d.get("warp_tps_image"))

Usage

Smooth warp that moves src_pts of img to dst_pts using a thin-plate spline.

Fits the inverse-mapping TPS from output coordinates → input coordinates (dst→src), evaluates it on the whole output grid, and samples. With lam=0 it corresponds exactly at the control points (features land correctly); lam>0 smooths the deformation. Smoother than piecewise affine, but at the cost of evaluating the kernel for all pixels × control points.

Arguments and return value are the same as warp_piecewise_affine.

Detailed usage guide

• shape_description_2d family guide

References (sample data, literature)

• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).

• Operator provenance and references — the sources of the research/methods this op family came from.

• The canonical algorithm (author, year) and its uses are named in the family usage guide above.

Runnable examples (verified samples that actually call this op)

• shape2d_morph_descriptor_tour — py -3.11 examples/shape2d_morph_descriptor_tour.py

Ops the type connects to (they accept image2d as input)

warp_piecewise_affine · blend · morph · morph_sequence

Same category (morph)

add_frame_corners · warp_piecewise_affine · blend · morph · morph_sequence


*Provenance: imagemorph.py — SHAPE2D operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

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