lf_aperture_mask — LIGHTFIELD refocus op

• Data kinds: कोई नहीं → image2d (केवल arguments से तय होने वाला op — यह कोई image या data input नहीं लेता)

• Call: import fullseye as fs; fs.ledger.lf_aperture_mask(angular=(5, 5), shape='circle', *, radius=None, inner=0.0, sigma=None, normalize=True) (implementation को सीधे call करना हो तो import lightfield; lightfield.lf_aperture_mask(angular=(5, 5), shape='circle', *, radius=None, inner=0.0, sigma=None, normalize=True), registry से लेना हो तो opslightfield.get("lf_aperture_mask"))

उपयोग

angular weighting mask — वह synthetic aperture जिसे आप छोटा करते हैं या आकार देते हैं।

> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।

Returns a (V, U) 2-D array of per-view weights, indexed the same way as the light field's angular axes, for lf_synthetic_aperture. The radius is measured in angular steps from the centre ((V-1)/2, (U-1)/2), so radius=0 selects the single centre view (an infinitely small aperture: everything in focus, no light) and the default radius = max(V-1, U-1)/2 is the largest circle that fits.

• circle — hard-edged disc, the physical iris.

• square — Chebyshev disc; separable, the cheapest to reason about.

• gaussian — apodised pupil (sigma in angular steps, default radius/2); no ringing in the defocus PSF.

• annulus — ring between *inner* and *radius*; a coded aperture whose defocus PSF has more high-frequency content, which is what makes depth-from-defocus work better.

With normalize=True (default) the weights sum to exactly 1, so a masked reduction is a weighted mean and its result is directly comparable with lf_refocus. Set it to False to keep 0/1 selection weights.

Raises ValueError: an angular shape outside [1, MAX_ANGULAR], a negative *radius* / *inner* / *sigma*, inner >= radius, an unknown *shape*, and — explicitly rather than returning a field of zeros — a mask that selects no view at all (an opaque aperture), which would make every downstream weighted mean a 0/0.

उपयोग की विस्तृत guide

• lightfield_depth family guide

संदर्भ (sample data, साहित्य)

• Sample data catalog (DL URL / license) — 2-D के लिए skimage.data (BSD/public) + synthetic, 3-D के लिए real data sources (Stanford/PDS आदि) के DL URL।

• Operators का स्रोत और संदर्भ — इस op family के मूल research/methods के स्रोत।

• Algorithm का मानक स्रोत (लेखक, वर्ष) और उपयोग ऊपर की family usage guide में दिए गए हैं।

चलाए जा सकने वाले उदाहरण (verified samples जो सच में यह op call करते हैं)

• lightfield_depth — py -3.11 examples/lightfield_depth.py

• poc_compound_eye — py -3.11 examples/poc_compound_eye.py

वे अगले ops जिनसे type जुड़ता है (image2d को input के रूप में लेते हैं)

lf_from_mla · lf_disparity_to_depth · lf_all_in_focus

इसी category के (refocus)

lf_refocus · lf_focal_stack · lf_synthetic_aperture


*Provenance: lightfield.py — LIGHTFIELD operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*

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