light_section op• Data kinds: कोई नहीं → table (केवल arguments से तय होने वाला op — यह कोई image या data input नहीं लेता)
• Call: import fullseye as fs; fs.ledger.light_section_uncertainty_budget(wavelength_um=0.65, sin_u_obs=0.1, sin_theta=0.5, line_width_um=40.0, pixel_um=1.0, length_um=None, n_patterns=1, polarizations=1, noise_rel=0.0, peak_dn=None, window_rows=160, calib_rms_um=0.0, calib_dof=inf, speckle_contrast=None) (implementation को सीधे call करना हो तो import lightsection; lightsection.light_section_uncertainty_budget(wavelength_um=0.65, sin_u_obs=0.1, sin_theta=0.5, line_width_um=40.0, pixel_um=1.0, length_um=None, n_patterns=1, polarizations=1, noise_rel=0.0, peak_dn=None, window_rows=160, calib_rms_um=0.0, calib_dof=inf, speckle_contrast=None), registry से लेना हो तो opsoptics.get("light_section_uncertainty_budget"))
• GPU: नहीं (केवल CPU reference implementation)
light-section height का uncertainty budget GUM table के रूप में (table)।
> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।
成分(行)/ components:
• speckle: u = C λ / (2π sin u_obs) · √(w/L) [µm、観察面の横ずれ]、感度 1/sin θ。
• read_noise: 列全体の重心に加法の白色雑音(頂に対する比 noise_rel、peak_dn を与えれば量子化 1/12 LSB² も)が入れる分散を線形化した閉形式 Σ (y − y0)² / (Σ I)² · σ²、L / pixel 列の平均で割る。単位は µm、感度 1/sin θ。
• calibration: 光面の校正の残差 calib_rms_um、感度 1、自由度 calib_dof。
列は source / u / sensitivity / dof / delta_z_um(= |c|·u)で、spc.gum_propagate / spc.gum_expanded にそのまま渡せる(相関なしを仮定)。combined_u_z_um(二乗和の平方根)と dominant(最大の成分)も返す。
★The read-noise term is the linearised variance of the whole-column centroid (the estimator
of laser_line_center_centroid with half_window=None over window_rows rows); other estimators have other noise gains. speckle_contrast overrides the contrast (default 1/√(n_patterns · polarizations), fully developed speckle; 0 = a smooth surface). The √(w/L) speckle averaging is a measured rule (see coherent), not part of Dorsch's closed form.
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। घोषित अपवाद: bottle_fit_from_pattern का u_map न मापे जा सके पिक्सेल को NaN के रूप में लेता है (अनंत अब भी अस्वीकार)।
• शून्य से भाग और उससे जुड़े मामलों को नाम लेकर अस्वीकार किया जाता है: 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 हुआ" और "उत्तर अनंत है" अलग-अलग दावे हैं, इसलिए पहले को दूसरे का चेहरा पहनाकर नहीं लौटाया जाता। घोषित अपवाद: bottle_background_map जिन पिक्सेल की किरण अनुपयोगी है (पूर्ण आंतरिक परावर्तन आदि) उनके लिए u_mm में NaN लौटाता है, साथ में valid मास्क और गिनती भी।
• 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_light_section_step_weld_floor — py -3.11 examples/poc_light_section_step_weld_floor.py
table को input के रूप में लेते हैं)abcd_matrix · wavefront_stats · sfr_from_edge · paraxial_trace · seidel_coefficients · spot_stats · tolerance_analysis · wavefront_from_opd
light_section)laser_line_center_centroid · laser_line_center_gauss · laser_line_center_steger · light_section_rig · light_section_targets · light_section_render · light_plane_calibrate · light_section_profile
*Provenance: lightsection.py — OPTICS operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.