lf_from_mla — LIGHTFIELD decode op

• Data kinds: image2d → lightfield

• Call: import fullseye as fs; fs.ledger.lf_from_mla(raw, angular=(5, 5), *, offset=(0, 0), crop=False) (implementation को सीधे call करना हो तो import lightfield; lightfield.lf_from_mla(raw, angular=(5, 5), *, offset=(0, 0), crop=False), registry से लेना हो तो opslightfield.get("lf_from_mla"))

उपयोग

microlens-array raw frame को (V, U, H, W) light field में decode करता है।

> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।

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. 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 MAX_SPATIAL on a side, and a decoded size over MAX_LF_ELEMENTS.

उपयोग की विस्तृत guide

• lightfield_depth family guide

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• lightfield_depth — py -3.11 examples/lightfield_depth.py

वे अगले ops जिनसे type जुड़ता है (lightfield को input के रूप में लेते हैं)

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

इसी category के (decode)

lf_to_mla · lf_stats


*Provenance: lightfield.py — LIGHTFIELD operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

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