lf_from_mla — LIGHTFIELD decode op

데이터 종류: image2dlightfield

호출: 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.

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

자세한 사용 가이드

lightfield_depth 패밀리 가이드

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

lightfield_depthpy -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 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

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