sensorgeneral op• Data kinds: signal × signal → table
• Call: import fullseye as fs; fs.ledger.emva_general_relative_qe(mu_p_ref, mu_y_ref, mu_y_dark, mu_y_scan, mu_p_scan, ref_index, n_intervals=8) (implementation को सीधे call करना हो तो import sensorgeneral; sensorgeneral.emva_general_relative_qe(mu_p_ref, mu_y_ref, mu_y_dark, mu_y_scan, mu_p_scan, ref_index, n_intervals=8), registry से लेना हो तो opsoptics.get("emva_general_relative_qe"))
संदर्भ तरंगदैर्ध्य के सापेक्ष quantum efficiency η(λ)/η(λ_ref) (General खंड 9.4, समीकरण 73, 74)।
> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।
基準波長で測った特性曲線の逆の関係 μ_p = R⁻¹(μ_y − μ_y.dark)を 3 次 B-スプラインで当て(式 73)、波長を振った測定の灰色値 μ_y(λ) を基準波長の光子数に換算する(線形化)。η(λ)/η(λ_ref) = [R⁻¹(μ_y(λ) − μ_y.dark)/μ_p(λ)] / [R⁻¹(μ_y(λ_ref) − μ_y.dark)/μ_p(λ_ref)]。★式 (74) は μ_p(λ)/μ_p(λ_ref) を掛けると印刷されている —— 線形の極限で Linear の式 (82) に戻らないので割る形を使う(モジュールの説明を参照)。印刷どおりの値は eq74_as_printed。
*mu_p_ref*, *mu_y_ref*: 基準波長の露光段と灰色値。*mu_y_scan*, *mu_p_scan*: 波長を振った測定の灰色値と光子数。*ref_index*: 走査の中で基準波長の位置。
返り値 {"eta_rel", "p_equivalent", "eq74_as_printed", "n_intervals"}。
Raises ValueError: 長さが違う / μ_p が正でない走査点 / ref_index が範囲外 / 走査の灰色値が基準の特性曲線の範囲の外(外挿しない)/ B-スプラインの拒否。
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_emva1288_in_camera_processing — py -3.11 examples/poc_emva1288_in_camera_processing.py
table को input के रूप में लेते हैं)abcd_matrix · wavefront_stats · sfr_from_edge · paraxial_trace · seidel_coefficients · spot_stats · tolerance_analysis · wavefront_from_opd
sensorgeneral)emva_general_sensitivity · emva_general_nonuniformity
*Provenance: sensorgeneral.py — OPTICS operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.