cavity op• Data kinds: कोई नहीं → table (केवल arguments से तय होने वाला op — यह कोई image या data input नहीं लेता)
• Call: import fullseye as fs; fs.ledger.michelson_dc_readout(power_w: 'float' = 1.0, arm_length_m: 'float' = 1.0, wavelength_nm: 'float' = 1064.0, *, dc_offset_rad: 'float' = 0.1, strain: 'float' = 0.0) -> 'dict' (implementation को सीधे call करना हो तो import cavityoptics; cavityoptics.michelson_dc_readout(power_w: 'float' = 1.0, arm_length_m: 'float' = 1.0, wavelength_nm: 'float' = 1064.0, *, dc_offset_rad: 'float' = 0.1, strain: 'float' = 0.0) -> 'dict', registry से लेना हो तो opsoptics.get("michelson_dc_readout"))
dark fringe से φ₀ हटाए Michelson का antisymmetric-port power, strain sensitivity और shot-noise limit।
> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।
power_w : float
ビームスプリッタに入る光量 P_in [W]。
arm_length_m : float
腕の長さ L [m] (単純 Michelson。共振器の利得は cavity_strain_transfer で別に掛ける)。
wavelength_nm : float
波長 [nm]。
dc_offset_rad : float
暗縞からのオフセット位相 φ₀ [rad] (0 < φ₀ < π)。
strain : float
ひずみ h(腕の差 ΔL = hL)。
dict
p_out_w = P_in sin²((φ₀ + 4πhL/λ)/2)、slope_w_per_strain = dP/dh
= P_in sin(φ₀ + 4πhL/λ)·2πL/λ、shot_noise_w_per_rthz = √(2ħω P_out)、
h_shot_per_rthz = 散射雑音/傾き、h_shot_limit_per_rthz = φ₀ → 0 の極限
(1/2L)√(ħcλ/πP_in)、phase_total_rad。
散射雑音限界は小さなオフセットで h_shot = (1/2L)√(ħcλ/πP_in)/cos(φ_total/2)、φ → 0 で極限値に収束する(オフセットを下げるほど光量は減るが感度の比は変わらない —— DC 読み出しが成り立つ理由)。tests は傾きを有限差分で独立に求めて突き合わせる。
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_gw_detector_pseudo_simulation — py -3.11 examples/poc_gw_detector_pseudo_simulation.py
table को input के रूप में लेते हैं)abcd_matrix · wavefront_stats · sfr_from_edge · paraxial_trace · seidel_coefficients · spot_stats · tolerance_analysis · wavefront_from_opd
cavity)fabry_perot_response · cavity_strain_transfer · pdh_error_signal · quantum_noise_budget
*Provenance: cavityoptics.py — OPTICS operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.