normalize — SHAPE2D descriptor op

• 数据种类:efdmodel → matrix

• 调用: import fullseye as fs; fs.ledger.normalize(model, size_invariant=True)(要直接调用实现,import fourierdesc; fourierdesc.normalize(model, size_invariant=True);从台账取用则 opsshape2d.get("normalize"))

用法

将 EFD 系数变换为“规范姿态”的系数(以第 1 谐波为基准对齐)。

Kuhl–Giardina 的正则化: (1) 用第1谐波的相位消除起点的任意性,(2) 把第1 椭圆的长轴转到基准轴以统一朝向,(3) 除以第1谐波的长轴长以统一大小。适用于把多个形状叠加/求平均等「正则姿态重建」。

注意(honest): 第1谐波几乎为圆形(长轴≈短轴)的形状,相位 (theta/psi) 病态而不稳定。不变匹配请不要用本函数,而用 invariants / descriptor_distance(基于奇异值)。

详细使用指南

• shape_description_2d 族使用指南

参考(示例数据、文献)

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

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

• 算法的正典(作者、年份)与用途见上面的族使用指南。

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

• piv_flow_from_particles — py -3.11 examples/piv_flow_from_particles.py

• poc_exoplanet_transit — py -3.11 examples/poc_exoplanet_transit.py

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

contour_epicycle_chain · contour_fourier_truncation_energy

同类别(descriptor)

elliptic_fourier · reconstruct · invariants · descriptor_distance · fourier_smooth · from_xld · contour_fourier_complex · contour_epicycle_chain


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

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