lf_depth_from_focus — LIGHTFIELD `depth` op

• 数据种类:lightfield → image2d

• 调用: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 族使用指南

参考(示例数据・文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。

• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。

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

可运行的示例(实际调用该算子并已验证的样例)

• lightfield_depth — py -3.11 examples/lightfield_depth.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

用法