illumination op• Data kinds: कोई नहीं → table (केवल arguments से तय होने वाला op — यह कोई image या data input नहीं लेता)
• Call: import fullseye as fs; fs.ledger.illumination_design(surface='glossy', defect='topographic', slope_deg=10.0, part_size_mm=50.0, camera_height_mm=300.0) (implementation को सीधे call करना हो तो import illumdesign; illumdesign.illumination_design(surface='glossy', defect='topographic', slope_deg=10.0, part_size_mm=50.0, camera_height_mm=300.0), registry से लेना हो तो opsoptics.get("illumination_design"))
surface / defect जोड़ी के लिए मानक light families को rank करता है (table)।
> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।
Candidates: low-angle ring (dark field, elevation 20°), high-angle ring (bright field, 70°), the elevation that lighting_sweep finds best, dome, coaxial and (for defect="edge") backlight. Each is scored by the simulated Michelson contrast of the stated defect — topographic: a smooth facet of *slope_deg* (a dent wall, a bump); scatter: a rough patch (chipped edge, pit, fine scratch); pigment: an albedo patch at half the surround; edge: a silhouette — multiplied by the uniformity of the background radiance the camera sees across the part (min/max over the centre and the four edge midpoints). That second factor is what separates a robust choice from a fragile one: coaxial light on a glossy part gives a huge negative contrast exactly on axis (the glare) and almost none a few millimetres away, so its background uniformity is poor and it ranks below a dark field whose background is uniformly dark. Irradiance uniformity is reported too. The result lists the candidates best first with their numbers, the recommended family, and rule_of_thumb — the textbook choice (a smooth facet → coaxial bright field on a glossy finish, else the ring elevation that mirrors it into the camera; scatter → dark field; pigment → dome; edge → backlight) so a disagreement between simulation and rule is visible rather than hidden. Two things the numbers say that folklore does
not: a *smooth* 10° facet does not light up in dark field (it mirrors the low light away from the camera) — the "dark field shows scratches" rule is about their rough flanks, the scatter class here; and for that class a large coaxial (bright-field) source often scores *higher* than dark field because the rough patch appears dark on a uniform glare with contrast near 1 (the wafer / glass inspection practice). The model does not score sensor saturation or the glare's dependence on part flatness, which is why the dark-field rule survives on the shop floor; the table shows both so the choice is made with the numbers.
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
• poc_solder_fillet_aoi — py -3.11 examples/poc_solder_fillet_aoi.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 · defect_contrast · lighting_sweep
*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.