illumination op• Data kinds: table → table
• Call: import fullseye as fs; fs.ledger.defect_contrast(light, surface='satin', slopes_deg=(2.0, 5.0, 10.0, 20.0), camera=(0.0, 0.0, 300.0), point=(0.0, 0.0), n_azimuth=12, pigment_albedo_ratio=0.5) (implementation को सीधे call करना हो तो import illumdesign; illumdesign.defect_contrast(light, surface='satin', slopes_deg=(2.0, 5.0, 10.0, 20.0), camera=(0.0, 0.0, 300.0), point=(0.0, 0.0), n_azimuth=12, pigment_albedo_ratio=0.5), registry से लेना हो तो opsoptics.get("defect_contrast"))
किसी light के तहत topographic और pigment defects का contrast (table)।
> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।
For each facet slope in *slopes_deg* the radiance toward *camera* of a facet tilted by that slope (azimuth swept in *n_azimuth* steps) is compared with the flat surface at *point*: contrast = (L_defect − L_flat) / (L_defect + L_flat) (Michelson, −1..1; the sign says whether the flank appears brighter or darker than the surround). Reported per slope as mean, max_abs and azimuth_of_max. pigment is the contrast of a flat patch whose albedo is *pigment_albedo_ratio* × the surround — the number specular glare dilutes. scatter is the contrast of a rough patch (a chipped edge, a pit floor, a fine scratch: micro-facets of every slope, modelled as Lambertian with reflectance F + (1 − F)ρ, the Fresnel fraction the flat surface would have sent into its specular direction now scattered) against the surround — the defect class dark-field lighting is built for, since a smooth facet only lights up when it mirrors the source into the camera while a rough patch scatters some of *any* light there, and at grazing incidence that Fresnel fraction is large. regime is "bright_field" when the flat surface returns specular light to the camera (specular ≥ diffuse radiance) and "dark_field" otherwise. *surface*: a preset (matte, satin, glossy, mirror, brushed_metal) or a dict {albedo, roughness, f0}.
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।
• mv_illumination_practice — Lighting व्यवहार में — wavelength, polarisation, drive modes, ambient light, safety
• 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 में दिए गए हैं।
• illumination_design_demo — py -3.11 examples/illumination_design_demo.py
table को input के रूप में लेते हैं)abcd_matrix · wavefront_stats · sfr_from_edge · paraxial_trace · seidel_coefficients · spot_stats · tolerance_analysis · wavefront_from_opd
illumination)light_source · irradiance_map · illumination_uniformity · lighting_sweep · illumination_design
*Provenance: illumdesign.py — OPTICS operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.