lf_disparity_to_depth — LIGHTFIELD depth op

Datenarten: image2ddepth

Aufruf: import lightfield; lightfield.lf_disparity_to_depth(slope, focal_px=1000.0, baseline=1.0, *, far_depth=None, min_slope=1e-06) (oder opslightfield.get("lf_disparity_to_depth"))

Verwendung

Steigung (Pixel pro Winkelschritt) -> metrische Tiefe, das Kamera-Array-Modell.

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

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`.

Ausführlicher Anwendungsleitfaden

Leitfaden zur Familie lightfield_depth

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

• Der kanonische Algorithmus (Autor, Jahr) und seine Anwendungen stehen im Familienleitfaden oben.

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

lightfield_depthpy -3.11 examples/lightfield_depth.py

Typkompatible Folge-Operatoren (nehmen depth als Eingabe)

Gleiche Kategorie (depth)

lf_depth_from_focus · lf_epi_slope · lf_all_in_focus · lf_plenoptic_design


*Provenance: lightfield.py — LIGHTFIELD Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

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