lf_from_mla — LIGHTFIELD decode op

• 資料種類:image2d → lightfield

• 呼叫: import fullseye as fs; fs.ledger.lf_from_mla(raw, angular=(5, 5), *, offset=(0, 0), crop=False)(要直接呼叫實作,import lightfield; lightfield.lf_from_mla(raw, angular=(5, 5), *, offset=(0, 0), crop=False);從台帳取用則 opslightfield.get("lf_from_mla"))

用法

把微透鏡陣列的原始影格解碼成 (V, U, H, W) 光場。

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

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.

詳細使用指南

• lightfield_depth 族使用指南

參考(範例資料、文獻)

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

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

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

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

• lightfield_depth — py -3.11 examples/lightfield_depth.py

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

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

同類別(decode)

lf_to_mla · lf_stats


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

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