fullseye

lf_disparity_to_depth — LIGHTFIELD depth op

• データ種: image2d → depth
• 呼び出し: import fullseye as fs; fs.ledger.lf_disparity_to_depth(slope, focal_px=1000.0, baseline=1.0, *, far_depth=None, min_slope=1e-06) (実装を直接呼ぶなら import lightfield; lightfield.lf_disparity_to_depth(slope, focal_px=1000.0, baseline=1.0, *, far_depth=None, min_slope=1e-06)、台帳から引くなら opslightfield.get("lf_disparity_to_depth"))

使い方

Slope (px per angular step) -> metric depth, the camera-array model.

For a rectified array of viewpoints spaced baseline apart with focal length focal_px expressed in pixels of the sub-aperture image, a point at distance Z shifts by |s| = focal_px * baseline / Z pixels per step. Inverting: Z = focal_px * baseline / |s|, returned in whatever length unit baseline was given in (mm in, mm out).

Only |s| enters, deliberately. The sign of the slope says which side of the focal plane a point is on, and which sign means “nearer” depends on how the angular axis was oriented when the field was decoded — a convention this module cannot know and refuses to guess. If your decode puts near objects at negative slope, negate before calling.

far_depth is the fail-closed switch for the s -> 0 pole (a point at infinity has zero parallax). None (default) makes any |s| < min_slope a ValueError naming how many pixels were affected — mask them, or pass an explicit saturation distance as far_depth and get that value there. There is no silent inf and no silent clamp.

Accepts a scalar or any array; returns the same shape (a scalar in gives a 0-d array out, so downstream code has one type to handle).

Raises ValueError: non-finite slope / focal_px / baseline, a non-positive focal_px / baseline / min_slope, a negative far_depth, and |slope| < min_slope anywhere when far_depth is None.

詳しい使い方ガイド

• lightfield_depth ファミリ ガイド

参考(サンプルデータ・文献)

• サンプルデータ カタログ(DL URL / ライセンス) — 2-D は skimage.data(BSD/public)+ 合成、3-D は実データ源(Stanford/PDS 等)の DL URL。
• 演算子の来歴・参考文献 — この op 族の元になった研究/手法の出典。
• アルゴリズムの正典(著者・年)と用途は上記ファミリ使い方ガイドに記載。

実行できる例(この op を実際に呼ぶ検証済みサンプル)

• lightfield_depth — py -3.11 examples/lightfield_depth.py
• poc_lightfield_depth — py -3.11 examples/poc_lightfield_depth.py

型が繋がる次の op(depth を入力に取れる)

—

同カテゴリ(depth)

lf_depth_from_focus · lf_epi_slope · lf_all_in_focus · lf_plenoptic_design

---

Provenance: lightfield.py — LIGHTFIELD operator registry. この per-op ノートは tools/opdocs.py md が自動生成(手編集しない)。

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

This site is open source. Improve this page.