robust_gaussian_surface — ROUGHNESS prepare op

• Data kinds: depth → depth

• Call: import fullseye as fs; fs.ledger.robust_gaussian_surface(z, dx, lambda_c, c=4.4, order=1, robust=True, truncate=1.0, dy=None, max_iter=None, tol=1e-06) (to call the implementation directly, import roughness; roughness.robust_gaussian_surface(z, dx, lambda_c, c=4.4, order=1, robust=True, truncate=1.0, dy=None, max_iter=None, tol=1e-06); from the registry, opsroughness.get("robust_gaussian_surface"))

• Return value through the ledger: fullseye.ledger.robust_gaussian_surface(...) returns only the declared out type depth (the underlying function also returns auxiliary values). When you need what was dropped, use fullseye.ledger.robust_gaussian_surface.raw(...) or call roughness.robust_gaussian_surface directly.

• Underlying return: (roughness, mean_surface, info)

Usage

Robust Gaussian regression filter (surface): waviness and roughness of a surface that scratches and spikes cannot drag.

> The detailed description below is the original text — the summary and the headings are translated.

robust_gaussian_profile の 2 次元版(核は x・y に可分、局所面 c + p u + q v の回帰、biweight は面全体の残差の中央値で作る)。重みが非可分でも、必要なのは重み画像と u^a v^b を掛けた核との可分相関だけなので、 O(N · 窓幅) で済む。

戻り値は (roughness, mean_surface, info)。端は削らず全面を返す。引数・fail-closed は断面版と同じ(dy=None は正方画素、z は 8x8 以上の 2 次元)。

Detailed usage guide

• surface_roughness family guide

References (sample data, literature)

• Sample-data catalog (download URLs / licences) — 2-D uses skimage.data (BSD/public domain) plus synthetic images; 3-D lists download URLs for real data sources (Stanford, PDS, …).

• Operator provenance and references — the sources of the research/methods this op family came from.

• The canonical algorithm (author, year) and its uses are named in the family usage guide above.

Runnable examples (verified samples that actually call this op)

• poc_robust_profile_filter — py -3.11 examples/poc_robust_profile_filter.py

Ops the type connects to (they accept depth as input)

surface_form_remove · surface_filter · surface_params · surface_psd

Same category (prepare)

surface_form_remove · surface_filter · robust_gaussian_profile · robust_spline_profile


*Provenance: roughness.py — ROUGHNESS operator registry. This per-op note is generated by tools/opdocs.py md (do not hand-edit).*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.