lf_from_mla — LIGHTFIELD `decode` op

• Datenarten: image2d → lightfield

• Aufruf: import lightfield; lightfield.lf_from_mla(raw, angular=(5, 5), *, offset=(0, 0), crop=False) (oder opslightfield.get("lf_from_mla"))

Verwendung

Decodiert ein Mikrolinsen-Array-Rohbild in ein `(V, U, H, W)`-Lichtfeld.

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

The plenoptic sensor stores, for microlens `(t, s), a V x U` block of

pixels — one per direction through the main lens' exit pupil. So raw pixel

`(offset_y + t*V + v, offset_x + s*U + u) is exactly L[v, u, t, s]`:

the decode is a pure re-sort, no interpolation, no data invented.

:func:lf_to_mla inverts it bit-exactly.

*offset* is the integer position of the first whole microlens; a real MLA is

never aligned to pixel `(0, 0)`. Sub-pixel MLA calibration is out of scope

(see the module docstring) — this operator works on an already-rectified

frame.

By default a raw frame whose usable size is not a whole multiple of the

microlens pitch is a `ValueError`, because the alternative — quietly

dropping the last partial row of microlenses — shifts every subsequent

microlens centre and produces a light field that looks right and is wrong.

Pass `crop=True` to opt in to that crop explicitly.

Raises `ValueError`: *raw* not 2-D or non-finite, *angular* outside

`[1, MAX_ANGULAR]`, a negative *offset*, an *offset* that leaves fewer

than one whole microlens, a size that is not a multiple of the pitch (unless

`crop=True), a decoded sub-aperture image over :data:MAX_SPATIAL` on a

side, and a decoded size over :data:MAX_LF_ELEMENTS.

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_depth — py -3.11 examples/lightfield_depth.py

Typkompatible Folge-Operatoren (nehmen `lightfield` als Eingabe)

lf_to_mla · lf_stats · lf_subaperture · lf_center_view · lf_views · lf_epi · lf_refocus · lf_focal_stack

Gleiche Kategorie (`decode`)

lf_to_mla · lf_stats

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

lf_from_mla — LIGHTFIELD decode op