tb_lf_synthetic_aperture — 2D typed op

Datenarten: lightfieldimage

Aufruf: fullseye.apply(img, "tb_lf_synthetic_aperture", a=0.5, b=0.5) (das 2-D-Modell ist ein Bild plus zwei skalare Regler a,b∈[0,1])

tb_lf_synthetic_aperture: input → output

*Die Abbildung ist die tatsächliche Ausgabe auf einer synthetischen 128×128-Eingabe. Links Eingabe, rechts Ausgabe. Punktwolken als Draufsicht-Streudiagramm (Helligkeit = z), 1-D-Reihen als Linie, Volumen als Maximum-Projektion entlang z, Videos als mittleres Bild, komplexe Bilder als Betrag; Rückgabewerte, die kein Bild ergeben, werden als Werte gezeigt.*

*Regler a ändert die Ausgabe nicht (gemessen: identisch bei 0,1 / 0,5 / 0,9).*

*Regler b ändert die Ausgabe nicht (gemessen: identisch bei 0,1 / 0,5 / 0,9).*

Stufen (die vorangehenden Ops → dieser Op, von links nach rechts):

tb_lf_synthetic_aperture: stages (docs site)

Auf anderen Bildern (synthetische Szene / Foto / Münzen. Obere Reihe: Eingaben, untere Reihe: deren Ausgaben. Regler auf Standard):

tb_lf_synthetic_aperture: other inputs (docs site)

Verwendung

Refokussierung durch eine geformte Blende — und mit `reduce="median"` auch durch Verdeckungen (Occluder) hindurch.

> Die ausführliche Beschreibung unten ist der Originaltext — Zusammenfassung und Überschriften sind übersetzt.

Same shift-and-add geometry as :func:lf_refocus, with two additions:

• *mask* — a `(V, U) weight array from :func:lf_aperture_mask` (or your

own). A small mask is a stopped-down aperture: less defocus blur, less

light. `None` weights every view equally.

• *reduce* — how the aligned views are combined. `mean` is the classical

(and linear) synthetic aperture. `median` is the interesting one: when

a foreground occluder covers a *minority* of the views at a pixel, the

median rejects it and the background behind it is reconstructed —

looking through a fence, or through a rack of parts. `max / min`

are the order-statistic extremes, useful for specular / shadow work.

`median, max and min` use the mask only to *select* views

(weight > 0), because an order statistic has no meaningful weighting;

that is stated here rather than silently ignoring the weights.

The see-through result is not a metaphor. When fewer than half the views

are blocked at a hidden pixel, more than half of them carry the identical

background sample and the median is that sample exactly. Measured

2026-09-01 on a 9x9x64x64 field with an occluder covering 25% of the centre

view at slope 3.0 (blocking at most 46% of the views at any hidden pixel):

RMS against the true, hidden background was 0.0 for `median` and

0.159 for `mean`, with the centre view itself at 0.280. Push the coverage

to 35% (up to 60% of views blocked) and the guarantee is gone — the median

lands at 0.133, worse than nothing.

Returns a `(H, W)` 2-D image.

Raises `ValueError`: *lf* not a valid light field, a *mask* whose

shape is not `(V, U)` or which is non-finite / negative / selects no view,

a non-finite or over-large *slope*, unknown *reduce* / *interp* / *edge*.

Typed bridge of the lightfield op `lf_synthetic_aperture into the 2-D evolution registry: the same implementation, called under the op(v, a, b) convention. This op has no tunable parameter; a and b` are unused.

Referenzen (Beispieldaten, Literatur)

• Katalog der Beispieldaten (Download-URLs / Lizenzen) — 2-D nutzt skimage.data (BSD/Public Domain) plus synthetische Bilder, 3-D nennt Download-URLs echter Datenquellen (Stanford, PDS, …).

• Herkunft und Literatur der Operatoren — die Quellen der Forschung/Verfahren, auf denen diese Operatorfamilie beruht.

In Studio ausprobieren

Das Programm unten ist nachweislich lauffähig (gleiche Eingabe wie die Abbildung). In der Studio-Hilfe wird dieser Block zu Schaltflächen, die es sofort laden und ausführen.

img_to_lightfield 0.50 0.50
tb_lf_synthetic_aperture 0.50 0.50

▸ Load this pipeline  ·  Load & run

Ausführbare Beispiele (verifizierte Samples, die diesen Operator wirklich aufrufen)

Die folgenden Beispiele rufen den zugrunde liegenden Ledger-Op lf_synthetic_aperture auf. Dieser Brücken-Op ist dieselbe Implementierung, angepasst an die Konvention fn(v, a, b); das Verhalten gilt unverändert (nur die Aufrufform unterscheidet sich).

lightfield_depthpy -3.11 examples/lightfield_depth.py

poc_compound_eyepy -3.11 examples/poc_compound_eye.py

Typkompatible Folge-Operatoren (nehmen image als Eingabe)

identity · gaussian · mean_box · bilateral · unsharp · median · min_filter · max_filter

Gleiche Kategorie (typed)

tb_points_to_voxel · tb_estimate_point_normals · tb_iss_keypoints · tb_project_points · tb_render_point_depth · tb_statistical_outlier_removal · tb_radius_outlier_removal · tb_voxel_grid_downsample


*Provenance: ops.py — 2D Operator-Registry. Diese Notiz wird von tools/opdocs.py md erzeugt (nicht von Hand bearbeiten).*

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