lf_depth_from_focus — LIGHTFIELD `depth` op

• 資料種類:lightfield → image2d

• 呼叫: import fullseye as fs; fs.ledger.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')(要直接呼叫實作,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"))

• 經台帳呼叫的回傳值: fullseye.ledger.lf_depth_from_focus(...) 只回傳**宣告的 out 型別 image2d 的值**(底層函式還會回傳輔助資訊)。需要被捨棄的部分時,請用 fullseye.ledger.lf_depth_from_focus.raw(...),或直接呼叫 lightfield.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 族使用指南

參考(範例資料・文獻)

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

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

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

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

• lightfield_depth — py -3.11 examples/lightfield_depth.py

• poc_compound_eye — py -3.11 examples/poc_compound_eye.py

• poc_lightfield_depth — py -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 運算子登記表。本條目由 tools/opdocs.py md 自動產生(請勿手動編輯)。*

lf_depth_from_focus — LIGHTFIELD depth op

用法