shape_from_polarization op• Data kinds: normalmap → image2d
• Call: import fullseye as fs; fs.ledger.sfp_height(normals, mask=None, max_zenith_deg=88.0) (implementation को सीधे call करना हो तो import sfpolar; sfpolar.sfp_height(normals, mask=None, max_zenith_deg=88.0), registry से लेना हो तो opsoptics.get("sfp_height"))
mirror-extended क्षेत्र पर Frankot–Chellappa से normal map को height map में integrate करना, ताकि FFT की periodic सीमा परिणाम को न मोड़े (image2d)।
> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।
Gradients p = -nx/nz, q = -ny/nz are formed inside *mask* (zero outside — the object stands on a flat background); slopes steeper than *max_zenith_deg* (the occluding rim, where nz -> 0 and the gradient diverges) are clamped to that zenith with the azimuth kept. The field is then reflected into a 2H x 2W even-symmetric domain (p changes sign under the mirror in x, q under the mirror in y) and handed to photometric.integrate_gradients — the same Frankot-Chellappa solver, without its wrap-around. Measured on a 64 x 80 tilted plane (slopes 0.3 and -0.2): largest height error 0.06 px here against 18 px with the periodic solver, which cannot represent a ramp at all (the residual 0.06 px is the kink of the half-sample mirror at the seam).
Returns (H, W) float64 heights in pixel units (multiply by the pixel pitch), with the background (outside *mask*) at mean 0, or the whole image at mean 0 when there is no mask.
Compared with photometric.integrate_normals (registered in ops3d):
that operator integrates as is (periodic, no validation, no rim clamp); this one validates the field (unit, finite, facing the camera) and fixes the boundary.
Raises ValueError: *normals* not a finite (H, W, 3) field of unit normals with nz >= 0; *mask* not boolean of shape (H, W) or empty; *max_zenith_deg* outside (0, 90).
optics के सभी ops गणना से पहले input की जाँच करते हैं (कुछ भी चुपचाप पास नहीं होता):
• Unit argument के नाम में ही लिखी होती है — _mm / _um / _deg / _mrad। mm और µm की गड़बड़ी crash नहीं करती, बल्कि "सही दिखने वाला पर गलत उत्तर" देती है, इसलिए नाम से इसे रोका जाता है। मान के आकार से unit का अनुमान बिल्कुल नहीं लगाया जाता।
• String से ValueError — float('50') सफल हो जाता है, इसलिए बिना parse किया config value length के रूप में निकल जाता (मापा गया: thin_lens('50', '200') सही दिखने वाला 66.667 mm लौटा रहा था)। bool को भी True == 1 वाले implicit promotion के रूप में अस्वीकार किया जाता है।
• complex / masked array से ValueError (केवल real-valued slots; imaginary part को चुपचाप छोड़ना या mask हटाना अस्वीकार)। हर input पर NaN/Inf से ValueError।
• शून्य से भाग और उससे जुड़े मामलों को नाम लेकर अस्वीकार किया जाता है: focal length 0, radius of curvature 0, refractive index <= 0, पूरी तरह opaque aperture (सब 0, इसलिए normalisation 0/0), ऐसा PSF जिसका योग <= 0 हो, S0 = 0 वाला Stokes vector, और front focal point पर रखा object (image अनंत पर)।
• केवल 2 ops non-finite value लौटाते हैं, और वह भी contract के रूप में लिखा हुआ: depth_of_field hyperfocal distance से आगे far_mm = inf (hyperfocal distance की परिभाषा यही है) और gaussian_beam waist पर wavefront_radius_mm = inf (plane wavefront की radius of curvature)। दोनों साथ में एक finite साथी (far_is_infinite / curvature_per_mm) भी लौटाते हैं। इसके अलावा कोई भी चुपचाप आया NaN/Inf अंदर ही पकड़ा जाता है और ValueError देता है — "float64 overflow हुआ" और "उत्तर अनंत है" अलग-अलग दावे हैं, इसलिए पहले को दूसरे का चेहरा पहनाकर नहीं लौटाया जाता।
• Size की सीमा: generate होने वाले grid के लिए optics.MAX_GRID (4096), दिए गए field/PSF/aperture के लिए optics.MAX_FIELD_ELEMENTS (2^24), ABCD element chain के लिए optics.MAX_SYSTEM_ELEMENTS (1024), Zernike के लिए MAX_ZERNIKE_TERMS (512) / MAX_ZERNIKE_ORDER (40) / MAX_ZERNIKE_BASIS (2^25)। छोटे argument से बहुत बड़ा internal allocation होने वाले रास्तों (मापा गया: n_max=40 × 4096² पर 108 GB) को fail-closed ढंग से बंद किया गया है।
• भौतिक रूप से असंभव states भी अस्वीकार: degree of polarisation > 1 वाला Stokes vector, ऋणात्मक transmittance, ऋणात्मक intensity, और n-|m| odd जैसे अमान्य Zernike indices।
• 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 में दिए गए हैं।
• poc_phase_measuring_deflectometry — py -3.11 examples/poc_phase_measuring_deflectometry.py
• poc_shape_from_polarization — py -3.11 examples/poc_shape_from_polarization.py
image2d को input के रूप में लेते हैं)fraunhofer_pattern · pupil_psf · pupil_blur · psf_to_mtf · edge_spread · veiling_glare_index · emva_pair_statistics · emva_defect_pixels
shape_from_polarization)sfp_dolp_model · dolp_to_zenith · aolp_to_azimuth · sfp_render · sfp_normals · sfp_disambiguate · sfp_estimate_index
*Provenance: sfpolar.py — OPTICS operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.