lf_depth_from_focus — LIGHTFIELD depth op

데이터 종류: lightfieldimage2d

호출: import lightfield; lightfield.lf_depth_from_focus(lf, slopes=(-2.0, -1.0, 0.0, 1.0, 2.0), *, window=9, measure='laplacian', subpixel=True, interp='linear', edge='nearest')(또는 opslightfield.get("lf_depth_from_focus"))

사용법

재초점 스윕에서의 첨예도 피크로부터 화소별 기울기를 냅니다.

> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.

Refocus at every slope in *slopes*, measure local sharpness (*measure*:

`laplacian` = summed modified Laplacian, the classical depth-from-focus

operator; `variance = local variance; gradient` = local gradient

energy) in a `window x window` neighbourhood, and take the slope at which

each pixel is sharpest. With `subpixel=True` (default) the peak is refined

by fitting a parabola through the winning sample and its two neighbours on a

uniformly spaced sweep — on a non-uniform sweep the refinement is

skipped rather than applied with the wrong spacing.

Unbiased where :func:lf_epi_slope is not: measured 2026-09-01 on a

5x5x64x64 synthetic field over a 121-point sweep from -3 to +3, the argmax

landed exactly on the true slope in 18 of 18 combinations (true slopes

0.0, +0.5, +1.0, +1.5, +2.0, -1.0 crossed with texture sigma 1.5 / 3.0 /

5.0 px), and the sub-pixel refinement left every one of them unmoved. Its

resolution, though, is whatever you put in *slopes* — it cannot see a plane

you never refocused on.

Returns `(slope_map, sharpness): the (H, W)` map of estimated slopes

(in px per angular step) and the `(H, W)` peak focus-measure value, which

is the honest confidence — a textureless pixel has no sharpness peak, gets

an essentially arbitrary slope, and its `sharpness` is ~0. Threshold on it

rather than trusting the map everywhere.

Raises `ValueError`: *lf* not a valid light field, *slopes* empty /

over :data:MAX_STACK_SLICES / over :data:MAX_STACK_ELEMENTS / containing

a non-finite or over-large value, an even or non-positive *window*, unknown

*measure* / *interp* / *edge*.

자세한 사용 가이드

lightfield_depth 패밀리 가이드

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

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

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

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

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

lightfield_depthpy -3.11 examples/lightfield_depth.py

poc_lightfield_depthpy -3.11 examples/poc_lightfield_depth.py

타입이 이어지는 다음 연산자(image2d 를 입력으로 받는 것)

lf_from_mla · lf_disparity_to_depth · lf_all_in_focus

같은 카테고리(depth)

lf_epi_slope · lf_disparity_to_depth · lf_all_in_focus · lf_plenoptic_design


*Provenance: lightfield.py — LIGHTFIELD 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

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