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

用法