itof op• Data kinds: कोई नहीं → table (केवल arguments से तय होने वाला op — यह कोई image या data input नहीं लेता)
• Call: import fullseye as fs; fs.ledger.itof_unwrap_error_rate(frequencies_hz=(80000000.0, 100000000.0, 120000000.0), phase_sigma_rad=0.05, max_range_m=None) (implementation को सीधे call करना हो तो import itof; itof.itof_unwrap_error_rate(frequencies_hz=(80000000.0, 100000000.0, 120000000.0), phase_sigma_rad=0.05, max_range_m=None), registry से लेना हो तो opsoptics.get("itof_unwrap_error_rate"))
multi-frequency unwrapping (maximum-likelihood decoding) के गलत wrap order चुनने की संभावना का अनुमान। table लौटाता है।
> नीचे का विस्तृत विवरण मूल text में है — सारांश और headings का अनुवाद हो चुका है।
周波数を共通の基本周波数の整数倍 f_i = n_i f_g と書くと、非曖昧距離は U = c / (2 f_g)、周期は p_i = U / n_i。折り返さない位相を並べたベクトルは距離 v に比例する直線 v·g(g_i = 2π/p_i)の上にあり、折り返しはこれを 2π m(m は整数のベクトル)だけずらした平行な直線の族を作る。最尤の復号(itof_unwrap_multifreq の "ml")が誤るのは、測った位相が別の直線 v·g + 2πm の方に近いとき。位相雑音 σ_i で割った空間での 2 本の直線の距離を D_m とすると、その 2 仮説の誤りは Q(D_m / 2)(ガウス)。
• union_bound = Σ_m Q(D_m/2)(範囲内で出会う m すべての和。上界)、nearest_term = max_m Q(D_m/2)。
• Wang–Xia(2007)の保証: 周期を p_i = Γ M_i と書く(Γ = U / lcm(n_i))。全周波数の剰余の誤差が Γ/4 未満なら次数は決して誤らない(最も長い周期を錨にする residue_crt の保証)。guaranteed_phase_rad = 各周波数でその境界に当たる位相の誤差 2π (Γ/4) / p_i —— 低い周波数ほど小さい。
*phase_sigma_rad* はスカラ(全周波数で同じ)か周波数ごと。*max_range_m* は探す範囲(既定 U)。
返す dict: unambiguous_range、periods、integers(n_i)、gamma、guaranteed_phase_rad、union_bound、nearest_term、min_distance(最小の D_m)、offsets(m の配列、(M, F))、distances。
Raises ValueError: 周波数が 2 個未満・通約できない・比が細かすぎる / σ が正でない・形が合わない / max_range_m が U より広い。
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_itof_multifreq — py -3.11 examples/poc_itof_multifreq.py
table को input के रूप में लेते हैं)abcd_matrix · wavefront_stats · sfr_from_edge · paraxial_trace · seidel_coefficients · spot_stats · tolerance_analysis · wavefront_from_opd
itof)itof_capture · itof_phase_amplitude · itof_noise_budget · itof_unwrap_multifreq · itof_multipath_separate · itof_flying_pixel_mask · itof_wiggling_correct
*Provenance: itof.py — OPTICS operator registry. यह per-op note tools/opdocs.py md से अपने-आप generate होता है (हाथ से edit न करें)।*
© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.