surface_form_error — 3D `surface_fit` op

• 資料種類:image2d → measurement

• 呼叫: import fullseye as fs; fs.ledger.surface_form_error(height, degree=1)(要直接呼叫實作,import match3d; match3d.surface_form_error(height, degree=1);從台帳取用則 ops3d.get("surface_form_error"))

• 經台帳呼叫的回傳值: fullseye.ledger.surface_form_error(...) 只回傳**宣告的 out 型別 measurement 的值**(底層函式還會回傳輔助資訊)。需要被捨棄的部分時,請用 fullseye.ledger.surface_form_error.raw(...),或直接呼叫 match3d.surface_form_error。

• 底層回傳: (residual, rms, pv) → pv float

用法

高度場 grid → 相對理想曲面(多項式)的殘差=形狀誤差(平面度 deg1/球面度 deg2)。→ (residual, rms, pv)。

> 以下的詳細說明為原文 —— 摘要與標題已翻譯。

`(H,W) の高さ場に x = 列 index、y = 行 index で fit_poly_surface(degree)` を当て、

`residual = height − fit を返す。degree=1 は最小二乗平面(平面度=pv)、degree=2` は

2 次曲面(球面の近似。真の球ではない)。

返り値 `(residual (H,W) float64, rms, pv)`、単位は高さの単位(横方向は画素単位なので傾き

係数は「高さ/画素」)。NaN があると lstsq が失敗する(欠損は先に埋める)。2-D 以外の入力は

形の unpack で失敗する。

用途: 平面度・うねりの評価。`background_flatten` は同じ計算の「画像版」。点群の平面度は

`fit_plane_3d` の resid。

背景知識指南(該運算子背後的物理與規範)

• blas_threads_and_memory — 行列分解が遅い理由の知識 — BLAS スレッド・キャッシュ・メモリ配置

參考(範例資料・文獻)

• 範例資料目錄(下載 URL / 授權) —— 2-D 用 skimage.data(BSD/公有領域)加合成圖,3-D 給出真實資料源(Stanford/PDS 等)的下載 URL。

• 運算子來歷與參考文獻 —— 該運算子族所依據的研究/方法出處。

可執行的範例(實際呼叫該運算子並已驗證的樣例)

• geometry_metrology — py -3.11 examples_3d/geometry_metrology.py

型別可銜接的下一個運算子(可接受 `measurement` 作為輸入)

vol_gaussian_psf · fuse_to_voxel · fresnel_reflectance · snell_angle

同類別(`surface_fit`)

fit_poly_surface · eval_poly_surface · background_flatten

*Provenance: match3d.py — 3D 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

surface_form_error — 3D surface_fit op

用法