membrane_recover — DRIVE tacsim op

• 資料種類:rgb × matrix × scalar → table

• 呼叫: import fullseye as fs; fs.ledger.membrane_recover(rgb, lights, pitch: 'float', ambient: 'float' = 0.0, albedo: 'float' = 1.0) -> 'dict'(要直接呼叫實作,import tacsim; tacsim.membrane_recover(rgb, lights, pitch: 'float', ambient: 'float' = 0.0, albedo: 'float' = 1.0) -> 'dict';從台帳取用則 opsdrive.get("membrane_recover"))

用法

視觸覺 RGB (H, W, 3) → 將 3 個通道視為 3 個光源下的影像，以 photometric.photometric_stereo(lit_only)求法線 → 以 photometric.integrate_normals(Frankot-Chellappa)求高度(像素單位 × pitch = m)。

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

ambient・albedo は較正値: 像から albedo·ambient を引いてから解く(合成 albedo·(N·L + ambient) の ambient 項を Woodham の線形模型は持たないので、引かないと法線が z 側へ寄り、傾きが ambient/sin(仰角) ≈ 3.7 %(0.03/0.82)系統的に小さく出る —— 実機の参照フレーム較正に当たる。試作で δ が 3.5 % 低かった原因)。

返り: normals(H, W, 3)、albedo(H, W)、height(H, W)[m、平均 0 の相対値]、pitch。Raises ValueError: rgb が (H, W, 3) でない、pitch ≤ 0、ambient < 0。

參考(範例資料、文獻)

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

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

• 演算法的正典(作者、年份)與用途見上面的族使用指南。

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

• poc_peg_insertion_tactile — py -3.11 examples/poc_peg_insertion_tactile.py

• poc_tacsim_elastic_membrane — py -3.11 examples/poc_tacsim_elastic_membrane.py

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

course_layout · course_occupancy · course_contains · world_build · world_camera · world_move · lidar_scan · rss_longitudinal_same

同類別(tacsim)

combined_modulus · hertz_sphere · hertz_force · hertz_cylinder · hertz_surface_uz · hertz_pressure · membrane_indent_sphere · membrane_indent_shape

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

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