polarization opimage2d → polsweepimport fullseye as fs; fs.ledger.polarization_demosaic(raw, layout=((90.0, 45.0), (135.0, 0.0))) (実装を直接呼ぶなら import optics; optics.polarization_demosaic(raw, layout=((90.0, 45.0), (135.0, 0.0)))、台帳から引くなら opsoptics.get("polarization_demosaic"))Split a polarisation-sensor mosaic into the four analyser images.
A polarisation camera puts four micro-polarisers on each 2x2 block of
pixels; the raw frame is one (H, W) array in which neighbouring pixels saw
the scene through different analysers. This returns a (4, H, W) array
of images [I_0, I_45, I_90, I_135] (the polsweep sort, in
:data:POLARIZATION_SWEEP_ANGLES order, so the result feeds
:func:specularity.polarization_stokes and polarization_dolp_map
directly), each interpolated to full resolution.
Interpolation is bilinear, the same estimate a Bayer demosaic makes for
a colour plane that occupies one pixel in four: a missing pixel is the mean
of its measured 4-neighbours (edge-adjacent) or 4-neighbours (diagonal),
which is exactly the [[1, 2, 1], [2, 4, 2], [1, 2, 1]] / 4 kernel applied
to the masked plane. Ground truth: on a plane that is linear in x and y
the interpolation is exact (a bilinear estimate of an affine field is the
field), so the test plants four affine fields, mosaics them, and demands
every returned image equal its field to 1e-12 away from the border. The
border is handled by mirroring the mosaic two pixels outward before
interpolating (an even, non-duplicating reflection keeps the 2x2 phase), so
a uniform field is exact up to the edge and a gradient is mirrored there —
a symmetric bias on the outermost row and column, and said so. Against
Polanalyser’s OpenCV bilinear path the interior agrees to the 16-bit
quantisation (1.8e-5) and only the outer two pixels differ (2026-09-18).
layout is the angle at each 2x2 position, ((a00, a01), (a10, a11)) in
degrees; the default is the Sony IMX250MZR block. Every angle in
:data:POLARIZATION_SWEEP_ANGLES must appear exactly once.
Raises ValueError: raw is not a 2-D array, has an odd height or
width (the block would be cut), contains non-finite values, or layout is
not a permutation of the four sweep angles.
Provenance: the layout convention and the “four Bayer planes” reading of
the mosaic follow Polanalyser (Maeda, MIT); the interpolation is the
classic bilinear Bayer demosaic. This is a re-implementation from that
description, not copied code, and it does not depend on OpenCV. Colour
polarisation sensors (IMX250MYR, a 4x4 block) are handled by
:func:polarization_demosaic_color.
optics の全 op は入力を検証してから計算する(黙って通さない):
_mm / _um / _deg / _mrad。mm と µm の取り違えは crash ではなく「もっともらしく間違った答え」なので、名前で防ぐ。大きさから単位を推測する処理は一切しない。ValueError — float('50') は成功してしまうため、未パースの設定値が長さとして通り抜ける(実測: thin_lens('50', '200') がもっともらしい 66.667 mm を返していた)。bool も True == 1 の暗黙昇格として拒否。ValueError(実数枠のみ。虚部の無言切り捨て・マスク剥がしを拒否)。NaN/Inf は全入力で ValueError。depth_of_field の過焦点距離以遠の far_mm = inf(それが過焦点距離の定義)と gaussian_beam のウエストでの wavefront_radius_mm = inf(平面波面の曲率半径)。どちらも有限の相棒(far_is_infinite / curvature_per_mm)を併せて返す。それ以外の無言 NaN/Inf は内部で検出して ValueError —「float64 が溢れた」と「答えが無限大」は別の主張なので、後者の顔で前者を返さない。optics.MAX_GRID(4096)、供給された場/PSF/開口は optics.MAX_FIELD_ELEMENTS(2^24)、ABCD 素子列は optics.MAX_SYSTEM_ELEMENTS(1024)、Zernike は MAX_ZERNIKE_TERMS(512)/ MAX_ZERNIKE_ORDER(40)/ MAX_ZERNIKE_BASIS(2^25)。小さな引数から巨大な内部確保が起きる経路(実測: n_max=40 × 4096² で 108 GB)を fail-closed で塞ぐ。| 物理的に不可能な状態も拒否: 偏光度 > 1 の Stokes ベクトル、負の透過率、負の強度、n- | m | が奇数などの不正な Zernike 添字。 |
py -3.11 examples/poc_shape_from_polarization.pypy -3.11 examples/polarization_camera_pipeline.pypolsweep を入力に取れる)polarization)jones_element · jones_apply · stokes_from_jones · mueller_element · mueller_apply · stokes_analyze · polarization_demosaic_color · mueller_from_intensities
Provenance: optics.py — OPTICS operator registry. この per-op ノートは tools/opdocs.py md が自動生成(手編集しない)。
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.