mirror_plane_from_pairs — SHAPESTAT `symmetry` op

• 데이터 종류: points → matrix

• 호출: 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 つずつずれて全部の

符号が入れ替わる。

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.

• (아직 없음)

—

*Provenance: shapestats.py — SHAPESTAT 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

mirror_plane_from_pairs — SHAPESTAT symmetry op