fullseye

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) の中点は、どれも正中面の上に乗る。だからその中点集合に平面を当てればよい —— 変形の量に依らず面が決まるのが要点で、残差を最小にする面(:func: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 ファミリガイド

参考(サンプルデータ・文献)

サンプルデータカタログ(DL URL / ライセンス) — 2-D は skimage.data(BSD/public)+ 合成、3-D は実データ源(Stanford/PDS 等)の DL URL。
演算子の来歴・参考文献 — この op 族の元になった研究/手法の出典。
アルゴリズムの正典(著者・年)と用途は上記ファミリ使い方ガイドに記載。

実行できる例(この op を実際に呼ぶ検証済みサンプル)

shapestat_landmark_tour — py -3.11 examples/shapestat_landmark_tour.py

型が繋がる次の op(`matrix` を入力に取れる)

—

同カテゴリ(`symmetry`)

landmark_asymmetry

Provenance: shapestats.py — SHAPESTAT operator registry. この per-op ノートは tools/opdocs.py md が自動生成(手編集しない)。

This site is open source. Improve this page.