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

用法