mirror_plane_from_pairs — SHAPESTAT `symmetry` op

• 数据种类:points → matrix

• 调用: import fullseye as fs; fs.ledger.mirror_plane_from_pairs(landmarks, pairs=None, midline=None)(要直接调用实现,import shapestats; shapestats.mirror_plane_from_pairs(landmarks, pairs=None, midline=None);从台账取用则 opsshapestat.get("mirror_plane_from_pairs"))

用法

由左右对应的标志点求出正中面。→ (2, 3)(第 1 行 = 点，第 2 行 = 法线)。

左右点对 (i, j) 的中点全都位于正中面上。因此只需对该中点集合拟合平面即可 —— 要点在于平面的确定与变形量无关，它与使残差最小的平面(symmetry3d.detect_reflection_symmetry)是不同的东西。

★ 2026-09-06 的实测:加入 6.4 mm 的单侧变形后，残差最优平面偏离真实正中面 2.92 mm / 1.72 度，抹掉了 46 % 的不对称量(增益 0.54)。用这个特征点平面则增益为 1.03。要找平面用残差最优平面，要说量用这个。

*midline* 是位于正中线上(不成对)的特征点的下标。给出时会加入中点集合，使平面拟合更稳定。

pairs=None 是前半与后半配对的约定(i 与 i + N//2)。形态测量中普遍采用先排列全部左侧特征点、再按相同顺序排列右侧的保存格式，本约定与之相符。点数为奇数时拒绝 —— 若把无法对半分的排列悄悄截断，点对会逐个错开 1 位，所有的符号都会颠倒。

详细使用指南

• shape_statistics 族使用指南

参考(示例数据、文献)

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

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

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

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

• shapestat_landmark_tour — py -3.11 examples/shapestat_landmark_tour.py

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

—

同类别(`symmetry`)

landmark_asymmetry

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

mirror_plane_from_pairs — SHAPESTAT symmetry op

用法